实时测试

如需快速入门、QA 运行器、单元/集成测试套件和 Docker 流程，请参阅 Testing。本页涵盖在线（涉及网络连接）测试：模型矩阵、CLI 后端、ACP、媒体提供方和凭据处理。

本页是一个索引。在线测试工具包按六个页面分别记录，每个页面对应一种读者任务。请打开与你的任务匹配的页面。

在线测试与你的真实网关¶

在线测试套件和临时冒烟测试绝不得干扰已在服务真实流量的网关（无论该网关属于你还是其他运营者）：

• 自带网关：使用进程内网关（在线模型冒烟测试 中的第 2 层），或使用隔离的状态目录（OPENCLAW_STATE_DIR=<scratch>）和空闲端口启动开发实例。当真实网关正在默认网关端口（18789）上运行时，不要绑定该端口。
• 不要对并非本次会话中由你启动的服务执行 openclaw gateway stop/restart（或 launchctl/systemctl/tmux 的等价操作）——那是运营者的在线实例。请先获得明确批准。
• 需要真实数据？将在线状态/数据库复制到你的开发状态目录中，并针对副本进行测试。对在线网关状态进行就地迁移也需要明确批准。

凭据（切勿提交）¶

在线测试发现凭据的方式与 CLI 相同。实际含义如下：

• 如果 CLI 能正常工作，在线测试应能找到相同的密钥。
• 如果在线测试提示"无凭据"，请以调试 openclaw models list / 模型选择的方式排查。

• 无法解析凭据的 OpenClaw 在线测试套件必须在报告器中以 Vitest 测试上下文 skip(reason) 显式跳过，或者直接失败；绝不能未触达提供方就以绿色通过，因为未触达提供方的绿色运行不构成在线证据。

• 每个代理的认证配置文件：~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite 中的 SQLite 凭据行（这就是在线测试中"profile keys"的含义）

• 配置：~/.openclaw/openclaw.json（或 OPENCLAW_CONFIG_PATH）
• 旧版 OAuth 目录：~/.openclaw/credentials/（如存在则会复制到暂存的在线测试主目录中，但它不是主要的 profile-key 存储）
• 本地在线运行会复制当前配置（移除 agents.*.workspace / agentDir 覆盖项），并通过 auth-store 读写 API 暂存每个代理的规范 SQLite 认证凭据/状态行，而不是复制其数据库或其余目录。代理会话、workspace/ 和 sandboxes/ 数据不会被暂存。运行器还会将旧版 credentials/ 目录以及受支持的外部 CLI 认证文件/目录（.claude.json、.claude/.credentials.json、.claude/settings*.json、.claude/backups、.codex/auth.json、.codex/config.toml、.gemini、.minimax）复制到临时测试主目录中。

如果你想依赖环境变量密钥，请在本地测试前导出它们，或使用上述通道页面中的 Docker 运行器并显式指定 OPENCLAW_PROFILE_FILE。

各章节迁移位置¶

此前单页版本中的每个章节标题都在此处保留了其锚点，因此诸如 /help/testing-live#live-codex-app-server-harness-smoke 的现有链接仍可正常解析。每个条目都指向当前承载相应内容的页面。

• 在线：本地冒烟命令
• 在线：Android 节点能力扫描
• 在线：模型冒烟测试（profile keys）
• 第 1 层：直连模型补全（无网关）
• 第 2 层：网关 + 开发代理冒烟测试（"@openclaw" 的实际行为）
• 在线：CLI 后端冒烟测试（Claude、Gemini 或其他本地 CLI）
• 在线：APNs HTTP/2 代理可达性
• 在线：ACP 绑定冒烟测试
• 在线：Codex 应用服务器测试框架冒烟测试
• 在线：OpenAI 长上下文
• 长上下文硬性验证基准
• 推荐的在线测试配方
• 在线：模型矩阵（覆盖范围）
• 聚合器 / 备用网关
• Deepgram 在线测试（音频转写）
• BytePlus 编程套餐在线测试
• ComfyUI 工作流媒体在线测试
• 图像生成在线测试
• 音乐生成在线测试
• 视频生成在线测试
• 媒体在线测试框架

相关¶

• 测试 - 单元测试、集成测试、QA 和 Docker 套件
• 测试 - 测试参考的索引，每个 reader 作业对应一个页面