Agent Runtime

Runtime de l’agent

OpenClaw exécute un seul runtime d’agent intégré.

Espace de travail (requis)

OpenClaw utilise un seul répertoire d’espace de travail de l’agent (agents.defaults.workspace) comme répertoire de travail unique (cwd) de l’agent pour les outils et le contexte.

Recommandé : utilisez openclaw setup pour créer ~/.openclaw/openclaw.json s’il est manquant et initialiser les fichiers de l’espace de travail.

Guide complet de la disposition de l’espace de travail + sauvegarde : Espace de travail de l’agent

Si agents.defaults.sandbox est activé, les sessions non principales peuvent remplacer ceci par des espaces de travail par session sous agents.defaults.sandbox.workspaceRoot (voir configuration du Gateway).

Fichiers d’amorçage (injectés)

Dans agents.defaults.workspace, OpenClaw s’attend à ces fichiers modifiables par l’utilisateur :

• AGENTS.md — instructions de fonctionnement + « mémoire »
• SOUL.md — personnalité, limites, ton
• TOOLS.md — notes sur les outils maintenues par l’utilisateur (ex. imsg, sag, conventions)
• BOOTSTRAP.md — rituel d’exécution unique au premier démarrage (supprimé après achèvement)
• IDENTITY.md — nom/atmosphère/emoji de l’agent
• USER.md — profil utilisateur + adresse préférée

Au premier tour d’une nouvelle session, OpenClaw injecte directement le contenu de ces fichiers dans le contexte de l’agent.

Les fichiers vides sont ignorés. Les fichiers volumineux sont rognés et tronqués avec un marqueur pour que les invites restent légères (lisez le fichier pour le contenu complet).

Si un fichier est manquant, OpenClaw injecte une seule ligne de marqueur « fichier manquant » (et openclaw setup créera un modèle par défaut sécurisé).

BOOTSTRAP.md est créé uniquement pour un espace de travail entièrement nouveau (aucun autre fichier d’amorçage présent). Si vous le supprimez après avoir terminé le rituel, il ne devrait pas être recréé lors des redémarrages ultérieurs.

Pour désactiver complètement la création de fichiers d’amorçage (pour les espaces de travail pré-remplis), définissez :

{ agent: { skipBootstrap: true } }

Outils intégrés

Les outils principaux (read/exec/edit/write et les outils système associés) sont toujours disponibles, sous réserve de la stratégie d’outils. apply_patch est optionnel et restreint par tools.exec.applyPatch. TOOLS.md ne contrôle pas les outils existants ; il s’agit de directives sur la manière dont vous souhaitez qu’ils soient utilisés.

Skills

OpenClaw charge les Skills depuis trois emplacements (l’espace de travail prévaut en cas de conflit de noms) :

• Groupés (fournis avec l’installation)
• Gérés/locaux : ~/.openclaw/skills
• Espace de travail : <workspace>/skills

Les compétences peuvent être restreintes par la config/l’environnement (voir skills dans configuration du Gateway).

Limites du runtime

Le runtime de l’agent intégré est basé sur le cœur de l’agent Pi (modèles, outils et pipeline de invites). La gestion des sessions, la découverte, le câblage des outils et la livraison via le canal sont des couches détenues par OpenClaw par-dessus ce cœur.

Sessions

Les transcriptions de session sont stockées au format JSONL à l’emplacement :

• ~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl

L’ID de session est stable et choisi par OpenClaw. Les dossiers de session hérités d’autres outils ne sont pas lus.

Pilotage lors du streaming

Lorsque le mode de file d’attente est steer, les messages entrants sont injectés dans l’exécution actuelle. La direction en file d’attente est délivrée une fois que le tour de l’assistant actuel a fini d’exécuter ses appels de tool, avant le prochain appel LLM. La direction ne saute plus les appels de tool restants du message de l’assistant actuel ; elle injecte plutôt le message mis en file d’attente à la prochaine limite du model.

Lorsque le mode de file d’attente est followup ou collect, les messages entrants sont retenus jusqu’à ce que le tour actuel se termine, puis un nouveau tour d’agent commence avec les charges utiles en file d’attente. Voir File d’attente pour le comportement du mode + anti-rebond/limite.

Block streaming sends completed assistant blocks as soon as they finish; it is off by default (agents.defaults.blockStreamingDefault: "off"). Tune the boundary via agents.defaults.blockStreamingBreak (text_end vs message_end; defaults to text_end). Control soft block chunking with agents.defaults.blockStreamingChunk (defaults to 800–1200 chars; prefers paragraph breaks, then newlines; sentences last). Coalesce streamed chunks with agents.defaults.blockStreamingCoalesce to reduce single-line spam (idle-based merging before send). Non-Telegram channels require explicit *.blockStreaming: true to enable block replies. Verbose tool summaries are emitted at tool start (no debounce); Control UI streams tool output via agent events when available. More details: Streaming + chunking.

Model refs

Model refs in config (for example agents.defaults.model and agents.defaults.models) are parsed by splitting on the first /.

• Use provider/model when configuring models.
• If the model ID itself contains / (OpenRouter-style), include the provider prefix (example: openrouter/moonshotai/kimi-k2).
• If you omit the provider, OpenClaw treats the input as an alias or a model for the default provider (only works when there is no / in the model ID).

Configuration (minimal)

At minimum, set:

• agents.defaults.workspace
• channels.whatsapp.allowFrom (strongly recommended)

---

Next: Group Chats 🦞