Openclaw Tmux Claude Ops

OpenClaw Claude Code Orchestrator

English README
一句话：OpenClaw 通过 tmux 编排调度 Claude Code，实现任务的自动派发、实时监控、故障自愈和结构化交付。

核心能力

三层架构

- OpenClaw：任务调度器，负责派发任务、接收完成回调、做出下一步决策
- tmux：提供进程隔离和可观测性——每个任务一个 session，可随时 attach 接管
- Claude Code：执行引擎，在 tmux session 中运行，完成后通过 wake.sh 回调 OpenClaw

双执行模式

三层自动监控（零 token 消耗）

自动故障诊断

diagnose-failure.sh 分析 4 种数据源，匹配 8 种失败模式，输出结构化诊断报告 → 飞书 DM 告警。

完整交付协议

任务完成 → wake.sh → 飞书通知 + TASK_HISTORY.jsonl 记录 + openclaw gateway call wake 回调。每个任务产出 completion-report.json + completion-report.md，可审计、可追溯。

Quick Start

执行流程

项目结构

Dev Process：Spec 驱动的 4 阶段研发流程

在编排器之上叠加方法论约束，让 AI 按"需求 → 设计 → 开发 → 交付"的流程工作：

- Phase 1/2 必须人工审批才能推进——在需求和设计阶段投入审批时间，换来开发阶段大幅减少的返工
- Phase 3/4 自动 gate check：测试全过？lint/build 全过？文档齐全？
- 每个项目产出 LESSONS_LEARNED.md，跨项目知识库 cross_project_lessons.jsonl 自动复用

任务产物

每个任务在 runs// 下产出：

实践建议

1. 默认用 headless——只有预判需要中途接管时才用 interactive
2. 复杂项目用 Dev Process——花 2 个阶段审批需求和设计，换来开发阶段大幅减少的返工
3. 任务失败先看诊断——飞书通知里的诊断结论，再决定是修 prompt 重试还是手动介入
4. 大胆并行——headless 模式下可大量并行派发独立任务
5. 每周看一次周报——analyze-history.sh 生成的统计报告是优化派活策略的依据

适用场景

适合： 并行多个工程任务、有一定复杂度的项目开发、需要事后审计的场景、持续迭代的团队

不适合： 极简单的一次性任务（直接跑 Claude Code 即可）、强依赖人类判断的产品决策

更多文档

- Agent 执行手册：AGENT_RUNBOOK.md
- 变更日志：CHANGELOG.md
- 分享稿 v2（演进叙事）：docs/FINAL_v2.md
- 分享稿 v1：docs/FINAL.md

说明

- 单机即可运行；如引入远程执行，请用最小权限控制 SSH key
- 建议所有执行在 git 管控的 repo 内进行，确保可回滚
- 飞书通知目标通过 OPENCLAW_CC_ALERT_TARGET 环境变量配置