測試：即時測試套件

若要瞭解快速入門、QA 執行器、單元／整合測試套件及 Docker 流程，請參閱 測試。本頁涵蓋會實際連線（存取網路）的測試： 模型矩陣、命令列介面後端、ACP、媒體供應商及憑證處理。

實際連線：本機冒煙測試命令

執行臨時實際連線檢查前，請在程序環境中匯出所需的供應商金鑰。

安全的媒體冒煙測試：

pnpm openclaw infer tts convert --local --json \  --text "OpenClaw live smoke." \  --output /tmp/openclaw-live-smoke.mp3

安全的語音通話就緒狀態冒煙測試：

pnpm openclaw voicecall setup --jsonpnpm openclaw voicecall smoke --to "+15555550123"

除非同時提供 --yes，否則 voicecall smoke 僅會進行模擬執行；只有在您確實要撥打真實電話時才使用 --yes。對 Twilio、Telnyx 及 Plivo 而言，成功的就緒狀態檢查需要公開的網路鉤子 URL；本機／私人迴路 URL 會遭拒絕，因為這些供應商無法存取它們。

實際連線：Android 節點能力全面測試

• 測試：src/gateway/android-node.capabilities.live.test.ts
• 指令碼：pnpm android:test:integration
• 目標：叫用已連線 Android 節點目前公告的每個命令，並斷言命令契約行為。
• 範圍：
  • 需要預先完成／手動設定（此測試套件不會安裝、執行或配對應用程式）。
  • 針對所選 Android 節點，逐一驗證各命令的閘道 node.invoke。
• 必要的預先設定：
  • Android 應用程式已連線並與閘道配對。
  • 應用程式保持在前景。
  • 已針對預期通過的能力授予權限／擷取同意。
• 選用的目標覆寫：
  • OPENCLAW_ANDROID_NODE_ID 或 OPENCLAW_ANDROID_NODE_NAME。
  • OPENCLAW_ANDROID_GATEWAY_URL / OPENCLAW_ANDROID_GATEWAY_TOKEN / OPENCLAW_ANDROID_GATEWAY_PASSWORD。
• 完整的 Android 設定詳細資訊：Android 應用程式

實際連線：模型冒煙測試（設定檔金鑰）

實際連線模型測試分為兩層，以便隔離失敗原因：

• 「直接模型」可確認供應商／模型是否能使用指定金鑰產生任何回應。
• 「閘道冒煙測試」可確認該模型的完整閘道＋代理程式管線是否正常運作（工作階段、歷程記錄、工具、沙箱政策等）。

以下精選模型清單位於 src/agents/live-model-filter.ts，且會隨時間變動；請將其中的陣列視為事實來源，而非本頁。

MiniMax M3 使用 minimax/MiniMax-M3 作為預設的供應商／模型參照。

第 1 層：直接完成模型要求（不使用閘道）

• 測試：src/agents/models.profiles.live.test.ts
• 目標：
  • 列舉探索到的模型
  • 使用 getApiKeyForModel 選取您擁有憑證的模型
  • 對每個模型執行小型完成要求（並視需要執行針對性迴歸測試）
• 啟用方式：
  • pnpm test:live（若直接叫用 Vitest，則使用 OPENCLAW_LIVE_TEST=1）
  • 將 OPENCLAW_LIVE_MODELS 設為 modern、small 或 all（modern 的別名），才能實際執行此測試套件；否則會略過，因此單獨執行 pnpm test:live 時，仍會聚焦於閘道冒煙測試。
• 選取模型的方式：
  • OPENCLAW_LIVE_MODELS=modern 會執行精選的高訊號優先清單（請參閱實際連線：模型矩陣）
  • OPENCLAW_LIVE_MODELS=small 會執行精選的小型模型優先清單
  • OPENCLAW_LIVE_MODELS=all 是 modern 的別名
  • 或使用 OPENCLAW_LIVE_MODELS="openai/gpt-5.6-luna,anthropic/claude-opus-4-6,..."（逗號分隔的允許清單）
  • 本機 Ollama 小型模型預設使用 http://127.0.0.1:11434；僅針對區域網路、自訂或 Ollama Cloud 端點設定 OPENCLAW_LIVE_OLLAMA_BASE_URL。
  • modern／all 及 small 全面測試預設以各自精選清單的長度為上限；設定 OPENCLAW_LIVE_MAX_MODELS=0 可完整測試所有選定設定檔，或設定正整數以採用較小的上限。
  • 完整全面測試使用 OPENCLAW_LIVE_TEST_TIMEOUT_MS 作為整個直接模型測試的逾時時間。預設值：60 分鐘。
  • 直接模型探測預設以 20 路平行處理執行；可設定 OPENCLAW_LIVE_MODEL_CONCURRENCY 來覆寫。
• 選取供應商的方式：
  • OPENCLAW_LIVE_PROVIDERS="google,google-antigravity,google-gemini-cli"（逗號分隔的允許清單）
• 金鑰來源：
  • 預設：設定檔儲存區及環境後援值
  • 設定 OPENCLAW_LIVE_REQUIRE_PROFILE_KEYS=1，強制僅使用設定檔儲存區
• 存在原因：
  • 將「供應商 API 損壞／金鑰無效」與「閘道代理程式管線損壞」區分開來
  • 包含小型且獨立的迴歸測試（例如：OpenAI Responses／Codex Responses 推理重播＋工具呼叫流程）

第 2 層：閘道＋開發代理程式冒煙測試（「@openclaw」實際執行的內容）

• 測試：src/gateway/gateway-models.profiles.live.test.ts
• 目標：
  • 啟動程序內閘道
  • 建立／修補 agent:dev:* 工作階段（每次執行覆寫模型）
  • 逐一測試具有金鑰的模型，並斷言：
    • 「有意義的」回應（不使用工具）
    • 真實工具叫用可正常運作（讀取探測）
    • 選用的額外工具探測（執行＋讀取探測）
    • OpenAI 迴歸路徑（僅工具呼叫 -> 後續回應）持續正常運作
• 探測詳細資訊（讓您能快速解釋失敗原因）：
  • read 探測：測試會在工作區中寫入一個 nonce 檔案，要求代理程式使用 read 讀取該檔案，並回傳 nonce。
  • exec+read 探測：測試會要求代理程式使用 exec 將 nonce 寫入暫存檔案，再使用 read 讀回。
  • 影像探測：測試會附加產生的 PNG（貓＋隨機代碼），並預期模型傳回 cat <CODE>。
  • 實作參照：src/gateway/gateway-models.profiles.live.test.ts 及 test/helpers/live-image-probe.ts。
• 啟用方式：
  • pnpm test:live（若直接叫用 Vitest，則使用 OPENCLAW_LIVE_TEST=1）
• 選取模型的方式：
  • 預設：精選的高訊號（modern）優先清單
  • OPENCLAW_LIVE_GATEWAY_MODELS=small 會透過完整的閘道＋代理程式管線執行精選的小型模型清單
  • OPENCLAW_LIVE_GATEWAY_MODELS=all 是 modern 的別名
  • 或設定 OPENCLAW_LIVE_GATEWAY_MODELS="provider/model"（或逗號分隔的清單）來縮小範圍
  • modern／all 及 small 閘道全面測試預設以各自精選清單的長度為上限；設定 OPENCLAW_LIVE_GATEWAY_MAX_MODELS=0 可完整測試所有選定項目，或設定正整數以採用較小的上限。
• 選取供應商的方式（避免「全部都使用 OpenRouter」）：
  • OPENCLAW_LIVE_GATEWAY_PROVIDERS="google,google-antigravity,google-gemini-cli,openai,anthropic,zai,minimax"（逗號分隔的允許清單）
• 此實際連線測試一律啟用工具＋影像探測：
  • read 探測＋exec+read 探測（工具壓力測試）
  • 模型公告支援影像輸入時會執行影像探測
  • 流程（概要）：
    • 測試產生包含「CAT」＋隨機代碼的小型 PNG（test/helpers/live-image-probe.ts）
    • 透過 agent 的 attachments: [{ mimeType: "image/png", content: "<base64>" }] 傳送
    • 閘道將附件剖析為 images[]（src/gateway/server-methods/agent.ts＋src/gateway/chat-attachments.ts）
    • 內嵌代理程式將多模態使用者訊息轉送給模型
    • 斷言：回覆包含 cat＋該代碼（OCR 容錯：允許少量錯誤）

實際連線：命令列介面後端冒煙測試（Claude、Gemini 或其他本機命令列介面）

• 測試：src/gateway/gateway-cli-backend.live.test.ts
• 目標：使用本機命令列介面後端驗證閘道＋代理程式管線，而不變更您的預設設定。
• 各後端專屬的冒煙測試預設值，位於其所屬外掛的 cli-backend.ts 定義中。
• 啟用：
  • pnpm test:live（若直接叫用 Vitest，則使用 OPENCLAW_LIVE_TEST=1）
  • OPENCLAW_LIVE_CLI_BACKEND=1
• 預設值：
  • 預設供應商／模型：claude-cli/claude-sonnet-4-6
  • 命令／引數／影像行為來自所屬命令列介面後端外掛的中繼資料。
• 覆寫（選用）：
  • OPENCLAW_LIVE_CLI_BACKEND_MODEL="claude-cli/claude-sonnet-4-6"
  • OPENCLAW_LIVE_CLI_BACKEND_COMMAND="/full/path/to/claude"
  • OPENCLAW_LIVE_CLI_BACKEND_ARGS='["-p","--output-format","json"]'
  • OPENCLAW_LIVE_CLI_BACKEND_IMAGE_PROBE=1 可傳送真實影像附件（路徑會注入提示詞）。Docker 配方預設關閉。
  • OPENCLAW_LIVE_CLI_BACKEND_IMAGE_ARG="--image" 可將影像檔案路徑作為命令列介面引數傳遞，而非注入提示詞。
  • OPENCLAW_LIVE_CLI_BACKEND_IMAGE_MODE="repeat"（或 "list"）可在設定 IMAGE_ARG 時控制影像引數的傳遞方式。
  • OPENCLAW_LIVE_CLI_BACKEND_RESUME_PROBE=1 可傳送第二輪對話並驗證恢復流程。
  • OPENCLAW_LIVE_CLI_BACKEND_MODEL_SWITCH_PROBE=1 可在所選模型支援切換目標時，選擇加入 Claude Sonnet -> Opus 同一工作階段的連續性探測。預設關閉，Docker 配方亦同。
  • OPENCLAW_LIVE_CLI_BACKEND_MCP_PROBE=1 可選擇加入 MCP／工具迴路探測。Docker 配方預設關閉。

範例：

  OPENCLAW_LIVE_CLI_BACKEND=1 \  OPENCLAW_LIVE_CLI_BACKEND_MODEL="claude-cli/claude-sonnet-4-6" \  pnpm test:live src/gateway/gateway-cli-backend.live.test.ts

低成本的 Gemini MCP 設定冒煙測試：

OPENCLAW_LIVE_TEST=1 \  pnpm test:live src/agents/cli-runner/bundle-mcp.gemini.live.test.ts

