Concepts fondamentaux pour comprendre l'architecture de l'assistant IA Clawdbot, les sessions, le routage multi-agent et la gestion des messages.

Aperçu des Concepts Clawdbot

Comprendre les concepts fondamentaux de Clawdbot vous aide à configurer et utiliser votre assistant IA efficacement. Cette section couvre les éléments de base de Clawdbot.

Concepts Clés

Architecture du Gateway

Le Gateway est le daemon central qui :

Maintient toutes les connexions des fournisseurs de messagerie
Expose une API WebSocket typée
Gère le runtime des agents et les sessions
Gère le routage des messages

En savoir plus sur l'Architecture du Gateway

Sessions

Clawdbot traite une session de chat direct par agent comme principale :

Les chats directs sont fusionnés en agent:<agentId>:<mainKey>
Les chats de groupe/canal obtiennent leurs propres clés
L'état de la session appartient au Gateway

Routage Multi-Agent

Exécutez plusieurs agents isolés avec :

Des espaces de travail séparés (fichiers, règles de persona)
Des répertoires d'état
Des stockages de session
Des profils d'authentification

Runtime de l'Agent

Le runtime de l'agent gère :

Le traitement des messages
L'exécution des outils
La gestion du contexte
La génération des réponses

Gestion des Sessions

Options de Portée DM

Portée	Description
`main` (par défaut)	Tous les DMs partagent la session principale
`per-peer`	Isoler par ID d'expéditeur entre les canaux
`per-channel-peer`	Isoler par canal + expéditeur
`per-account-channel-peer`	Isoler par compte + canal + expéditeur

Clés de Session

Source	Format de Clé
Chats directs	`agent:<agentId>:<mainKey>`
Chats de groupe	`agent:<agentId>:<channel>:group:<id>`
Jobs cron	`cron:<job.id>`
Webhooks	`hook:<uuid>`

Cycle de Vie de la Session

Les sessions sont réutilisées jusqu'à expiration
Réinitialisation quotidienne par défaut à 4h00 heure locale
Réinitialisation optionnelle en cas d'inactivité via idleMinutes

Configuration Multi-Agent

Qu'est-ce qu'un Agent ?

Un agent est un cerveau entièrement délimité avec :

Espace de travail : Fichiers, AGENTS.md, SOUL.md, règles de persona
Répertoire d'état : Profils d'authentification, registre de modèles
Stockage de session : Historique de chat + état de routage
Compétences : Par agent via le dossier skills/ de l'espace de travail

Mode Agent Unique (Par Défaut)

agentId est par défaut main
Les sessions sont identifiées comme agent:main:<mainKey>
Espace de travail dans ~/.clawdbot/workspace

Ajouter des Agents

# Ajouter un nouvel agent
clawdbot agents add work

# Lister les agents avec les bindings
clawdbot agents list --bindings

Règles de Routage

Les messages sont routés vers les agents via des bindings :

{
  "bindings": [
    {
      "agentId": "alex",
      "match": {
        "channel": "whatsapp",
        "peer": { "kind": "dm", "id": "+15551230001" }
      }
    }
  ]
}

Gestion des Messages

Streaming et Chunking

Clawdbot prend en charge les réponses en streaming :

Mises à jour partielles des messages
Indicateurs de saisie
Livraison par chunks pour les réponses longues

Politique de Retry

Les messages échoués sont réessayés avec :

Backoff exponentiel
Limites de retry configurables
Gestion des erreurs

Où Réside l'État

Élément	Emplacement
Configuration	`~/.clawdbot/clawdbot.json`
Sessions	`~/.clawdbot/agents/<agentId>/sessions/`
Transcriptions	`~/.clawdbot/agents/<agentId>/sessions/<SessionId>.jsonl`
Profils d'authentification	`~/.clawdbot/agents/<agentId>/agent/auth-profiles.json`

Prochaines Étapes

Gateway Clawdbot - Configuration du Gateway
Outils Clawdbot - Configuration des outils
Canaux Clawdbot - Configuration des canaux

Concepts Clawdbot

On this page