Scan to join WeChat group核心脚本
| 脚本 | 功能 | 状态 | |------|------|------| | 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 <branch>
# 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 配置：
```bash
# ~/.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 <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"
通知类型
| 事件 | 通知内容 | |------|----------| | 任务开始 | 任务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"