Comment fonctionne OpenClaw

OpenClaw n'est pas un chatbot ordinaire, mais un secrétaire personnel vivant dans votre ordinateur. Il peut recevoir des commandes via des applications de messagerie telles que WeChat, WhatsApp et Telegram, vous aider à envoyer des e-mails, consulter des calendriers, ouvrir des navigateurs, exécuter des commandes, et même travailler automatiquement 24 heures sur 24 !

Concepts fondamentaux

Qu'est-ce qu'OpenClaw exactement ?

OpenClaw est unassistant IA entièrement open source qui s'exécute sur votre propre ordinateur(anciennement appelé Clawdbot, puis renommé).
Il ne se contente pas de discuter comme ChatGPT ; il passe réellement à l'action :

• Vous dites dans WhatsApp : « Vérifie le vol de demain pour moi », et il peut automatiquement ouvrir un navigateur, se connecter au site web de la compagnie aérienne et vous envoyer une capture d'écran.
• Il prend en charge des centaines de compétences, et la communauté continue d'en ajouter.
• Il dispose d'une mémoire à long terme (se souvient de ce que vous aimez) et peut même générer de nouvelles compétences tout seul.
• Plus important encore :Toutes les données restent sur votre ordinateur, ne sont pas envoyées dans le cloud, sans danger pour la vie privée。

Idée centrale :Connecter le grand modèle d'IA (cerveau) + les outils locaux (mains et pieds) + un logiciel de chat (bouche et oreilles), pour que l'IA devienne véritablement votre majordome informatique.

Architecture globale : Gateway est le centre de commande du cerveau

La partie la plus essentielle d'OpenClaw s'appelleGateway (passerelle). C'est comme le panneau de contrôle central de votre maison ; tout tourne autour de lui.

Explication simple de chaque partie :

• Channel Bridge (pont de canal): Responsable du « handshaking » avec les logiciels de chat comme WhatsApp et Telegram. Par exemple, en utilisant la bibliothèque Baileys pour se connecter à WhatsApp.
• Gateway: Le seul processus en cours d'exécution (occupe un port, par défaut 18789), comme un standardiste, qui transmet les messages à l'IA.
• Cerveau IA: Ce qui pense réellement, c'est le grand modèle externe (vous fournissez la clé API) ; Gateway n'est responsable que de « l'appeler pour le faire travailler ».
• Outils et compétences: Les mains et les pieds de l'IA, par exemple ouvrir un navigateur, lire/écrire des fichiers, envoyer des e-mails.
• Système de mémoire: Comme un carnet, l'IA n'oubliera pas ce que vous avez dit la dernière fois.

Comment un message devient-il une action ?

Prenons un exemple concret : « Dans WhatsApp, dites : aide-moi à organiser les e-mails d'aujourd'hui en un résumé et envoie-le-moi. »

Le diagramme de flux est le suivant :

Décomposition détaillée :

1. Réception de l'instruction: Vous envoyez un message → le Bridge du logiciel de chat pousse le message vers Gateway.
2. Recherche en mémoire: Gateway ouvre votre « profil personnel » (Session + Memory), sachant que vous êtes un utilisateur récurrent et quel ton vous avez aimé la dernière fois.
3. Réflexion de l'IA: Regrouper le message + la mémoire et les envoyer au cerveau de l'IA. L'IA agit comme un secrétaire intelligent : « D'accord, je dois d'abord lire l'e-mail, puis le résumer. »
4. Appel d'outil: L'IA dit « Je veux utiliser la compétence Gmail. » Le Gateway l'exécute dans un bac à sable sécurisé (pour empêcher l'IA de modifier des fichiers au hasard).
5. Exécution + retour: L'outil donne le résultat à l'IA, et l'IA rédige un résumé.
6. Réponse à l'utilisateur: Le Gateway renvoie le résumé vers WhatsApp. Et vous le recevez !

Architecture globale

Conception d'architecture à trois niveaux

OpenClaw adopte une architecture classique à trois couches. Comprenons-la couche par couche, de l'extérieur vers l'intérieur :

Pourquoi cette conception ?

Analogie: Imaginez une grande entreprise

• Couche externe (interface utilisateur)= Les clients peuvent contacter l'entreprise par téléphone, e-mail, WeChat et d'autres canaux
• Couche intermédiaire (Gateway)= Réception d'accueil, qui traite uniformément tous les clients et les oriente vers les services appropriés
• Couche interne (Workspace)= Différents services métier, chacun responsable de tâches différentes
• Couche inférieure (couche de capacités)= Les ressources de l'entreprise (conseillers experts, outils et équipements, etc.)

Explication détaillée des composants principaux

Gateway : portail unifié

Qu'est-ce que Gateway ?

Gateway est la porte d'entrée d'OpenClaw. Tous les messages externes doivent d'abord passer par ici.

Les trois principales responsabilités de Gateway :

1. Authentification

Assurez-vous que seules les plateformes que vous autorisez peuvent se connecter

2. Routage

Envoyer les messages au bon espace de travail

3. Journalisation

Enregistrer toutes les interactions pour faciliter le débogage et l'audit

Commande pour démarrer le Gateway :

# 启动网关，监听 18789 端口
openclaw gateway --port 18789 --verbose

Espace de travail : votre bureau privé

