docs/docs/fr/pi-dev.md
2026-04-05 12:58:42 +00:00

3.3 KiB
Raw Blame History

read_when summary title x-i18n
Travail sur le code ou les tests dintégration Pi
Exécution des flux Pi spécifiques de lint, typecheck et tests en conditions réelles
Flux de développement pour lintégration Pi : build, test et validation en conditions réelles Flux de développement Pi
generated_at model provider source_hash source_path workflow
2026-04-05T12:47:53Z gpt-5.4 openai f61ebe29ea38ac953a03fe848fe5ac6b6de4bace5e6955b76ae9a7d093eb0cc5 pi-dev.md 15

Flux de développement Pi

Ce guide résume un flux de travail raisonnable pour travailler sur lintégration pi dans OpenClaw.

Vérification de types et linting

  • Garde locale par défaut : pnpm check
  • Garde de build : pnpm build lorsque 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 lensemble 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 lexercice 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.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

Tests manuels

Flux recommandé :

  • Exécuter la Gateway en mode dev :
    • pnpm gateway:dev
  • Déclencher lagent directement :
    • pnpm openclaw agent --message "Hello" --thinking low
  • Utiliser le TUI pour le débogage interactif :
    • pnpm tui

Pour le comportement des appels doutils, 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 cest ~/.openclaw. Si OPENCLAW_STATE_DIR est défini, utilisez ce répertoire à la place.

Pour tout réinitialiser :

  • openclaw.json pour la configuration
  • agents/<agentId>/agent/auth-profiles.json pour les profils dauthentification des modèles (clés API + OAuth)
  • credentials/ pour létat fournisseur/canal qui vit encore en dehors du magasin de profils dauthentification
  • agents/<agentId>/sessions/ pour lhistorique de session de lagent
  • agents/<agentId>/sessions/sessions.json pour lindex des sessions
  • sessions/ si des chemins hérités existent
  • workspace/ 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 lauthentification, laissez agents/<agentId>/agent/auth-profiles.json et tout état fournisseur sous credentials/ en place.

Références