首页 / Codex Bridge / Codex Bridge
👁️ 234
👍 124
📅 2026-06-13 收录
🔄 2026-06-13 更新
Codex Bridge

Codex Bridge

🔗 打开网站
📅 Codex Bridge
Skills
🚀 访问网站 📁 查看更多

正文内容

Codex Bridge

将编码任务从 OpenClaw 委托给本地 codex CLI，并以异步方式管理这些任务。
该技能提供一个基于文件的桥接机制，使 OpenClaw 能够：

  • 分发任务
  • 轮询任务状态与最新输出
  • 转达澄清类问题
  • 发送用户回答
  • 收集最终结果

适用场景

  • 编写构建脚本（Python、Bash 等）
  • 在现有项目中实现或重构代码
  • 在后台运行涉及多个文件的较大型编码任务
  • 在保持 OpenClaw 响应性的同时委托编码工作
  • 处理执行过程中可能需要中途澄清的问题

不适用场景

  • 快速的事实性问答或解释类请求
  • OpenClaw 可直接生成的小型代码片段
  • 非编码类任务
  • 不应调用本地编码代理/CLI 的任务

分发任务

~/.openclaw/skills/codex-bridge/codex-bridge-dispatch.sh \
  --task-id  \
  --workdir  \
  --prompt ""

提示词编写建议

请在 prompt 中包含以下要素：

  • 需要构建或修复的内容
  • 已知的文件路径（如有）
  • 期望的行为或输出结果
  • 偏好的编程语言/框架
  • 各类约束条件（例如：需包含测试、代码风格要求、禁止引入新依赖等）

示例：

~/.openclaw/skills/codex-bridge/codex-bridge-dispatch.sh \
  --task-id scripts-csv-parser \
  --workdir ~/projects/data-tools \
  --prompt "Create parse_orders.py. Read orders CSV, keep shipped rows, group by customer_id, and write summary CSV with columns customer_id, order_count, total_amount. Use pandas. Add basic CLI args and error handling."

查看任务状态

~/.openclaw/skills/codex-bridge/codex-bridge-status.sh --task-id

常用状态查询命令：

~/.openclaw/skills/codex-bridge/codex-bridge-status.sh --list
~/.openclaw/skills/codex-bridge/codex-bridge-status.sh --task-id  --output
~/.openclaw/skills/codex-bridge/codex-bridge-status.sh --task-id  --question
~/.openclaw/skills/codex-bridge/codex-bridge-status.sh --task-id  --result
~/.openclaw/skills/codex-bridge/codex-bridge-status.sh --task-id  --log

回答澄清类问题

当任务状态为 waiting_for_answer 时，请先读取待回答的问题，再发送回应：

~/.openclaw/skills/codex-bridge/codex-bridge-status.sh --task-id  --question
~/.openclaw/skills/codex-bridge/codex-bridge-answer.sh --task-id  --answer ""

桥接器会在答案写入后，自动恢复同一 codex 会话继续执行。

典型工作流

  1. 使用清晰明确的 prompt 分发任务。
  2. 向用户报告分配的 task-id。
  3. 定期轮询任务状态与输出（--status / --output）。
  4. 若状态变为 waiting_for_answer，使用 --question 获取问题，转达给用户，并通过 --answer 提交回复。
  5. 当状态变为 complete 时，使用 --result 获取最终结果并汇总产出。
  6. 若状态为 error，请检查 --log 和 --output 进行故障排查。

注意事项与限制

  • 底层调用本地 codex CLI（即 codex exec 与 codex exec resume）。
  • 澄清类问题通过轻量级文本标记协议实现在 prompt 封装器中。
  • 桥接器状态数据存储于 ~/.codex-bridge/tasks// 目录下。
  • 所有命令均在指定的 --workdir 中由 Codex 执行。
  • 对于无人值守运行场景，桥接器将在等待用户回答超过 10 分钟后超时，并以默认/合理回退策略自动恢复执行。