Agent runtime

OpenClaw exécute un runtime d’agent unique intégré - un processus d’agent par Gateway, avec son propre espace de travail, ses fichiers d’amorçage et son stockage de session. Cette page couvre ce contrat de runtime : ce que l’espace de travail doit contenir, quels fichiers sont injectés, et comment les sessions s’amorcent avec.

Espace de travail (requis)

OpenClaw utilise un répertoire unique d’espace de travail de l’agent (OpenClawagents.defaults.workspace) comme seul répertoire de travail de l’agent (cwd) 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.

Plan complet de l’espace de travail + guide de sauvegarde : Espace de travail de l’agent

Si agents.defaults.sandbox est activé, les sessions non principales peuvent remplacer cela 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 à trouver ces fichiers modifiables par l’utilisateur :

AGENTS.md - instructions de fonctionnement + “mémoire”
SOUL.md - persona, limites, ton
TOOLS.md - notes sur les outils maintenues par l’utilisateur (ex. imsg, sag, conventions)
BOOTSTRAP.md - rituel unique de premier démarrage (supprimé après achèvement)
IDENTITY.md - nom/ambiance/emoji de l’agent
USER.md - profil utilisateur + adresse préférée

Au premier tour d’une nouvelle session, OpenClaw injecte le contenu de ces fichiers dans le contexte du projet du système prompt.

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 OpenClawopenclaw setup créera un modèle par défaut sécurisé).

BOOTSTRAP.mdOpenClaw est créé uniquement pour un espace de travail tout nouveau (aucun autre fichier d’amorçage présent). Tant qu’il est en attente, OpenClaw le conserve dans le contexte du projet et ajoute des instructions d’amorçage du système prompt pour le rituel initial au lieu de le copier dans le message utilisateur. Si vous le supprimez après avoir terminé le rituel, il ne doit pas être recréé lors des redémarrages ultérieurs.

Pour désactiver entièrement la création des fichiers d’amorçage (pour les espaces de travail pré-ensemencés), définissez :

{ agents: { defaults: { 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 limité par tools.exec.applyPatch. TOOLS.md ne contrôle pas les outils existants ; il s’agit de directives pour la manière dont vous souhaitez qu’ils soient utilisés.

Compétences

OpenClaw charge les compétences depuis ces emplacements (du plus prioritaire au moins prioritaire) :

Espace de travail : <workspace>/skills
Compétences de l’agent de projet : <workspace>/.agents/skills
Compétences de l’agent personnel : ~/.agents/skills
Géré/local : ~/.openclaw/skills
Groupés (fournis avec l’installation)
Dossiers de compétences supplémentaires : skills.load.extraDirs

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

Limites du runtime

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

Sessions

Les transcriptions de sessions sont stockées au format JSONL à :

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

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

Pilotage pendant le streaming

Les invites entrantes qui arrivent en cours d’exécution sont dirigées vers l’exécution en cours par défaut. La direction est délivrée après que le tour de l’assistant actuel a terminé d’exécuter ses appels d’outil, avant le prochain appel LLM, et ne saute plus les appels d’outil restants du message de l’assistant actuel.

/queue steer est le comportement par défaut de l’exécution active. /queue followup et /queue collect font attendre les messages pour un tour ultérieur au lieu de diriger. /queue interrupt abandonne l’exécution active à la place. Voir File d’attente et File d’attente de direction pour le comportement de la file d’attente et des limites.

Le bloc streaming envoie les blocs d’assistant terminés dès qu’ils sont finis ; il est désactivé par défaut (agents.defaults.blockStreamingDefault: "off"). Ajustez la limite via agents.defaults.blockStreamingBreak (text_end vs message_end ; par défaut text_end). Contrôlez le découpage souple des blocs avec agents.defaults.blockStreamingChunk (par défaut 800-1200 caractères ; préfère les sauts de paragraphe, puis les nouvelles lignes ; les phrases en dernier). Fusionnez les morceaux diffusés avec agents.defaults.blockStreamingCoalesce pour réduire le spam d’une seule ligne (fusion basée sur l’inactivité avant l’envoi). Les canaux non-Telegram nécessitent un *.blockStreaming: true explicite pour activer les réponses par bloc. Les résumés d’outils verbeux sont émis au début de l’outil (sans rebond) ; L’interface de contrôle diffuse la sortie de l’outil via les événements de l’agent lorsque disponible. Plus de détails : Streaming + découpage.

Model refs

Les références de modèle dans la configuration (par exemple agents.defaults.model et agents.defaults.models) sont analysées en divisant sur le premier /.

Utilisez provider/model lors de la configuration des models.
Si l’ID du model lui-même contient / (style OpenRouter), incluez le préfixe du provider (exemple : openrouter/moonshotai/kimi-k2).
Si vous omettez le fournisseur, OpenClaw essaie d’abord un alias, puis une correspondance unique de fournisseur configuré pour cet ID de modèle exact, et ne revient ensuite qu’au fournisseur par défaut configuré. Si ce fournisseur n’expose plus le modèle par défaut configuré, OpenClaw revient au premier fournisseur/modèle configuré au lieu d’afficher un défaut de fournisseur obsolète supprimé.

Configuration (minimale)

Au minimum, définissez :

agents.defaults.workspace
channels.whatsapp.allowFrom (fortement recommandé)

Suite : Group Chats 🦞