> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # テスト * 完全なテストキット（スイート、ライブ、Docker）: [テスト](/ja-JP/help/testing) * 更新と Plugin パッケージの検証: [更新と Plugin のテスト](/ja-JP/help/testing-updates-plugins) ## エージェントのデフォルト エージェントセッションは、テストと計算負荷の高い検証を Crabbox 経由でリモート実行します。信頼済みメンテナーコードでは、デフォルトで Blacksmith Testbox を使用します。設定済みの Testbox ワークフローは認証情報をハイドレートするため、信頼されていないコントリビューターまたはフォークのコードでは、代わりにシークレットなしのフォーク CI またはサニタイズ済みの直接 AWS Crabbox を使用する必要があります。 信頼済みコードのタスクでテストや重い証明が必要になりそうな場合は、バックグラウンドコマンドセッションですぐにプリウォームし、ハイドレート中も作業を続け、返された `tbx_...` id を再利用し、実行ごとに現在のチェックアウトを同期し、引き渡し前に停止します。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} node scripts/crabbox-wrapper.mjs warmup --provider blacksmith-testbox --keep --timing-json ``` 以下のローカルテストコマンドは、人間のワークフロー、またはユーザーから明示的に要求されたエージェントのフォールバック用です。リモートプロバイダーが利用できない場合は報告する必要があります。それは広範なローカルゲートを黙って実行する許可ではありません。 信頼されていないコードでは、`--provider aws` でプリウォームします。すべての実行で `CRABBOX_ENV_ALLOW=CI` を設定し、`--provider aws --no-hydrate` を渡し、依存関係をインストールまたはテストを実行する前に、新しい一時リモート `HOME` を使用する必要があります。その信頼されていないソース専用に新しくウォームしたリースを使用し、信頼済みまたは以前にハイドレートされたリースを再利用しないでください。クリーンな信頼済み `main` チェックアウトから、インストール済みの信頼済み Crabbox バイナリを起動し、`--fresh-pr` でリモート PR のみを取得します。信頼されていないチェックアウトのラッパーや設定をローカルで実行してはいけません。`CRABBOX_AWS_INSTANCE_PROFILE` を解除し、解決済みの `aws.instanceProfile` が空でない限りフェイルクローズします。インストールやテストの前に、信頼済みの絶対パスツールを使って IMDSv2 トークンを要求し、IAM 認証情報エンドポイントが 404 を返すことを証明し、リモートの `git rev-parse HEAD` がレビュー済み PR ヘッドの完全な SHA と等しいことを検証します。リースをその SHA に結び付け、ヘッドが変わったら停止して再ウォームします。クリーンな `main` から信頼済みの `scripts/crabbox-untrusted-bootstrap.sh` を `--fresh-pr` と一緒にアップロードします。これはピン留めされた Node/pnpm をインストールし、SHA とパッケージマネージャーのピン留めを検証し、`HOME` を分離し、依存関係をインストールしてから、要求されたテストを実行します。ブローカーがロールなし、またはリモート PR が存在しないことを証明できない場合は、シークレットなしのフォーク CI を使用します。`hydrate-github`、`--no-sync`、または認証情報でハイドレートされた Testbox ワークフローを使用しないでください。 すべての `CRABBOX_TAILSCALE*` オーバーライドを解除し、`--network public --tailscale=false` を強制し、exit-node/LAN フラグをクリアし、スクリプトをアップロードする前に `crabbox inspect` が Tailscale 状態なしのパブリックネットワークを報告することを要求します。 ## 通常のローカル順序 1. 変更スコープの Vitest 証明には `pnpm test:changed`。 2. 1 つのファイル、ディレクトリ、または明示的なターゲットには `pnpm test `。 3. ローカルの Vitest フルスイートが意図的に必要な場合のみ `pnpm test`。 Codex ワークツリーまたはリンク/スパースチェックアウトでは、エージェントは直接のローカル `pnpm test*` / `pnpm check*` / `pnpm crabbox:run` を避けます。 * 小さなファイルに対してユーザーが明示的に要求したローカルフォールバック: `node scripts/run-vitest.mjs `。 * 変更ゲートまたは広範な証明: `node scripts/crabbox-wrapper.mjs run --provider blacksmith-testbox ... -- env OPENCLAW_CHECK_CHANGED_REMOTE_CHILD=1 OPENCLAW_CHANGED_LANES_RAW_SYNC=1 corepack pnpm check:changed`。これにより pnpm は Testbox 内で実行されます。 * ラッパーの最終 `exitCode` とタイミング JSON がコマンド結果です。委譲された Blacksmith GitHub Actions 実行は、SSH コマンド成功後に `cancelled` と表示される場合があります。これは Testbox が keepalive action の外部から停止されるためです。失敗として扱う前に、ラッパーのサマリーとコマンド出力を確認してください。 * `OPENCLAW_HEAVY_CHECK_LOCK_SCOPE=worktree `: `pnpm check:changed` や対象指定の `pnpm test ...` などのコマンドで、heavy-check の直列化を Git 共通ディレクトリではなく現在のワークツリー内に保ちます。リンクされたワークツリー間で独立したチェックを意図的に実行する場合に、高容量のローカルホストでのみ使用してください。 ## コアコマンド テストラッパーの実行は、短い `[test] passed|failed|skipped ... in ...` サマリーで終わります。Vitest 自身の所要時間行は、シャードごとの詳細として残ります。 | コマンド | 内容 | | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `pnpm test` | 明示的なファイル/ディレクトリターゲットは、スコープ付き Vitest レーンを通ります。ターゲットなしの実行はフルスイート証明です。固定シャードグループはローカル並列実行用のリーフ設定に展開され、開始前に想定されるシャードのファンアウトが表示されます。Plugin グループは、巨大なルートプロジェクトプロセス 1 つではなく、常に Plugin ごとのシャード設定に展開されます。 | | `pnpm test:changed` | 安価でスマートな変更テスト実行: 直接編集されたテスト、兄弟 `*.test.ts` ファイル、明示的なソースマッピング、ローカル import グラフから精密なターゲットを取得します。広範な設定/パッケージ変更は、精密なテストにマップされない限りスキップされます。 | | `OPENCLAW_TEST_CHANGED_BROAD=1 pnpm test:changed` | 明示的な広範変更テスト実行。テストハーネス/設定/パッケージの編集で、Vitest のより広い変更テスト動作にフォールバックすべき場合に使用します。 | | `pnpm test:force` | 設定済みの OpenClaw Gateway ポート（デフォルト `18789`）を解放してから、分離された Gateway ポートでフルスイートを実行し、サーバーテストが実行中のインスタンスと衝突しないようにします。 | | `pnpm test:coverage` | V8 カバレッジ付きのユニットスイート（`vitest.unit.config.ts`）。リポジトリ全体のカバレッジではなく、デフォルトのユニットレーンゲートです。`coverage.all` は `false` で、しきい値は行/関数/ステートメント 70%、ブランチ 55%、兄弟ソースファイルを持つ非 fast ユニットテストにスコープされます。 | | `pnpm test:coverage:changed` | `origin/main` 以降に変更されたファイルのみのユニットカバレッジ。 | | `pnpm changed:lanes` | `origin/main` に対する diff によってトリガーされるアーキテクチャレーンを表示します。 | | `pnpm check:changed` | CI 外ではデフォルトで Crabbox/Testbox に委譲し、その後リモート子プロセス内でスマート変更チェックゲートを実行します。対象レーンの typecheck、lint、guard コマンドを実行します。Vitest は実行しません。テスト証明には `pnpm test:changed` または `pnpm test ` を使用してください。 | ## 共有テスト状態とプロセスヘルパー * `src/test-utils/openclaw-test-state.ts`: テストで分離された `HOME`、`OPENCLAW_STATE_DIR`、`OPENCLAW_CONFIG_PATH`、設定フィクスチャ、ワークスペース、エージェントディレクトリ、または auth-profile ストアが必要な場合に、Vitest から使用します。 * `pnpm test:env-mutations:report`: `HOME`、`OPENCLAW_STATE_DIR`、`OPENCLAW_CONFIG_PATH`、`OPENCLAW_WORKSPACE_DIR`、または関連する env キーを直接変更するテスト/ハーネスの非ブロッキングレポートです。共有 test-state ヘルパーへの移行候補を見つけるために使用します。 * `test/helpers/openclaw-test-instance.ts`: 実行中の Gateway、CLI env、ログキャプチャ、クリーンアップを 1 か所で必要とするプロセスレベルの E2E テスト用です。 * `scripts/lib/docker-e2e-image.sh` を source する Docker/Bash E2E レーンは、`docker_e2e_test_state_shell_b64