src/agents/）向け開発ワークフロー。
型チェックとリント
- デフォルトのローカルゲート:
pnpm check（型チェック、リント、ポリシーガード） - ビルドゲート: 変更がビルド出力、パッケージング、遅延読み込み、またはモジュール境界に影響する可能性がある場合は
pnpm build - プッシュ前の完全なゲート:
pnpm build && pnpm check && pnpm check:test-types && pnpm test
エージェントランタイムテストの実行
エージェントランタイムのユニットテストスイートを実行します。agent-tools*、agent-settings、および
agent-tool-definition-adapter* の各スイートも対象に含みます。
ライブテストはユニットテスト設定から除外されています。ライブテスト用の
ラッパーを介して実行してください（OPENCLAW_LIVE_TEST=1 が設定され、プロバイダーの認証情報が必要です）。
手動テスト
- Gateway を開発モードで実行します（
OPENCLAW_SKIP_CHANNELS=1によりチャンネル接続をスキップします）:pnpm gateway:dev - Gateway を介してエージェントのターンを 1 回トリガーします:
pnpm openclaw agent --message "Hello" --thinking low - 対話的なデバッグには TUI を使用します:
pnpm tui
read または exec のアクションを実行するように指示し、
ツールのストリーミングとペイロード処理を観察できるようにします。
クリーンな状態へのリセット
状態は OpenClaw の状態ディレクトリに保存されます。デフォルトは~/.openclaw で、
$OPENCLAW_STATE_DIR が設定されている場合はその値が使用されます。そのディレクトリからの相対パスは次のとおりです。
完全にリセットするには、これらのパスを削除します。より限定的にリセットする場合:
- セッションのみ:
agents/<agentId>/agent/openclaw-agent.sqliteは削除しないでください。セッション行は、エージェントごとの他の状態とともにそこに保存されています。1 つのチャットで新しいセッションを開始するには/newまたは/resetを、セッションのメンテナンスにはopenclaw sessions cleanupを使用します。 - 認証を維持:
agents/<agentId>/agent/openclaw-agent.sqliteとcredentials/はそのまま残します。
auth-profiles.json ファイルは、ランタイムでは読み込まれなくなりました。
openclaw doctor --fix により、これらのファイルが SQLite ストアにインポートされます。