Amorçage de l’agent

L’amorçage est le rituel de première exécution qui initialise l’espace de travail d’un nouvel agent et l’accompagne dans le choix d’une identité. Il s’exécute une seule fois, juste après la configuration initiale, lors du premier véritable tour de l’agent.

Déroulement

Lors de la première exécution dans un tout nouvel espace de travail (~/.openclaw/workspace par défaut), OpenClaw :

• Initialise AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md et BOOTSTRAP.md.
• Demande à l’agent de suivre BOOTSTRAP.md : une conversation libre (et non un formulaire fixe de questions-réponses) permettant de définir un nom, une personnalité et un style.
• Consigne les informations recueillies dans IDENTITY.md, USER.md et SOUL.md.
• Supprime BOOTSTRAP.md une fois que l’espace de travail semble configuré, afin que le rituel ne s’exécute qu’une seule fois.

Un espace de travail est considéré comme configuré dès que SOUL.md, IDENTITY.md ou USER.md diffère de son modèle initial, ou qu’un dossier memory/ existe.

Exécutions avec un modèle intégré ou local

Pour les exécutions avec un modèle intégré ou local, OpenClaw exclut BOOTSTRAP.md du contexte système privilégié. Lors de la première exécution interactive principale, OpenClaw transmet néanmoins le contenu du fichier dans le prompt utilisateur, afin que les modèles qui n’appellent pas systématiquement l’outil read puissent tout de même accomplir le rituel. Si l’exécution en cours ne peut pas accéder à l’espace de travail en toute sécurité, l’agent reçoit une courte note d’amorçage limité au lieu d’un message d’accueil générique.

Ignorer l’amorçage

Pour ignorer cette étape dans un espace de travail préinitialisé, exécutez :

openclaw onboard --skip-bootstrap

Lieu d’exécution

L’amorçage s’exécute toujours sur l’hôte du Gateway. Si l’application macOS se connecte à un Gateway distant, l’espace de travail et ses fichiers d’amorçage se trouvent sur cette machine distante, et non sur le Mac.

Documentation associée

• Configuration initiale de l’application macOS : Configuration initiale
• Structure de l’espace de travail : Espace de travail de l’agent
• Contenu du modèle : Modèle BOOTSTRAP.md