Advanced setup
Workflow d’exécution de l’agent OpenClaw
Workflow de développement pour le runtime d’agent (src/agents/) dans le dépôt OpenClaw.
Vérification des types et lint
- Contrôle local par défaut :
pnpm check(vérification des types, lint, contrôles de politique) - Contrôle de build :
pnpm buildlorsque la modification peut affecter la sortie du build, le packaging ou les limites du chargement différé/des modules - Contrôle pré-push complet :
pnpm build && pnpm check && pnpm check:test-types && pnpm test
Exécution des tests du runtime d’agent
Exécutez les suites de tests unitaires du runtime d’agent :
pnpm test \ "src/agents/agent-*.test.ts" \ "src/agents/embedded-agent-*.test.ts" \ "src/agents/agent-hooks/**/*.test.ts"Le premier glob couvre également les suites agent-tools*, agent-settings et
agent-tool-definition-adapter*.
Les tests en conditions réelles sont exclus de la configuration des tests unitaires ; exécutez-les avec le
wrapper dédié (il définit OPENCLAW_LIVE_TEST=1 et nécessite des identifiants de fournisseur) :
pnpm test:live src/agents/embedded-agent-runner-extraparams.live.test.tsTests manuels
- Exécutez le Gateway en mode développement (ignore les connexions aux canaux via
OPENCLAW_SKIP_CHANNELS=1) :pnpm gateway:dev - Déclenchez un tour d’agent via le Gateway :
pnpm openclaw agent --message "Hello" --thinking low - Utilisez la TUI pour le débogage interactif :
pnpm tui
Pour tester le comportement des appels d’outils, demandez une action read ou exec afin de pouvoir observer
le streaming des outils et le traitement des charges utiles.
Réinitialisation complète
L’état se trouve dans le répertoire d’état d’OpenClaw : ~/.openclaw par défaut, ou
$OPENCLAW_STATE_DIR lorsqu’il est défini. Chemins relatifs à ce répertoire :
| Chemin | Contenu |
|---|---|
openclaw.json |
Configuration |
state/openclaw.sqlite |
Base de données d’état partagé du runtime |
agents/<agentId>/agent/openclaw-agent.sqlite |
Profils d’authentification du modèle par agent (clés API + OAuth) et état du runtime |
credentials/ |
Identifiants des fournisseurs/canaux hors du stockage des profils d’authentification |
agents/<agentId>/sessions/ |
Historique des transcriptions et sources de migration des sessions héritées |
sessions/ |
Stockage hérité des sessions à agent unique (anciennes installations uniquement) |
workspace/ |
Espace de travail par défaut de l’agent (les agents supplémentaires utilisent workspace-<agentId>) |
Supprimez ces chemins pour effectuer une réinitialisation complète. Réinitialisations plus ciblées :
- Sessions uniquement : ne supprimez pas
agents/<agentId>/agent/openclaw-agent.sqlite; les lignes de session y sont stockées avec les autres états propres à l’agent. Utilisez/newou/resetpour démarrer une nouvelle session pour une conversation, etopenclaw sessions cleanuppour la maintenance des sessions. - Conserver l’authentification : laissez
agents/<agentId>/agent/openclaw-agent.sqliteetcredentials/en place.
Les anciens fichiers auth-profiles.json ne sont plus lus lors de l’exécution ;
openclaw doctor --fix les importe dans le stockage SQLite.
