Codex CLI

将 OpenAI Codex CLI 连接到 CoreClaw MCP 服务，让您可以直接从终端对话中发现 CoreClaw Worker、运行任务、查询状态并获取结果。

前提条件

已安装 Codex CLI（npm install -g @openai/codex）
CoreClaw 账户及 API 密钥，可在控制台 -> 设置 -> API & 集成获取

配置步骤

Codex CLI 通过 Streamable HTTP 传输协议支持 MCP。您可以通过 JSON 配置文件进行配置。

步骤 1：创建或编辑 MCP 配置文件

在项目目录或您偏好的配置位置创建 codex-mcp.json：

{
  "mcpServers": {
    "coreclaw": {
      "url": "https://mcp.coreclaw.com/mcp",
      "headers": {
        "api-key": "YOUR_CORECLAW_API_KEY"
      }
    }
  }
}

将 YOUR_CORECLAW_API_KEY 替换为您的实际 CoreClaw API 密钥。

步骤 2：使用 MCP 配置启动 Codex

codex --mcp-config codex-mcp.json

如果您的 Codex 安装会自动读取配置，也可以将配置放在 macOS/Linux 的 ~/.config/codex/mcp.json 或 Windows 的 %APPDATA%\codex\mcp.json。

验证连接

使用 MCP 配置启动 Codex。
询问 Codex：“在 CoreClaw 上查找 Amazon Worker。”
Codex 应该调用 list_store_workers 并返回匹配的 Worker。

对话示例

您：找个 Google Maps Worker，提取纽约时代广场附近的餐厅数据。

Codex： 我会查找 Google Maps Worker，查看输入 schema，然后为您运行。[调用 list_store_workers -> get_worker_input_schema -> run_worker -> get_worker_run -> list_worker_run_results]

常用工具流程

使用 list_store_workers 查找公开 Store Worker。
运行前使用 get_worker_input_schema 查看输入字段。
使用 run_worker 和 input_json 发起临时运行。
使用 get_worker_run 轮询运行状态。
运行后使用 list_worker_run_results、export_worker_run_results 或 get_worker_run_log。

故障排除

MCP 配置未加载

使用 --mcp-config 时确认 JSON 文件路径正确。
确认 JSON 格式有效。
配置变更后重启 Codex 会话。

认证错误

确认 api-key 请求头的值与 CoreClaw API 密钥完全匹配。
托管 MCP 服务也支持 X-API-Key 和 Authorization: Bearer YOUR_CORECLAW_API_KEY。
在控制台验证密钥是否有效。

工具不可用

确认 Codex CLI 支持 Streamable HTTP MCP。
查看 Codex 会话日志中的 MCP 连接错误。