3.3 KiB
| read_when | summary | title | x-i18n | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Flux de développement pour l’intégration Pi : build, test et validation en conditions réelles | Flux de développement Pi |
|
Flux de développement Pi
Ce guide résume un flux de travail raisonnable pour travailler sur l’intégration pi dans OpenClaw.
Vérification de 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 chargement différé/de modules - Garde complète avant livraison pour les changements fortement liés à Pi :
pnpm check && pnpm test
Exécuter les tests Pi
Exécutez directement l’ensemble de tests centré sur Pi avec Vitest :
pnpm test \
"src/agents/pi-*.test.ts" \
"src/agents/pi-embedded-*.test.ts" \
"src/agents/pi-tools*.test.ts" \
"src/agents/pi-settings.test.ts" \
"src/agents/pi-tool-definition-adapter*.test.ts" \
"src/agents/pi-hooks/**/*.test.ts"
Pour inclure l’exercice fournisseur en conditions réelles :
OPENCLAW_LIVE_TEST=1 pnpm test src/agents/pi-embedded-runner-extraparams.live.test.ts
Cela couvre les principales suites de tests unitaires Pi :
src/agents/pi-*.test.tssrc/agents/pi-embedded-*.test.tssrc/agents/pi-tools*.test.tssrc/agents/pi-settings.test.tssrc/agents/pi-tool-definition-adapter.test.tssrc/agents/pi-hooks/*.test.ts
Tests manuels
Flux recommandé :
- Exécuter la Gateway en mode dev :
pnpm gateway:dev
- Déclencher l’agent directement :
pnpm openclaw agent --message "Hello" --thinking low
- Utiliser le TUI pour le débogage interactif :
pnpm tui
Pour le comportement des appels d’outils, demandez une action read ou exec afin de pouvoir voir le streaming des outils et la gestion des charges utiles.
Réinitialisation complète
L’état se trouve sous le répertoire d’état OpenClaw. Par défaut c’est ~/.openclaw. Si OPENCLAW_STATE_DIR est défini, utilisez ce répertoire à la place.
Pour tout réinitialiser :
openclaw.jsonpour la configurationagents/<agentId>/agent/auth-profiles.jsonpour les profils d’authentification des modèles (clés API + OAuth)credentials/pour l’état fournisseur/canal qui vit encore en dehors du magasin de profils d’authentificationagents/<agentId>/sessions/pour l’historique de session de l’agentagents/<agentId>/sessions/sessions.jsonpour l’index des sessionssessions/si des chemins hérités existentworkspace/si vous voulez un espace de travail vierge
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 fournisseur sous credentials/ en place.