正文内容
核心脚本
| 脚本 | 功能 | 状态 |
|------|------|------|
| task-execute.sh | 单任务派发（推荐） | ✅ |
| codex-tasks.sh | 任务管理入口 | ✅ |
| task-registry.sh | 任务注册表 | ✅ |
| task-monitor.sh | 任务监控 | ✅ |
| notify.sh | 通知系统 | ✅ |
| auto-merge.sh | 自动合并 | ✅ |
| codex-progress-reporter.sh | 进度汇报 | ✅ |
| task-dispatcher.sh | 任务调度器（高级） | ⚠️ 可选 |
Worktree 管理策略
复用逻辑：
- 关联任务（同一项目）→ 复用现有 worktree
- 独立任务 → 新建 worktree
合并命令：
# 1. 在 worktree 中提交
git add .
git commit -m "feat: 描述"
# 2. 推送分支
git push -u origin
# 3. 创建 PR（需要手动或用 gh） 架构
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 # 任务拆解（预留） 命令说明
| 命令 | 简写 | 说明 | 示例 |
|------|------|------|------|
| init | i | 初始化任务系统 | codex-tasks init |
| execute | run | 接收子任务并执行 | execute p1 '[{"name":"API"}]' |
| add-subtask | add | 添加单个子任务 | add p1 "API" "实现登录" |
| start | — | 开始执行所有子任务 | start p1 |
| status | list | 查看状态 | status / status task-xxx |
| monitor | watch | 实时监控面板 | monitor |
| check | — | 单次检查任务状态 | check |
| intervene | send | 干预任务 | intervene t-xxx "消息" |
| stop | kill | 停止任务 | stop t-xxx |
| logs | log | 查看日志 | logs t-xxx |
| auto-merge | merge | 自动合并 PR | auto-merge t-xxx |
| report | — | 汇报完成 | report t-xxx |
| cleanup | clean | 清理已完成任务 | cleanup 10 |
工作流
1. OpenClaw 拆解任务
OpenClaw 负责分析需求，拆分为子任务列表：
[
{"name": "后端API开发", "description": "实现用户登录API"},
{"name": "前端页面", "description": "实现登录页面"},
{"name": "单元测试", "description": "编写登录相关测试"}
] 2. 调用 codex-hook 执行
# 方式一：一次性接收所有子任务
codex-tasks execute '' [workspace]
# 方式二：逐个添加子任务
codex-tasks add-subtask "任务名" "描述"
codex-tasks add-subtask "任务名2" "描述2"
codex-tasks start [workspace] 3. 监控与干预
# 查看所有任务
codex-tasks status
# 实时监控
codex-tasks monitor
# 干预任务（发送消息到 tmux）
codex-tasks intervene "停下，先做X"
# 停止任务
codex-tasks stop
# 查看日志
codex-tasks logs 4. 自动合并与汇报
# 自动合并 PR (CI检查 → 代码审查 → 合并)
codex-tasks auto-merge [repo]
# 汇报完成
codex-tasks report [telegram]
# 清理已完成任务
codex-tasks cleanup [保留数量] 任务注册表
- 位置：
/tmp/codex-tasks/active-tasks.json - 包含：所有任务状态、子任务关系、日志
# 直接查看 JSON
codex-tasks json
# 清理已完成任务
codex-tasks cleanup 10 查看任务输出
# 任务目录
ls /tmp/codex-results/tasks//
# 执行日志
cat /tmp/codex-results/tasks//output.log
# 任务提示词
cat /tmp/codex-results/tasks//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" 通知类型
| 事件 | 通知内容 |
|------|----------|
| 任务开始 | 任务ID、名称、时间 |
| 进度更新 | 进度条（0–100%）、当前状态 |
| 任务完成 | 任务ID、名称、PR链接、时间 |
| 任务失败 | 任务ID、名称、错误信息 |
| 人工干预 | 干预消息 |
快速测试
# 测试发送
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"