核心脚本

脚本	功能	状态
task-execute.sh	单任务派发（推荐）	✅
codex-tasks.sh

任务管理入口 | ✅ |

Worktree 管理策略

复用逻辑：

• - 关联任务（同一项目）→ 复用现有 worktree
• 独立任务 → 新建 worktree

合并命令：

# 1. 在 worktree 中提交
git add .
git commit -m "feat: 描述"

# 2. 推送分支
git push -u origin <branch>

# 3. 创建 PR（需要手动或用 gh）

## 架构

## 依赖

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

## 安装

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

建议添加 alias 到 shell 配置：

~/.zshrc 或 ~/.bashrc

## 快速开始

1. 初始化

2. 执行任务（OpenClaw 拆解后调用）

3. 查看状态

## 核心文件

## 命令说明

| 命令 | 简写 | 说明 | 示例 |
|------|------|------|------|
| `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 负责分析需求，拆分为子任务列表：

### 2. 调用 codex-hook 执行

方式一：一次性接收所有子任务

### 3. 监控与干预

### 4. 自动合并与汇报

## 任务注册表

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

## 查看任务输出

## 监控设置 (可选)

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

## OpenClaw 集成示例

在 OpenClaw 中使用：

## 通知配置

### 方式一：环境变量文件

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

启动监控时加载：

### 方式二：环境变量

### 通知类型

| 事件 | 通知内容 |
|------|----------|
| 任务开始 | 任务ID、名称、时间 |
| 进度更新 | 进度条 (0-100%)、当前状态 |
| 任务完成 | 任务ID、名称、PR链接、时间 |
| 任务失败 | 任务ID、名称、错误信息 |
| 人工干预 | 干预消息 |

### 快速测试

### tmux 不可用

- 解决：安装 tmux `brew install tmux`

### codex 命令找不到
- 解决：确保 codex 已安装并在 PATH 中

### gh 命令找不到 (自动合并)
- 解决：安装 GitHub CLI `brew install gh`

### Telegram 通知不工作
- 配置环境变量：