OpenClaw エージェントランタイムのワークフロー

OpenClaw で OpenClaw エージェントランタイムに取り組むための健全なワークフロー。

型チェックと lint

• デフォルトのローカルゲート: pnpm check
• ビルドゲート: 変更がビルド出力、パッケージング、または遅延読み込み/モジュール境界に影響する可能性がある場合は pnpm build
• エージェントランタイム変更の完全なランディングゲート: pnpm check && pnpm test

エージェントランタイムテストの実行

Vitest で agent-runtime テストセットを直接実行します。

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"

ライブプロバイダー演習を含めるには:

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

これは主要なエージェントランタイムのユニットスイートを対象にします。

• 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

手動テスト

推奨フロー:

• 開発モードで Gateway を実行します。
  • pnpm gateway:dev
• エージェントを直接トリガーします。
  • pnpm openclaw agent --message "Hello" --thinking low
• インタラクティブなデバッグには TUI を使用します。
  • pnpm tui

ツール呼び出しの動作については、read または exec アクションをプロンプトし、ツールストリーミングとペイロード処理を確認できるようにします。

クリーンスレートリセット

状態は OpenClaw 状態ディレクトリの下にあります。デフォルトは ~/.openclaw です。OPENCLAW_STATE_DIR が設定されている場合は、代わりにそのディレクトリを使用します。

すべてをリセットするには:

• 設定用の openclaw.json
• モデル認証プロファイル（API キー + OAuth）用の agents/<agentId>/agent/auth-profiles.json
• 認証プロファイルストアの外にまだ存在するプロバイダー/チャネル状態用の credentials/
• エージェントセッション履歴用の agents/<agentId>/sessions/
• セッションインデックス用の agents/<agentId>/sessions/sessions.json
• レガシーパスが存在する場合は sessions/
• 空のワークスペースが必要な場合は workspace/

セッションだけをリセットしたい場合は、そのエージェントの agents/<agentId>/sessions/ を削除します。認証を保持したい場合は、agents/<agentId>/agent/auth-profiles.json と credentials/ 配下のプロバイダー状態をそのまま残します。

参考資料

• テスト
• はじめに

関連

• OpenClaw エージェントランタイムアーキテクチャ