Advanced setup
Flux de travail du runtime de l’agent OpenClaw
Un workflow sain pour travailler sur le runtime d’agent OpenClaw dans OpenClaw.
Vérification des types et linting
- Garde locale par défaut :
pnpm check - Garde de build :
pnpm buildlorsque la modification peut affecter la sortie de build, le packaging ou les frontières de lazy-loading/modules - Garde complète avant intégration pour les changements du runtime d’agent :
pnpm check && pnpm test
Exécuter les tests du runtime d’agent
Exécutez directement l’ensemble de tests du runtime d’agent avec Vitest :
pnpm test \ "src/agents/agent-*.test.ts" \ "src/agents/embedded-agent-*.test.ts" \ "src/agents/agent-tools*.test.ts" \ "src/agents/agent-settings.test.ts" \ "src/agents/agent-tool-definition-adapter*.test.ts" \ "src/agents/agent-hooks/**/*.test.ts"Pour inclure l’exercice du fournisseur live :
OPENCLAW_LIVE_TEST=1 pnpm test src/agents/embedded-agent-runner-extraparams.live.test.tsCela couvre les principales suites unitaires du runtime d’agent :
src/agents/agent-*.test.tssrc/agents/embedded-agent-*.test.tssrc/agents/agent-tools*.test.tssrc/agents/agent-settings.test.tssrc/agents/agent-tool-definition-adapter.test.tssrc/agents/agent-hooks/*.test.ts
Tests manuels
Flux recommandé :
- Exécutez le Gateway en mode développement :
pnpm gateway:dev
- Déclenchez directement l’agent :
pnpm openclaw agent --message "Hello" --thinking low
- Utilisez le TUI pour le débogage interactif :
pnpm tui
Pour le comportement des appels d’outils, demandez une action read ou exec afin de voir le streaming des outils et la gestion des charges utiles.
Réinitialisation à zéro
L’état réside dans le répertoire d’état OpenClaw. La valeur par défaut est ~/.openclaw. Si OPENCLAW_STATE_DIR est défini, utilisez plutôt ce répertoire.
Pour tout réinitialiser :
openclaw.jsonpour la configurationagents/<agentId>/agent/auth-profiles.jsonpour les profils d’authentification de modèles (clés API + OAuth)credentials/pour l’état des fournisseurs/canaux qui réside encore en dehors du magasin de profils d’authentificationagents/<agentId>/sessions/pour l’historique des sessions d’agentagents/<agentId>/sessions/sessions.jsonpour l’index des sessionssessions/si des chemins hérités existentworkspace/si vous voulez un espace de travail vide
Si vous voulez seulement réinitialiser les sessions, supprimez agents/<agentId>/sessions/ pour cet agent. Si vous voulez conserver l’authentification, laissez agents/<agentId>/agent/auth-profiles.json et tout état de fournisseur sous credentials/ en place.