Codex Hook

Skill: codex-hook v1.0.1

OpenClaw 智能任务执行系统。支持任务拆解、执行、监控、干预、自动 PR 合并。

架构

OpenClaw (编排层) → codex-hook (执行层)
       ↓                    ↓
    拆解任务              并行执行
       ↓                    ↓
    子任务列表            tmux 隔离
       ↓                    ↓
    调用 codex-hook       监控+干预
                           ↓
                        自动合并

依赖

• bash - 执行脚本
• jq - JSON 处理
• tmux - 任务隔离（可选）
• gh - GitHub CLI（自动合并需要）
• codex - Codex CLI
• curl - 发送通知

安装

脚本已位于：~/.openclaw/skills/codex-hook/scripts/

建议添加 alias 到 shell 配置：

# ~/.zshrc 或 ~/.bashrc
alias codex-tasks='bash ~/.openclaw/skills/codex-hook/scripts/codex-tasks.sh'

快速开始

# 1. 初始化
codex-tasks init

# 2. 执行任务（OpenClaw 拆解后调用）
codex-tasks execute parent-login '[{"name":"后端API","description":"实现登录API"},{"name":"前端","description":"实现登录页"}]'

# 3. 查看状态
codex-tasks status

核心文件

~/.openclaw/skills/codex-hook/scripts/
├── codex-tasks.sh       # 统一入口
├── task-registry.sh     # 任务注册表
├── task-dispatcher.sh   # 任务调度器
├── auto-merge.sh       # 自动 PR 创建、CI、检查、合并
├── task-monitor.sh      # 任务监控
└── task-splitter.sh    # 任务拆解（预留）

命令说明

工作流

1. OpenClaw 拆解任务

OpenClaw 负责分析需求，拆分为子任务列表：

[
  {"name": "后端API开发", "description": "实现用户登录API"},
  {"name": "前端页面", "description": "实现登录页面"},
  {"name": "单元测试", "description": "编写登录相关测试"}
]

2. 调用 codex-hook 执行

# 方式一：一次性接收所有子任务
codex-tasks execute <parent_id> '<子任务JSON>' [workspace]

# 方式二：逐个添加子任务
codex-tasks add-subtask <parent_id> "任务名" "描述"
codex-tasks add-subtask <parent_id> "任务名2" "描述2"
codex-tasks start <parent_id> [workspace]

3. 监控与干预

# 查看所有任务
codex-tasks status

# 实时监控
codex-tasks monitor

# 干预任务（发送消息到 tmux）
codex-tasks intervene <task_id> "停下，先做X"

# 停止任务
codex-tasks stop <task_id>

# 查看日志
codex-tasks logs <task_id>

4. 自动合并与汇报

# 自动合并 PR (CI检查 → 代码审查 → 合并)
codex-tasks auto-merge <task_id> [repo]

# 汇报完成
codex-tasks report <task_id> [telegram]

# 清理已完成任务
codex-tasks cleanup [保留数量]

任务注册表

• 位置: /tmp/codex-tasks/active-tasks.json
• 包含: 所有任务状态、子任务关系、日志

# 直接查看 JSON
codex-tasks json

# 清理已完成任务
codex-tasks cleanup 10

查看任务输出

# 任务目录
ls /tmp/codex-results/tasks/<task_id>/

# 执行日志
cat /tmp/codex-results/tasks/<task_id>/output.log

# 任务提示词
cat /tmp/codex-results/tasks/<task_id>/prompt.txt

监控设置 (可选)

# 方式一：加载环境变量后启动监控
export $(cat ~/.openclaw/.env | xargs) && codex-tasks monitor-start 60 &

# 方式二：直接指定间隔
codex-tasks monitor-start 60 &

注意：需要先配置通知环境变量才能收到进度/完成通知。

OpenClaw 集成示例

在 OpenClaw 中使用：

你: 实现用户登录功能

OpenClaw (拆解):
→ 分析需求，拆分为子任务
→ 调用 codex-hook 执行
→ 监控任务状态
→ 自动合并 PR
→ 汇报完成

通知配置

方式一：环境变量文件

推荐将配置写入 ~/.openclaw/.env：

# ~/.openclaw/.env
TELEGRAM_BOT_TOKEN="your-bot-token"
TELEGRAM_CHAT_ID="your-chat-id"
TELEGRAM_TOPIC_ID="123456"  # 可选，Forum 话题 ID
DISCORD_WEBHOOK="https://discord.com/api/webhooks/xxx"
WEBHOOK_URL="https://your-webhook.com/hook"
DEFAULT_CHANNEL="telegram"

启动监控时加载：

export $(cat ~/.openclaw/.env | xargs) && codex-tasks monitor-start

方式二：环境变量

# Telegram (用户/群组/话题)
export TELEGRAM_BOT_TOKEN="your-bot-token"
export TELEGRAM_CHAT_ID="your-chat-id"
export TELEGRAM_TOPIC_ID="123456"  # 可选，Forum 话题 ID

# Discord
export DISCORD_WEBHOOK="https://discord.com/api/webhooks/xxx"

# 通用 Webhook
export WEBHOOK_URL="https://your-webhook.com/hook"

# 默认渠道
export DEFAULT_CHANNEL="telegram"

通知类型

快速测试

# 测试发送
bash notify.sh send telegram "Hello"

# 测试进度条
bash notify.sh bar 50 "处理中..."

tmux 不可用

⚠️ tmux 不可用，使用后台执行

• 解决：安装 tmux brew install tmux

codex 命令找不到

• 解决：确保 codex 已安装并在 PATH 中

gh 命令找不到 (自动合并)

• 解决：安装 GitHub CLI brew install gh

Telegram 通知不工作

• 配置环境变量：

export TELEGRAM_BOT_TOKEN="your-bot-token"
export TELEGRAM_CHAT_ID="your-chat-id"

版本历史

• 1.0.1 - MIT-0 开源，修复 tmux/worktree 集成，改进状态监控
• 1.0.0 - 初始版本
• 0.1.0 - 基础任务调度

许可证

MIT-0 (No Attribution) - 见 LICENSE 文件