Qu'est-ce qu'un espace de travail ?

Un espace de travail est l'endroit où les tâches sont réellement traitées. Vous pouvez avoir plusieurs espaces de travail, chacun responsable de choses différentes.

Exemple de configuration typique d'un espace de travail :

# workspace-personal.yaml
name: "个人助理"
llm:
  provider: "anthropic"  # 使用 Claude
  model: "claude-sonnet-4"
  apiKey: "sk-ant-xxx"

skills:
  - weather        # 查天气
  - calendar       # 管理日程
  - email          # 处理邮件
  - web-search     # 网页搜索

settings:
  language: "zh-CN"
  temperature: 0.7
  max_tokens: 4000

Scénarios d'utilisation de plusieurs espaces de travail :

LLM : le cerveau de l'IA

Qu'est-ce que LLM ?

LLM (grand modèle de langage) est le cerveau intelligent d'OpenClaw, chargé de comprendre votre intention et de générer des réponses.

LLM pris en charge par OpenClaw :

Canaux : Connexion au monde extérieur

Que sont les canaux ?

Les canaux sont des « adaptateurs » qui connectent diverses plateformes de messagerie.

Le rôle de chaque canal :

1. Recevoir des messagesRécupérer les messages des utilisateurs depuis la plateforme
2. Conversion de formatConvertir uniformément vers le format interne d'OpenClaw
3. Envoyer une réponseRenvoyer les réponses d'OpenClaw à la plateforme

Exemple : flux de travail d'un canal Telegram

Processus de flux de messages

Voyons maintenant comment un message complet circule à travers OpenClaw :

Diagramme complet du flux de messages

Analyse détaillée des étapes

Étapes 1-3 : Réception et normalisation des messages

Après qu'un utilisateur envoie un message sur Telegram, le canal Telegram le convertit au format standard d'OpenClaw :

{
  "platform": "telegram",
  "channel_id": "telegram_123",
  "user": {
    "id": "user_456",
    "name": "Alice"
  },
  "message": {
    "type": "text",
    "content": "上海明天天气?",
    "timestamp": "2024-03-09T10:30:00Z"
  }
}

Étapes 4-5 : Authentification et routage

Gateway vérifie ce message :

• La source est-elle autorisée ?
• Vers quel Workspace doit-il être routé ?
• L'utilisateur a-t-il la permission ?

Étapes 6-8 : Compréhension et prise de décision de l'IA

Workspace prépare le contexte complet et l'envoie au LLM :

[系统提示]
你是一个个人助理，可以使用以下技能：
- weather: 查询天气
- calendar: 管理日程
- ...

[对话历史]
User: 你好
助理: 你好！有什么可以帮你的？

[当前消息]
User: 上海明天天气?

Étapes 9-12 : Exécution des compétences

Le LLM décide d'appeler la compétence météo, et le Workspace l'exécute et obtient les résultats :

{
  "location": "上海",
  "date": "2024-03-10",
  "weather": "晴转多云",
  "temperature": "18-26°C",
  "humidity": "60%",
  "wind": "东风 3-4级"
}

Étapes 13-17 : Générer une réponse et la renvoyer

Le LLM génère une réponse en langage naturel basée sur les données météo et la renvoie à l'utilisateur en suivant le même chemin.

Système de compétences

Que sont les compétences ?

Les compétences sont les "modules de capacités" avec lesquels OpenClaw exécute des tâches spécifiques. Si OpenClaw était une personne, les compétences seraient les diverses capacités que cette personne a maîtrisées.

Structure d'une compétence

Chaque compétence comprend :

Exemple : Définition de la compétence météo

Processus d'invocation d'une compétence

Mécanismes de sécurité des compétences

OpenClaw dispose de contrôles de sécurité stricts sur les compétences :

Types d’autorisations :

Flux de travail complet

Relions tous les concepts à travers un scénario réel :

Scénario : Envoi de rapports météo quotidiens selon un planning

Exigence: Recevoir la météo d'aujourd'hui + des rappels de planning via Telegram chaque matin à 8 AM

Code de configuration

# workspace-daily-report.yaml
name: "每日报告助理"

# 定时任务
cron_jobs:
  - name: "早间报告"
    schedule: "0 8 * * *"  # 每天早上8点
    action:
      type: "send_message"
      channel: "telegram"
      template: |
        请生成今日报告：
        1. 查询我所在城市的天气
        2. 列出今天的所有日程
        3. 以友好的方式呈现

# 可用技能
skills:
  - weather
  - calendar

# LLM 配置
llm:
  provider: "anthropic"
  model: "claude-sonnet-4"

Messages reçus par l'utilisateur

早安！今日简报

天气情况
上海今天多云，气温 15-23°C
建议穿着：薄外套
降雨概率：10%

今日日程
- 09:00 - 10:00  团队晨会
- 14:00 - 15:30  客户演示
- 16:00 - 17:00  代码评审

温馨提示
今天有 3 个会议，建议提前准备演示材料。

Flux de données et gestion de l'état

Comment les données sont-elles stockées ?

Types de données et méthodes de stockage :

Extensibilité et écosystème de plugins

Comment ajouter de nouvelles fonctionnalités ?

La conception d'OpenClaw permet une extension facile :

Processus d'installation des compétences