Pi 開発ワークフロー

このガイドでは、OpenClaw における Pi 連携の開発ワークフローをまとめます。

型チェックと Lint

• 型チェックとビルド: pnpm build
• Lint: pnpm lint
• フォーマットチェック: pnpm format
• プッシュ前のフルゲート: pnpm lint && pnpm build && pnpm test

Pi テストの実行

Pi 関連のテストセットを 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-extensions/**/*.test.ts"

ライブプロバイダーテストも含める場合:

OPENCLAW_LIVE_TEST=1 pnpm test -- src/agents/pi-embedded-runner-extraparams.live.test.ts

主な 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-extensions/*.test.ts

手動テスト

推奨フロー:

• 開発モードで Gateway を起動:
  • pnpm gateway:dev
• エージェントを直接トリガー:
  • pnpm openclaw agent --message "Hello" --thinking low
• TUI を使ってインタラクティブにデバッグ:
  • pnpm tui

ツールコールの挙動を確認するには、read や exec アクションを要求して、ツールのストリーミングやペイロードの処理を観察してください。

クリーンリセット

状態は OpenClaw の状態ディレクトリに保存されます。デフォルトは ~/.openclaw です。OPENCLAW_STATE_DIR が設定されている場合はそのディレクトリが使われます。

すべてをリセットする場合:

• openclaw.json — 設定
• credentials/ — 認証プロファイルとトークン
• agents/<agentId>/sessions/ — エージェントのセッション履歴
• agents/<agentId>/sessions.json — セッションインデックス
• sessions/ — レガシーパスが存在する場合
• workspace/ — ワークスペースを完全に初期化したい場合

セッションだけをリセットしたい場合は、該当エージェントの agents/<agentId>/sessions/ と agents/<agentId>/sessions.json を削除します。再認証を避けたい場合は credentials/ を残してください。

参考リンク

• https://docs.openclaw.ai/testing
• https://docs.openclaw.ai/start/getting-started