> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# テスト

# テスト

* 完全なテストキット（スイート、ライブ、Docker）: [Testing](/help/testing)

* `pnpm test:force`: 既定の制御ポートを保持している残存ゲートウェイ プロセスをすべて終了し、分離されたゲートウェイ ポートで完全な Vitest スイートを実行します。これにより、実行中のインスタンスとサーバー テストが衝突しません。以前のゲートウェイ 実行でポート 18789 が占有されたままの場合に使用します。 以前のゲートウェイが稼働していた18789ポートが占有されている場合に使用します。 以前のゲートウェイが稼働していた18789ポートが占有されている場合に使用します。

* `pnpm test:coverage`: V8 カバレッジ（`vitest.unit.config.ts` 経由）でユニットテストスイートを実行します。 グローバルしきい値は70%行/ブランチ/関数/ステートメントです。 カバレッジは、ユニットテスト可能なロジックに焦点を合わせるために、統合重量のエントリポイント (CLI 配線、ゲートウェイ/テレグラムブリッジ、ウェブチャット静的サーバー) を除外します。

* Node 24+ での `pnpm test`: OpenClaw は Vitest の `vmForks` を自動的に無効化し、`ERR_VM_MODULE_LINK_FAILURE` や `module is already linked` を回避するために `forks` を使用します。 `OPENCLAW_TEST_VM_FORKS=0|1` で動作を強制できます。

* `pnpm test:e2e`: ゲートウェイのエンドツーエンド スモークテスト（複数インスタンスの WS/HTTP/ノード ペアリング）を実行します。 既定では `vitest.e2e.config.ts` の `vmForks` + 適応型ワーカーが使用されます。`OPENCLAW_E2E_WORKERS=<n>` で調整し、詳細ログを有効にするには `OPENCLAW_E2E_VERBOSE=1` を設定してください。

* `pnpm test:live`: プロバイダーのライブテスト（minimax/zai）を実行します。API キーと、スキップ解除のために `LIVE=1`（またはプロバイダー固有の `*_LIVE_TEST=1`）が必要です。 スキップを解除するにはAPIキーと`LIVE=1`（またはプロバイダ固有の`*_LIVE_TEST=1`）が必要です。 スキップを解除するにはAPIキーと`LIVE=1`（またはプロバイダ固有の`*_LIVE_TEST=1`）が必要です。

## モデル レイテンシ ベンチ（ローカル キー）

スクリプト: [`scripts/bench-model.ts`](https://github.com/openclaw/openclaw/blob/main/scripts/bench-model.ts)

使用方法:

* `source ~/.profile && pnpm tsx scripts/bench-model.ts --runs 10`
* 任意の環境変数: `MINIMAX_API_KEY`, `MINIMAX_BASE_URL`, `MINIMAX_MODEL`, `ANTHROPIC_API_KEY`
* 既定のプロンプト: 「単語を 1 つだけで返信してください: ok。句読点や余分なテキストは不要です。」 句読点や追加テキストはありません。」 句読点や追加テキストはありません。」

最終実行（2025-12-31、20 回）:

* minimax 中央値 1279ms（最小 1114、最大 2431）
* opus 中央値 2454ms（最小 1224、最大 3170）

## オンボーディング E2E（Docker）

Docker は任意です。これは、コンテナ化されたオンボーディング スモークテストにのみ必要です。

クリーンな Linux コンテナでの完全なコールドスタート フロー:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
scripts/e2e/onboard-docker.sh
```

このスクリプトは疑似 tty を介して対話型ウィザードを駆動し、設定／ワークスペース／セッション ファイルを検証した後、ゲートウェイを起動して `openclaw health` を実行します。

## QR インポート スモーク（Docker）

Docker 内の Node 22+ で `qrcode-terminal` が読み込まれることを確認します:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm test:docker:qr
```
