OpenClaw開発ガイド：Pi統合のビルド・テスト・デバッグ手順

新しい機能を統合するとき、ワークフローがバラバラだと開発の効率が落ちてしまいますよね。特に複雑な API 連携を含む開発では、一貫した手順で確認を進めることが重要です。

今回は、OpenClaw で Pi 統合を進めるための、効率的で「健全な」開発ワークフローをご紹介します。

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-hooks/**/*.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-hooks/*.test.ts

手動テスト

実際に動かして確認するのが一番確実です。おすすめのテストフローは以下の通りです。

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

Tool call の挙動を確認したいときは、read や exec アクションを促すプロンプトを試してみてください。ストリーミングやペイロードの処理がどのように行われているかを直接確認できます。

クリーンな状態へのリセット

状態（State）は OpenClaw の state ディレクトリに保存されます。デフォルトは ~/.openclaw ですが、OPENCLAW_STATE_DIR が設定されている場合はそちらのディレクトリが優先されます。

すべてをリセットしたい場合は、以下の項目を削除または確認してください。

• 設定用の openclaw.json
• 認証プロファイルとトークン用の credentials/
• Agent のセッション履歴用の agents/<agentId>/sessions/
• セッションインデックス用の agents/<agentId>/sessions.json
• レガシーパスが存在する場合の sessions/
• 空のワークスペースが必要な場合の workspace/

セッションだけをリセットしたいなら、該当する Agent の agents/<agentId>/sessions/ と agents/<agentId>/sessions.json を削除するだけで OK です。再認証の手間を省きたい場合は、credentials/ は残しておきましょう。

リファレンス

• Testing
• Getting Started

次のステップ

• Testing
• Getting Started

AI Setup Assistant