跳转至

CLI 后端和 APNs 通道

实时:CLI 后端冒烟测试(Claude、Gemini 或其他本地 CLI)

  • 测试:src/gateway/gateway-cli-backend.live.test.ts
  • 目标:使用本地 CLI 后端验证 Gateway + agent 流水线,且不修改你的默认配置。
  • 特定后端的冒烟默认值位于所属插件的 cli-backend.ts 定义中。
  • 启用:
  • pnpm test:live(如果直接调用 Vitest,则使用 OPENCLAW_LIVE_TEST=1)
  • OPENCLAW_LIVE_CLI_BACKEND=1
  • 默认值:
  • 默认提供方/模型:claude-cli/claude-sonnet-4-6
  • 命令/参数/图像行为来自所属 CLI 后端插件的元数据。
  • 覆盖项(可选):
  • 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 用于发送真实图像附件(路径会被注入到 prompt 中)。在 Docker 配方中默认关闭。
  • OPENCLAW_LIVE_CLI_BACKEND_IMAGE_ARG="--image" 用于将图像文件路径作为 CLI 参数传递,而不是注入 prompt。
  • OPENCLAW_LIVE_CLI_BACKEND_IMAGE_MODE="repeat"(或 "list")用于在设置 IMAGE_ARG 时控制图像参数的传递方式。
  • OPENCLAW_LIVE_CLI_BACKEND_RESUME_PROBE=1 用于发送第二轮并验证恢复流程。
  • OPENCLAW_LIVE_CLI_BACKEND_CACHE_PROBE=1 用于运行一次全新的 Claude CLI 轮次、一次带工具的预热恢复和一次无工具的稳定恢复,然后要求随后的脏工作区恢复至少达到 90% 的 prompt 缓存复用。它还会验证思考级别变化会轮换实时会话代际,并且下一次稳定恢复能恢复至少 90% 的复用。该检查会禁用图像、MCP 和模型切换检查。
  • 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 格式,并且可以连接到本地 streamable-HTTP MCP 服务器。

Docker 配方:

pnpm test:docker:live-cli-backend

单提供方 Docker 配方:

pnpm test:docker:live-cli-backend:claude
pnpm test:docker:live-cli-backend:claude:cache
pnpm test:docker:live-cli-backend:claude-subscription
pnpm test:docker:live-cli-backend:gemini

备注:

  • Docker 运行器位于 scripts/test-live-cli-backend-docker.sh。
  • pnpm test:docker:live-cli-backend:claude:cache 需要 Anthropic API 密钥认证。它会记录每次缓存检查恢复的规范化缓存使用情况,并要求稳定后的脏工作区恢复以及思考级别变化后的稳定恢复均至少达到 90% 的复用。
  • 它以非 root node 用户身份在仓库 Docker 镜像内运行实时 CLI 后端冒烟测试。
  • 它会从所属插件解析 CLI 冒烟元数据,然后将匹配的 Linux CLI 包(@anthropic-ai/claude-code 或 @google/gemini-cli)安装到 OPENCLAW_DOCKER_CLI_TOOLS_DIR 处的缓存可写前缀中(默认:~/.cache/openclaw/docker-cli-tools)。
  • codex-cli 不再是捆绑的 CLI 后端;请改用 openai/* 配合 Codex app-server 运行时(参见 实时:Codex app-server 测试框架冒烟测试)。
  • 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 密钥环境变量的情况下运行两轮 Gateway CLI 后端。该订阅通道默认禁用 Claude MCP/工具和图像检查,因为它会消耗已登录订阅的使用限额,并且 Anthropic 可以在不发布 OpenClaw 的情况下更改 Claude Agent SDK / claude -p 的计费和速率限制行为。
  • Claude 和 Gemini 通过上述标志支持相同的检查集(文本轮次、图像分类、MCP automations 工具调用、模型切换连续性),但这些检查默认均不运行 - 按需按标志选择加入。

实时:APNs HTTP/2 代理可达性

  • 测试:src/infra/push-apns-http2.live.test.ts
  • 目标:通过本地 HTTP CONNECT 代理隧道连接到 Apple 的沙盒 APNs 端点,发送 APNs HTTP/2 验证请求,并断言 Apple 真实的 403 InvalidProviderToken 响应通过代理路径返回。
  • 启用:
  • 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

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw