OpenClaw 集成 Codex CLI：原生线程支持的编程 Agent

2026-04-12 · 7 分钟模型接入

概述

OpenClaw v2026.4.10 内置了 Codex Provider，与 OpenAI 的 Codex CLI 深度集成：

原生线程支持：复用 Codex 的对话线程能力
会话继承：Codex CLI 会话正确继承 OpenClaw 的系统提示
统一管理：通过 OpenClaw 网关统一管理 Codex 配置

这意味着你可以在 OpenClaw 中用 Codex 处理编程任务，同时享受 Codex 的优化和 OpenClaw 的频道集成、记忆系统等能力。

前置要求

OpenClaw v2026.4.10 或更高版本
OpenAI API Key（支持 Codex 的账户）
Codex CLI（推荐安装最新版）

安装 Codex CLI

# 通过 npm 安装
npm install -g @openai/codex

# 或通过 brew (macOS)
brew install codex

# 验证
codex --version

配置 Codex Provider

基础配置

# config.yaml
providers:
  codex:
    enabled: true
    apiKey: "$OPENAI_API_KEY"

OpenClaw 会自动检测系统中的 Codex CLI。

指定 Codex CLI 路径

如果有多个 Codex 安装：

providers:
  codex:
    enabled: true
    apiKey: "$OPENAI_API_KEY"
    cliPath: "/usr/local/bin/codex"

模型选择

providers:
  codex:
    enabled: true
    apiKey: "$OPENAI_API_KEY"
    defaultModel: "codex-1"  # 或其他可用模型

启用 Codex Agent

在 Agent 配置中将 Codex 设为某个 Agent 的 Provider：

agents:
  coder:
    provider: "codex"
    model: "codex-1"
    systemPrompt: "你是一个专业的编程助手"
    tools:
      - read
      - write
      - edit
      - exec

原生线程支持

Codex 的核心能力之一是对话线程——可以在长时间编程任务中保持上下文：

# 通过 OpenClaw 启动 Codex 线程
openclaw chat --agent coder --thread "feature-auth"

# 后续可以恢复线程
openclaw chat --agent coder --thread "feature-auth" --resume

线程的优势：

跨会话连续性：今天讨论的设计，明天可以继续
完整代码上下文：Codex 记得整个开发过程
高效压缩：Codex 自动压缩历史保持 Token 效率

系统提示继承

v2026.4.10 修复了 Codex CLI 会话不继承 OpenClaw 系统提示的问题：

# config.yaml
agents:
  coder:
    provider: "codex"
    systemPrompt: |
      你是一个全栈工程师，遵循以下规范：
      - 使用 TypeScript
      - 优先函数式编程
      - 完整的错误处理
      - 包含测试用例

启动 Codex 会话时，这段系统提示会正确传递给 Codex CLI，确保行为一致。

实际工作流

工作流 1：完整功能开发

用户：实现用户认证功能，包括注册、登录、密码重置

[OpenClaw 路由到 Codex Agent]
[启动 Codex 线程：feature-auth]

Codex：好的，我会按以下步骤实现：
       1. 设计数据模型
       2. 实现 API 端点
       3. 添加单元测试
       [开始编写代码...]

[Codex 线程持续工作，可能数小时]

[完成后]
Codex：功能完成，所有测试通过。
       生成 PR：feature/auth #123

工作流 2：代码审查

用户：审查这个 PR：https://github.com/xxx/xxx/pull/456

[OpenClaw 路由到 Codex Agent]
[Codex 调用 GitHub Skill 获取 PR 内容]
[Codex 进行深度代码审查]

Codex：审查完成，发现 3 个问题：
       1. [severity: high] SQL 注入风险...
       2. [severity: medium] 缺少错误处理...
       3. [severity: low] 命名规范不一致...

工作流 3：复杂调试

用户：生产环境出现间歇性 500 错误，帮我调试

[OpenClaw 路由到 Codex Agent]
[启动调试线程：debug-prod-500]

Codex：开始调试，请提供日志访问权限。
       [Codex 通过 SSH Skill 连接服务器]
       [分析日志、堆栈跟踪]
       [复现问题]
       
       根本原因：连接池耗尽
       修复方案：[代码 patch]

与其他 Provider 协同

可以让 Codex 与其他 Provider 分工协作：

agents:
  # Codex 负责编程
  coder:
    provider: "codex"
    
  # Claude 负责架构设计和文档
  architect:
    provider: "anthropic"
    model: "claude-opus-4-6"
    
  # Qwen 负责中文用户交互
  ui:
    provider: "qwen"
    model: "qwen3.6-plus"

通过 Subagents 机制让它们协同：

agents:
  coder:
    provider: "codex"
    delegateTo:
      - architect  # 复杂架构问题委托给 Claude
      - ui         # 中文文档交给 Qwen

成本考虑

Codex 通常按 Token 计费，编程任务 Token 消耗较大：

代码生成：每千行代码可能消耗 3-5K Token
代码审查：阅读代码 + 反馈，1-2K Token/PR
调试：可能多轮交互，5-20K Token

建议：

简单任务用 GPT-5-nano 等轻量模型
复杂任务用 Codex
配合 Active Memory 减少上下文重复

注意事项

Codex Provider 需要 OpenClaw v2026.4.10 或更高版本
需要 OpenAI 账户开通 Codex 访问
Codex 线程会占用本地存储，定期清理
系统提示继承在 v2026.4.10 修复，旧版本可能行为异常
Codex CLI 升级后建议同步更新 OpenClaw 配置
编程任务建议配合代码沙箱使用，防止 Codex 误操作生产环境