此測試不會要求 Gemini 產生回應。它會寫入 OpenClaw 提供給 Gemini 的相同系統設定，接著執行 gemini --debug mcp list，以證明已儲存的 transport: "streamable-http" 伺服器會正規化為 Gemini 的 HTTP MCP 形狀，且可連線至本機可串流 HTTP MCP 伺服器。

Docker 配方：

pnpm test:docker:live-cli-backend

單一供應商 Docker 配方：

pnpm test:docker:live-cli-backend:claudepnpm test:docker:live-cli-backend:claude-subscriptionpnpm test:docker:live-cli-backend:gemini

注意事項：

• Docker 執行器位於 scripts/test-live-cli-backend-docker.sh。
• 它會在儲存庫 Docker 映像中，以非 root 的 node 使用者身分執行實際連線命令列介面後端冒煙測試。
• 它會從所屬外掛解析命令列介面冒煙測試中繼資料，接著將相符的 Linux 命令列介面套件（@anthropic-ai/claude-code 或 @google/gemini-cli）安裝至 OPENCLAW_DOCKER_CLI_TOOLS_DIR 中可寫入且具有快取的前置路徑（預設：~/.cache/openclaw/docker-cli-tools）。
• codex-cli 已不再是內建命令列介面後端；請改用 openai/* 搭配 Codex 應用程式伺服器執行階段（請參閱實際連線：Codex 應用程式伺服器測試架構冒煙測試）。
• pnpm test:docker:live-cli-backend:claude-subscription 需要可攜式 Claude Code 訂閱 OAuth，可透過含有 claudeAiOauth.subscriptionType 的 ~/.claude/.credentials.json，或由 claude setup-token 取得的 CLAUDE_CODE_OAUTH_TOKEN 提供。它會先在 Docker 中驗證直接執行 claude -p，再執行兩輪閘道命令列介面後端對話，且不保留 Anthropic API 金鑰環境變數。此訂閱測試通道預設停用 Claude MCP／工具及影像探測，因為它會消耗已登入訂閱的使用額度，且 Anthropic 可能在 OpenClaw 未發行新版本的情況下，變更 Claude Agent SDK／claude -p 的計費與速率限制行為。
• Claude 與 Gemini 可透過上述旗標支援相同的探測組合（文字對話、影像分類、MCP cron 工具呼叫、模型切換連續性），但這些探測預設皆不執行；請依需要透過各旗標選擇加入。

實際連線：APNs HTTP/2 Proxy 可達性

• 測試：src/infra/push-apns-http2.live.test.ts
• 目標：透過本機 HTTP CONNECT Proxy 建立通往 Apple 沙箱 APNs 端點的通道、傳送 APNs HTTP/2 驗證要求，並斷言 Apple 真實的 403 InvalidProviderToken 回應會透過 Proxy 路徑傳回。
• 啟用：
  • OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_APNS_REACHABILITY=1 pnpm test:live src/infra/push-apns-http2.live.test.ts
• 選用的逾時設定：
  • OPENCLAW_LIVE_APNS_TIMEOUT_MS=30000

實際連線：ACP 繫結冒煙測試（/acp spawn ... --bind here）

• 測試：src/gateway/gateway-acp-bind.live.test.ts
• 目標：使用即時 ACP 代理程式驗證真實的 ACP 對話綁定流程：
  • 傳送 /acp spawn <agent> --bind here
  • 就地綁定模擬的訊息頻道對話
  • 在同一對話中傳送一般的後續訊息
  • 驗證後續訊息已寫入綁定的 ACP 工作階段逐字記錄
• 啟用：
  • pnpm test:live src/gateway/gateway-acp-bind.live.test.ts
  • OPENCLAW_LIVE_ACP_BIND=1
• 預設值：
  • Docker 中的 ACP 代理程式：claude,codex,gemini
  • 直接執行 pnpm test:live ... 時的 ACP 代理程式：claude
  • 模擬頻道：Slack 私訊形式的對話情境
  • ACP 後端：acpx
• 覆寫：
  • OPENCLAW_LIVE_ACP_BIND_AGENT=claude
  • OPENCLAW_LIVE_ACP_BIND_AGENT=codex
  • OPENCLAW_LIVE_ACP_BIND_AGENT=droid
  • OPENCLAW_LIVE_ACP_BIND_AGENT=gemini
  • OPENCLAW_LIVE_ACP_BIND_AGENT=opencode
  • OPENCLAW_LIVE_ACP_BIND_AGENTS=claude,codex,gemini
  • OPENCLAW_LIVE_ACP_BIND_AGENT_COMMAND='npx -y @agentclientprotocol/claude-agent-acp@<version>'
  • OPENCLAW_LIVE_ACP_BIND_CODEX_MODEL=gpt-5.6-luna
  • OPENCLAW_LIVE_ACP_BIND_OPENCODE_MODEL=opencode/kimi-k2.6
  • OPENCLAW_LIVE_ACP_BIND_IMAGE_PROBE=1（或 on/true/yes）可強制開啟影像探查；任何其他值都會強制關閉。除 opencode 外，所有代理程式預設都會執行。
  • OPENCLAW_LIVE_ACP_BIND_REQUIRE_CRON=1
  • OPENCLAW_LIVE_ACP_BIND_PARENT_MODEL=openai/gpt-5.6-luna
• 注意事項：
  • 此測試通道使用閘道的 chat.send 介面，並搭配僅限管理員使用的模擬來源路由欄位，讓測試能附加訊息頻道情境，而無須假裝對外傳送。
  • 未設定 OPENCLAW_LIVE_ACP_BIND_AGENT_COMMAND 時，測試會使用內嵌 acpx 外掛的內建代理程式登錄檔，選取 ACP 測試框架代理程式。
  • 綁定工作階段的排程 MCP 建立作業預設採盡力而為，因為外部 ACP 測試框架可能會在綁定／影像驗證通過後取消 MCP 呼叫；設定 OPENCLAW_LIVE_ACP_BIND_REQUIRE_CRON=1 可嚴格要求綁定後的排程探查。

範例：

OPENCLAW_LIVE_ACP_BIND=1 \  OPENCLAW_LIVE_ACP_BIND_AGENT=claude \  pnpm test:live src/gateway/gateway-acp-bind.live.test.ts

Docker 操作方式：

pnpm test:docker:live-acp-bind

單一代理程式 Docker 操作方式：

pnpm test:docker:live-acp-bind:claudepnpm test:docker:live-acp-bind:codexpnpm test:docker:live-acp-bind:droidpnpm test:docker:live-acp-bind:geminipnpm test:docker:live-acp-bind:opencode

Docker 注意事項：

• Docker 執行器位於 scripts/test-live-acp-bind-docker.sh。
• 預設會依序對彙總的即時命令列介面代理程式執行 ACP 綁定冒煙測試：claude、codex，然後是 gemini。
• 使用 OPENCLAW_LIVE_ACP_BIND_AGENTS=claude、OPENCLAW_LIVE_ACP_BIND_AGENTS=codex、OPENCLAW_LIVE_ACP_BIND_AGENTS=droid、OPENCLAW_LIVE_ACP_BIND_AGENTS=gemini 或 OPENCLAW_LIVE_ACP_BIND_AGENTS=opencode 縮小矩陣範圍。
• 它會將相符的命令列介面驗證資料暫存至容器中，然後在缺少時安裝所要求的即時命令列介面（@anthropic-ai/claude-code、@openai/codex、透過 https://app.factory.ai/cli 安裝的 Factory Droid、@google/gemini-cli 或 opencode-ai）。ACP 後端本身是官方 acpx 外掛內嵌的 acpx/runtime 套件。
• Droid Docker 變體會暫存 ~/.factory 設定、轉送 FACTORY_API_KEY，並要求提供該 API 金鑰，因為本機 Factory OAuth／鑰匙圈驗證無法移植至容器。它使用 ACPX 內建的 droid exec --output-format acp 登錄項目。
• OpenCode Docker 變體是嚴格的單一代理程式回歸測試通道。它會依據 OPENCLAW_LIVE_ACP_BIND_OPENCODE_MODEL（預設為 opencode/kimi-k2.6）寫入暫時的 OPENCODE_CONFIG_CONTENT 預設模型。
• 直接呼叫 acpx 命令列介面，只是用來比較閘道之外行為的手動／因應措施路徑。Docker ACP 綁定冒煙測試會運用 OpenClaw 內嵌的 acpx 執行階段後端。

即時：Codex 應用程式伺服器測試框架冒煙測試

• 目標：透過一般閘道 agent 方法驗證外掛自有的 Codex 測試框架：
  • 載入隨附的 codex 外掛
  • 透過 /model <ref> --runtime codex 選取 OpenAI 模型
  • 使用所要求的思考層級，傳送第一次閘道代理程式回合
  • 對同一個 OpenClaw 工作階段傳送第二個回合，並驗證應用程式伺服器執行緒可以繼續
  • 透過同一閘道命令路徑執行 /codex status 和 /codex models
  • 選擇性執行兩個經 Guardian 審查的提權 Shell 探查：一個應獲核准的良性命令，以及一個應遭拒絕的偽造祕密上傳，讓代理程式轉而詢問使用者
• 測試：src/gateway/gateway-codex-harness.live.test.ts
• 啟用：OPENCLAW_LIVE_CODEX_HARNESS=1
• 測試框架基準模型：openai/gpt-5.6-luna
• 全新 OpenAI API 金鑰選擇預設值：openai/gpt-5.6
• 預設思考層級：low
• 模型覆寫：OPENCLAW_LIVE_CODEX_HARNESS_MODEL=openai/<model>
• 思考層級覆寫：OPENCLAW_LIVE_CODEX_HARNESS_THINKING=<level>
• 矩陣覆寫：OPENCLAW_LIVE_CODEX_HARNESS_TARGETS=<model>=<thinking>,...
• 驗證模式：OPENCLAW_LIVE_CODEX_HARNESS_AUTH=codex-auth（預設）使用複製的 Codex 登入資料；api-key 則透過 Codex 應用程式伺服器使用 OPENAI_API_KEY。
• 選用的影像探查：OPENCLAW_LIVE_CODEX_HARNESS_IMAGE_PROBE=1
• 選用的 MCP／工具探查：OPENCLAW_LIVE_CODEX_HARNESS_MCP_PROBE=1
• 選用的 Guardian 探查：OPENCLAW_LIVE_CODEX_HARNESS_GUARDIAN_PROBE=1
• 此冒煙測試會強制設定提供者／模型的 agentRuntime.id: "codex"，因此損壞的 Codex 測試框架無法透過無聲回退至 OpenClaw 而通過測試。
• 驗證：使用本機 Codex 訂閱登入提供 Codex 應用程式伺服器驗證；當 OPENCLAW_LIVE_CODEX_HARNESS_AUTH=api-key 時則使用 OPENAI_API_KEY。Docker 可複製 ~/.codex/auth.json 和 ~/.codex/config.toml 以執行訂閱測試。

本機操作方式：

OPENCLAW_LIVE_CODEX_HARNESS=1 \  OPENCLAW_LIVE_CODEX_HARNESS_IMAGE_PROBE=1 \  OPENCLAW_LIVE_CODEX_HARNESS_MCP_PROBE=1 \  OPENCLAW_LIVE_CODEX_HARNESS_GUARDIAN_PROBE=1 \  OPENCLAW_LIVE_CODEX_HARNESS_MODEL=openai/gpt-5.6-luna \  pnpm test:live -- src/gateway/gateway-codex-harness.live.test.ts

Docker 操作方式：

pnpm test:docker:live-codex-harness

GPT-5.6 原生 Codex 矩陣：

OPENCLAW_LIVE_CODEX_HARNESS_AUTH=api-key \  OPENCLAW_LIVE_CODEX_HARNESS_TARGETS='openai/gpt-5.6-sol=ultra,openai/gpt-5.6-terra=ultra,openai/gpt-5.6-luna=max' \  pnpm test:docker:live-codex-harness

全新 OpenAI API 金鑰預設值：

OPENCLAW_LIVE_GATEWAY_OPENAI_API_DEFAULT=1 \  OPENCLAW_LIVE_GATEWAY_PROVIDERS=openai \  OPENCLAW_LIVE_GATEWAY_THINKING=off \  pnpm test:live -- src/gateway/gateway-models.profiles.live.test.ts

此驗證不設定 OPENCLAW_LIVE_GATEWAY_MODELS，而是透過全新初始設定的推論選擇介面解析模型、斷言結果為 openai/gpt-5.6，然後使用解析出的模型執行真實的閘道回合。

GPT-5.6 內嵌 OpenClaw 矩陣：

OPENCLAW_LIVE_GATEWAY_THINKING=ultra \  OPENCLAW_LIVE_GATEWAY_PROVIDERS=openai \  OPENCLAW_LIVE_GATEWAY_MODELS='openai/gpt-5.6-sol,openai/gpt-5.6-terra,openai/gpt-5.6-luna' \  pnpm test:live -- src/gateway/gateway-models.profiles.live.test.ts

Docker 注意事項：

• Docker 執行器位於 scripts/test-live-codex-harness-docker.sh。
• 它會傳遞 OPENAI_API_KEY、在 Codex 命令列介面驗證檔案存在時加以複製、將 @openai/codex 安裝至可寫入且已掛載的 npm 前置目錄、暫存原始碼樹，然後只執行 Codex 測試框架即時測試。
• Docker 預設會啟用影像、MCP／工具和 Guardian 探查。如需縮小除錯執行範圍，請設定 OPENCLAW_LIVE_CODEX_HARNESS_IMAGE_PROBE=0、OPENCLAW_LIVE_CODEX_HARNESS_MCP_PROBE=0 或 OPENCLAW_LIVE_CODEX_HARNESS_GUARDIAN_PROBE=0。
• Docker 使用相同的明確 Codex 執行階段設定，因此舊版別名或 OpenClaw 回退機制無法掩蓋 Codex 測試框架的回歸。
• 矩陣目標會在單一容器中依序執行。Docker 指令碼會依目標數量調整預設的 35 分鐘逾時；任何外層 Shell 或 CI 逾時都必須容許相同的總時間。標準 CI 會將每個 GPT-5.6 目標置於不同的分片。

建議的即時操作方式

範圍較小且明確的允許清單速度最快，也最不容易發生不穩定情況：

• 單一模型，直接執行（不經閘道）：

  • OPENCLAW_LIVE_MODELS="openai/gpt-5.6-luna" pnpm test:live src/agents/models.profiles.live.test.ts

• 小型模型直接執行設定檔：

  • OPENCLAW_LIVE_MODELS=small pnpm test:live src/agents/models.profiles.live.test.ts

• 小型模型閘道設定檔：

  • OPENCLAW_LIVE_GATEWAY_MODELS=small pnpm test:live src/gateway/gateway-models.profiles.live.test.ts

• Ollama Cloud API 冒煙測試：

  • OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_OLLAMA=1 OPENCLAW_LIVE_OLLAMA_BASE_URL=https://ollama.com OPENCLAW_LIVE_OLLAMA_MODEL=glm-5.1:cloud OPENCLAW_LIVE_OLLAMA_WEB_SEARCH=0 pnpm test:live -- extensions/ollama/ollama.live.test.ts

• 單一模型，閘道冒煙測試：

  • OPENCLAW_LIVE_GATEWAY_MODELS="openai/gpt-5.6-luna" pnpm test:live src/gateway/gateway-models.profiles.live.test.ts

• 跨多個提供者的工具呼叫：

  • OPENCLAW_LIVE_GATEWAY_MODELS="openai/gpt-5.6-luna,anthropic/claude-opus-4-6,google/gemini-3.5-flash,deepseek/deepseek-v4-flash,zai/glm-5.1,minimax/MiniMax-M3" pnpm test:live src/gateway/gateway-models.profiles.live.test.ts

• Z.AI Coding Plan GLM-5.2 直接冒煙測試：

  • ZAI_CODING_LIVE_TEST=1 pnpm test:live src/agents/zai.live.test.ts

• Google 重點測試（Gemini API 金鑰 + Antigravity）：

  • Gemini（API 金鑰）：OPENCLAW_LIVE_GATEWAY_MODELS="google/gemini-3.5-flash" pnpm test:live src/gateway/gateway-models.profiles.live.test.ts
  • Antigravity（OAuth）：OPENCLAW_LIVE_GATEWAY_MODELS="google-antigravity/claude-opus-4-6-thinking,google-antigravity/gemini-3-pro-high" pnpm test:live src/gateway/gateway-models.profiles.live.test.ts

• Google 自適應思考冒煙測試（使用私有 QA 命令列介面的 qa manual——需要 OPENCLAW_ENABLE_PRIVATE_QA_CLI=1 和原始碼簽出；請參閱 QA 概觀）：

  • Gemini 3 動態預設值：OPENCLAW_ENABLE_PRIVATE_QA_CLI=1 pnpm openclaw qa manual --provider-mode live-frontier --model google/gemini-3.1-pro-preview --alt-model google/gemini-3.1-pro-preview --message '/think adaptive Reply exactly: GEMINI_ADAPTIVE_OK' --timeout-ms 180000
  • Gemini 2.5 動態預算：OPENCLAW_ENABLE_PRIVATE_QA_CLI=1 pnpm openclaw qa manual --provider-mode live-frontier --model google/gemini-2.5-flash --alt-model google/gemini-2.5-flash --message '/think adaptive Reply exactly: GEMINI25_ADAPTIVE_OK' --timeout-ms 180000

注意事項：

• google/... 使用 Gemini API（API 金鑰）。
• google-antigravity/... 使用 Antigravity OAuth 橋接器（Cloud Code Assist 形式的代理程式端點）。
• google-gemini-cli/... 使用您電腦上的本機 Gemini 命令列介面（具有獨立的驗證方式和工具特性差異）。
• Gemini API 與 Gemini 命令列介面的差異：
  • API：OpenClaw 透過 HTTP 呼叫 Google 託管的 Gemini API（API 金鑰／設定檔驗證）；這是大多數使用者所指的「Gemini」。
  • 命令列介面：OpenClaw 透過 Shell 呼叫本機 gemini 執行檔；它有自己的驗證機制，且行為可能不同（串流／工具支援／版本落差）。

即時：模型矩陣（涵蓋範圍）

即時測試需選擇性啟用，因此沒有固定的「CI 模型清單」。OPENCLAW_LIVE_MODELS=modern／OPENCLAW_LIVE_GATEWAY_MODELS=modern（及其 all 別名）會依照下列優先順序，執行 src/agents/live-model-filter.ts 中 HIGH_SIGNAL_LIVE_MODEL_PRIORITY 的精選優先清單：

精選的小型模型清單（OPENCLAW_LIVE_MODELS=small／OPENCLAW_LIVE_GATEWAY_MODELS=small），取自 SMALL_LIVE_MODEL_PRIORITY：

現代模型清單注意事項：

• codex 和 codex-cli 提供者不包含在預設的現代模型全面測試中（它們涵蓋命令列介面後端／ACP 行為，並已在上方個別測試）。openai/gpt-5.5 本身預設會透過 Codex app-server 測試框架進行路由；請參閱即時：Codex app-server 測試框架冒煙測試。
• fireworks、google、openrouter 和 xai 在現代模型全面測試中，僅執行明確精選的模型 ID（不會自動展開為「此提供者的所有模型」）。
• 在 OPENCLAW_LIVE_GATEWAY_MODELS 中至少加入一個支援影像的模型（Claude／Gemini／OpenAI 系列視覺變體等），以執行影像探測。

使用工具與影像，針對手動挑選的跨提供者模型組合執行閘道冒煙測試：

OPENCLAW_LIVE_GATEWAY_MODELS="openai/gpt-5.6-luna,anthropic/claude-opus-4-6,google/gemini-3.1-pro-preview,google/gemini-3.5-flash,google-antigravity/claude-opus-4-6-thinking,deepseek/deepseek-v4-flash,zai/glm-5.1,minimax/MiniMax-M3" pnpm test:live src/gateway/gateway-models.profiles.live.test.ts

精選清單以外的選用額外涵蓋範圍（建議加入，請選擇一個已啟用且支援「工具」的模型）：

• Mistral：mistral/...
• Cerebras：cerebras/...（如果你有存取權）
• LM Studio：lmstudio/...（本機；工具呼叫取決於 API 模式）

彙整服務／替代閘道

如果你已啟用金鑰，也可以透過以下服務進行測試：

• OpenRouter：openrouter/...（數百個模型；使用 openclaw models scan 尋找支援工具與影像的候選模型）
• OpenCode：Zen 使用 opencode/...，Go 使用 opencode-go/...（透過 OPENCODE_API_KEY／OPENCODE_ZEN_API_KEY 驗證）

你可以加入即時測試矩陣的其他提供者（如果你有憑證／設定）：

• 內建：anthropic、cerebras、github-copilot、google、google-antigravity、google-gemini-cli、google-vertex、groq、mistral、openai、openrouter、opencode、opencode-go、xai、zai
• 透過 models.providers（自訂端點）：minimax（雲端／API），以及任何與 OpenAI／Anthropic 相容的代理伺服器（LM Studio、vLLM、LiteLLM 等）

憑證（切勿提交）

即時測試會以與命令列介面相同的方式探索憑證。實務上的影響如下：

• 如果命令列介面能運作，即時測試應能找到相同的金鑰。

• 如果即時測試顯示「沒有憑證」，請以除錯 openclaw models list／模型選擇的相同方式進行除錯。

• 各代理程式的驗證設定檔：~/.openclaw/agents/<agentId>/agent/auth-profiles.json（即時測試中的「設定檔金鑰」即指此項）

• 設定：~/.openclaw/openclaw.json（或 OPENCLAW_CONFIG_PATH）

• 舊版 OAuth 目錄：~/.openclaw/credentials/（若存在，會複製到暫存的即時測試主目錄，但不是主要的設定檔金鑰儲存區）

• 本機即時測試會將作用中的設定（移除 agents.*.workspace／agentDir 覆寫）及每個代理程式的 auth-profiles.json 複製到暫存測試主目錄；不會複製該代理程式目錄中的其餘內容，因此 workspace/ 和 sandboxes/ 資料絕不會進入暫存主目錄。此外也會複製舊版 credentials/ 目錄，以及支援的外部命令列介面驗證檔案／目錄（.claude.json、.claude/.credentials.json、.claude/settings*.json、.claude/backups、.codex/auth.json、.codex/config.toml、.gemini、.minimax）。

如果你想依賴環境變數金鑰，請在本機測試前匯出它們，或使用 下方的 Docker 執行器並明確指定 OPENCLAW_PROFILE_FILE。

Deepgram 即時測試（音訊轉錄）

• 測試：extensions/deepgram/audio.live.test.ts
• 啟用：DEEPGRAM_API_KEY=... DEEPGRAM_LIVE_TEST=1 pnpm test:live extensions/deepgram/audio.live.test.ts

BytePlus 程式設計方案即時測試

• 測試：extensions/byteplus/live.test.ts
• 啟用：BYTEPLUS_API_KEY=... BYTEPLUS_LIVE_TEST=1 pnpm test:live extensions/byteplus/live.test.ts
• 選用的模型覆寫：BYTEPLUS_CODING_MODEL=ark-code-latest

ComfyUI 工作流程媒體即時測試

• 測試：extensions/comfy/comfy.live.test.ts
• 啟用：OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts
• 範圍：
  • 執行隨附的 comfy 影像、影片及 music_generate 路徑
  • 除非已設定 plugins.entries.comfy.config.<capability>，否則略過各項功能
  • 適合在變更 comfy 工作流程提交、輪詢、下載或外掛註冊後使用

影像生成即時測試

• 測試：test/image-generation.runtime.live.test.ts
• 命令：pnpm test:live test/image-generation.runtime.live.test.ts
• 測試框架：pnpm test:live:media image
• 範圍：
  • 列舉每個已註冊的影像生成提供者外掛
  • 在探測前使用已匯出的提供者環境變數
  • 預設優先使用即時／環境變數 API 金鑰，而非已儲存的驗證設定檔，因此 auth-profiles.json 中過期的測試金鑰不會遮蔽實際的殼層憑證
  • 略過沒有可用驗證／設定檔／模型的提供者
  • 透過共用影像生成執行階段執行每個已設定的提供者：
    • <provider>:generate
    • 當提供者宣告支援編輯時，執行 <provider>:edit
• 目前涵蓋的隨附提供者：
  • deepinfra
  • fal
  • google
  • minimax
  • openai
  • openrouter
  • vydra
  • xai
• 選用的縮小範圍設定：
  • OPENCLAW_LIVE_IMAGE_GENERATION_PROVIDERS="openai,google,openrouter,xai"
  • OPENCLAW_LIVE_IMAGE_GENERATION_PROVIDERS="deepinfra"
  • OPENCLAW_LIVE_IMAGE_GENERATION_MODELS="openai/gpt-image-2,google/gemini-3.1-flash-image-preview,openrouter/google/gemini-3.1-flash-image-preview,xai/grok-imagine-image"
  • OPENCLAW_LIVE_IMAGE_GENERATION_CASES="google:flash-generate,google:pro-edit,openrouter:generate,xai:default-generate,xai:default-edit"
• 選用的驗證行為：
  • 設定 OPENCLAW_LIVE_REQUIRE_PROFILE_KEYS=1，強制使用設定檔儲存區驗證並忽略僅限環境變數的覆寫

對於已發布的命令列介面路徑，請在提供者／執行階段即時測試通過後，加入一項 infer 冒煙測試：

OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_INFER_CLI_TEST=1 pnpm test:live -- test/image-generation.infer-cli.live.test.tsopenclaw infer image providers --jsonopenclaw infer image generate \  --model google/gemini-3.1-flash-image-preview \  --prompt "Minimal flat test image: one blue square on a white background, no text." \  --output ./openclaw-infer-image-smoke.png \  --json

這會涵蓋命令列介面引數剖析、設定／預設代理程式解析、隨附 外掛啟用、共用影像生成執行階段，以及即時提供者 請求。執行階段載入前應已具備外掛相依套件。

音樂生成即時測試

• 測試：extensions/music-generation-providers.live.test.ts
• 啟用：OPENCLAW_LIVE_TEST=1 pnpm test:live -- extensions/music-generation-providers.live.test.ts
• 測試框架：pnpm test:live:media music
• 範圍：
  • 執行共用的隨附音樂生成提供者路徑
  • 目前涵蓋 fal、google、minimax 和 openrouter
  • 在探測前使用已匯出的提供者環境變數
  • 預設優先使用即時／環境變數 API 金鑰，而非已儲存的驗證設定檔，因此 auth-profiles.json 中過期的測試金鑰不會遮蔽實際的殼層憑證
  • 略過沒有可用驗證／設定檔／模型的提供者
  • 在可用時執行兩種已宣告的執行階段模式：
    • 使用僅含提示詞的輸入執行 generate
    • 當提供者宣告 capabilities.edit.enabled 時執行 edit
  • comfy 有其獨立的即時測試檔案，不屬於此共用全面測試
• 選用的縮小範圍設定：
  • OPENCLAW_LIVE_MUSIC_GENERATION_PROVIDERS="google,minimax"
  • OPENCLAW_LIVE_MUSIC_GENERATION_MODELS="google/lyria-3-clip-preview,minimax/music-2.6"
• 選用的驗證行為：
  • 設定 OPENCLAW_LIVE_REQUIRE_PROFILE_KEYS=1，強制使用設定檔儲存區驗證並忽略僅限環境變數的覆寫

影片生成即時測試

• 測試：extensions/video-generation-providers.live.test.ts
• 啟用：OPENCLAW_LIVE_TEST=1 pnpm test:live -- extensions/video-generation-providers.live.test.ts
• 測試框架：pnpm test:live:media video
• 範圍：
  • 跨 alibaba、byteplus、deepinfra、fal、google、minimax、openai、openrouter、pixverse、qwen、runway、together、vydra、xai 測試共用的內建影片生成供應商路徑
  • 預設採用適合發行驗證的冒煙測試路徑：每個供應商提出一次文字轉影片請求、使用一秒長的龍蝦提示詞，並套用 OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS 設定的各供應商作業時間上限（預設為 180000）
  • 預設略過 FAL，因為供應商端的佇列延遲可能占用大部分發行時間；傳入 OPENCLAW_LIVE_VIDEO_GENERATION_PROVIDERS="fal"（或清空略過清單）即可明確執行
  • 探測前會先使用已匯出的供應商環境變數
  • 預設優先使用即時測試／環境變數中的 API 金鑰，而非已儲存的驗證設定檔，因此 auth-profiles.json 中過期的測試金鑰不會遮蔽實際的 shell 憑證
  • 略過沒有可用驗證資訊／設定檔／模型的供應商
  • 預設只執行 generate
  • 設定 OPENCLAW_LIVE_VIDEO_GENERATION_FULL_MODES=1，即可在可用時一併執行已宣告的轉換模式：
    • 當供應商宣告 capabilities.imageToVideo.enabled，且所選供應商／模型在共用掃描測試中接受以緩衝區為基礎的本機圖片輸入時，執行 imageToVideo
    • 當供應商宣告 capabilities.videoToVideo.enabled，且所選供應商／模型在共用掃描測試中接受以緩衝區為基礎的本機影片輸入時，執行 videoToVideo
  • 共用掃描測試中目前已宣告但略過的 imageToVideo 供應商：
    • vydra（此測試通道不支援以緩衝區為基礎的本機圖片輸入）
  • Vydra 供應商專屬涵蓋範圍：
    • OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_VYDRA_VIDEO=1 pnpm test:live -- extensions/vydra/vydra.live.test.ts
    • 該檔案會執行 veo3 文字轉影片，以及使用遠端圖片 URL 測試資料的 kling 圖片轉影片測試通道（可使用 OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL 覆寫預設值）。
  • xAI 供應商專屬涵蓋範圍：
    • OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_XAI_VIDEO=1 pnpm test:live -- extensions/xai/xai.live.test.ts -t "classic Grok Imagine"
    • 經典案例會先生成一張方形本機 PNG 作為第一幀、省略幾何設定、請求一秒長的圖片轉影片短片、輪詢直到完成，並驗證下載的緩衝區。
    • OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_XAI_VIDEO=1 pnpm test:live -- extensions/xai/xai.live.test.ts -t "Grok Imagine Video 1.5"
    • 1.5 案例會生成一張本機 PNG 作為第一幀、請求一秒長的 1080P 圖片轉影片短片、輪詢直到完成，並驗證下載的緩衝區。
  • 目前的 videoToVideo 即時測試涵蓋範圍：
    • 僅當所選模型解析為 gen4_aleph 時執行 runway
  • 共用掃描測試中目前已宣告但略過的 videoToVideo 供應商：
    • alibaba、google、openai、qwen、xai，因為這些路徑目前需要遠端 http(s) 參照 URL，而非以緩衝區為基礎的本機輸入
• 選用的範圍縮減：
  • OPENCLAW_LIVE_VIDEO_GENERATION_PROVIDERS="deepinfra,google,openai,runway"
  • OPENCLAW_LIVE_VIDEO_GENERATION_MODELS="google/veo-3.1-fast-generate-preview,openai/sora-2,runway/gen4_aleph"
  • 設定 OPENCLAW_LIVE_VIDEO_GENERATION_SKIP_PROVIDERS=""，即可在預設掃描測試中納入所有供應商，包括 FAL
  • 設定 OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS=60000，即可降低各供應商的作業時間上限，以執行更積極的冒煙測試
• 選用的驗證行為：
  • 設定 OPENCLAW_LIVE_REQUIRE_PROFILE_KEYS=1，即可強制使用設定檔儲存區中的驗證資訊，並忽略僅由環境變數提供的覆寫值

媒體即時測試框架

• 命令：pnpm test:live:media
• 進入點：test/e2e/qa-lab/media/hosted-media-provider-live.ts；它會針對每個所選測試套件執行 pnpm test:live -- <suite-test-file>，讓心跳偵測與安靜模式的行為和其他 pnpm test:live 執行方式保持一致。
• 用途：
  • 透過單一儲存庫原生進入點，執行共用的圖片、音樂與影片即時測試套件
  • 從 ~/.profile 自動載入缺少的供應商環境變數
  • 預設自動將各測試套件縮減至目前具有可用驗證資訊的供應商
• 旗標：
  • --providers <csv> 為全域供應商篩選條件；--image-providers／--music-providers／--video-providers 可將篩選條件限定於單一測試套件
  • --all-providers 會略過依據驗證資訊進行的自動篩選
  • 當篩選後沒有可執行的供應商時，--allow-empty 會以 0 結束
  • --quiet／--no-quiet 會傳遞給 test:live
• 範例：
  • pnpm test:live:media
  • pnpm test:live:media image video --providers openai,google,minimax
  • pnpm test:live:media video --video-providers openai,runway --all-providers
  • pnpm test:live:media music --quiet

相關內容

• 測試 - 單元、整合、品質保證與 Docker 測試套件