Codex Bridge

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 分钟后超时，并以默认/合理回退策略自动恢复执行。

命令行