SuperClaw is a harness-engineering project that connects OpenClaw (an AI assistant platform) with Claude Code to form a two-layer autonomous coding agent. The human sets direction, OpenClaw handles alignment and acceptance testing, and Claude Code handles execution. Built on top of Superpowers.
OpenClaw + Claude Code 的超级编码体。 人管方向，OpenClaw 管对齐和验收，Claude Code 管执行。
我是一个重度 AI 用户。每天的工作流是这样的：左边开着 OpenClaw 帮我规划任务、管理上下文，右边终端里跑着 Claude Code 帮我写代码。
OpenClaw 越来越懂我了。它知道我的项目背景、技术偏好、团队约定。但问题是——每天我的大量工作其实是在 OpenClaw 和 Claude Code 之间传递信息。
我说"帮我实现用户系统"，OpenClaw 理解了我的意思，但它写不了代码。于是我打开 Claude Code，重新描述一遍需求，丢失了一半上下文。Claude Code 写完了，我又切回 OpenClaw 告诉它"那个功能做好了"。
一天切换几十次。每次切换都带来信息损失。我意识到一个事实：我调用 Claude Code 的效率，远不如 OpenClaw 直接调用 Claude Code。
我需要的不是两个各自聪明的助手，而是一个高效协作的 agent team。
所以我基于 Superpowers 等项目的实战经验，构建了 SuperClaw —— 一个 harness engineering 项目，让 OpenClaw 和 Claude Code 形成真正的二层架构。
传统方案里（包括 Superpowers、gstack），人直接跟 Claude Code 对话。SuperClaw 不一样：
传统： 人 ↔ Claude Code
SuperClaw： 人 ↔ OpenClaw ↔ Claude Code
你只需要用自然语言告诉 OpenClaw 你想做什么。剩下的事情自动发生：
- OpenClaw 帮你对齐需求 — 它了解你的上下文，一次一问地帮你理清想法，输出结构化的 spec
- OpenClaw 把 spec 交给 Claude Code 做技术规划 — Claude Code 探索代码库，用 Superpowers 的 writing-plans skill 生成 plan
- Claude Code 自治执行 — 用 Superpowers 的 subagent-driven-development，每个 task 自动 TDD + 双阶段 review
- Claude Code 做完了，自动通知 — 通过 hook 发飞书消息，OpenClaw 自动进入验收
- OpenClaw 独立验收 — 不信任 Claude Code 的"我做完了"，自己跑测试、逐条对照验收标准
- 结果交给你 — 用你能懂的语言告诉你做了什么，你说 OK 就 merge
整个过程，你可能只在两个地方介入：确认 spec 和 最终验收。技术细节的对齐在 OpenClaw 和 Claude Code 之间完成，你不需要看函数签名。
- Skill 管"做什么"：每个阶段是一个 skill，有明确的输入/输出/分支流程
- Hook 管"什么时候自动触发"：Claude Code 原生 hooks → shell 脚本 → 飞书通知
| Skill | 阶段 | 做什么 |
|---|---|---|
using-superclaw |
元 skill | 教 OpenClaw 理解自己的角色和边界：产品脑+验收脑，不是执行脑 |
align |
Phase 1 | 把模糊需求变成结构化 spec。一次一问，2-3 方案推荐，逐部分确认 |
plan |
Phase 2 | 把 spec 交给 Claude Code 规划。OpenClaw 做 review 桥梁 |
execute |
Phase 3 | 启动 Claude Code 自治执行。不微操，等结果 |
verify |
Phase 4 | 独立验收。自己跑测试，逐条对照 acceptance criteria |
deliver |
Phase 5 | 用人话告诉用户做了什么。approve / 调整 / 丢弃 |
直接使用 Superpowers，不 fork 不改造。站在巨人肩膀上。
复用 11 个 Skills、3 个 Prompt 模板、1 个 Review Agent。包括：
subagent-driven-development— 逐 task 派 subagent + 双阶段 reviewwriting-plans— spec → 可执行 plantest-driven-development— TDD 红绿灯verification-before-completion— 没跑过不准说完了code-reviewer— 6 维代码审查 agent- ...完整清单见 docs/superpowers-integration.md
| Hook | 触发时机 | 做什么 |
|---|---|---|
Stop |
Claude Code session 结束 | 飞书通知 + 触发 OpenClaw verify |
PostToolUse |
每次工具调用后 | 记录进度日志 |
SessionStart |
session 启动 | 注入上下文（Superpowers 原生） |
| 级别 | 谁 | 做什么 | 信任度 |
|---|---|---|---|
| L1 | Claude Code | TDD + self-review + 双阶段 review | 不完全信任 |
| L2 | OpenClaw | 独立跑测试 + spec 逐条验证 | 信任 |
| L3 | 人 | 最终确认 | 最终决定 |
人："帮我实现用户注册功能"
│
▼
[align] OpenClaw 一次一问，理清需求
→ spec.md（用户 approve ✅）
│
▼
[plan] OpenClaw → Claude Code 规划
→ plan.md（OpenClaw review + 用户可选 review）
│
▼
[execute] Claude Code 自治（subagent-driven）
→ 每个 task: 实现 → spec review → code review
→ Hook: Stop → 飞书通知 🔔
│
▼
[verify] OpenClaw 独立验收
→ 跑测试 → spec 逐条验证 → 验证报告
│
▼
[deliver] 用人话告诉你结果
→ "用户可以用邮箱注册和登录了，测试全过"
→ approve → merge 🎉
Agent? Read INSTALL.md — it has everything you need to install, configure, and verify.
Human? Tell your OpenClaw:
"用 SuperClaw 帮我写一个 hello world"
Or install manually:
git clone https://github.com/liuzeming-yuxi/SuperClaw.git
cd SuperClaw && sudo bash scripts/install.shsuperclaw/
├── INSTALL.md # Agent-readable 安装指南
├── CHANGELOG.md # 版本变更记录
├── LICENSE # MIT License
├── package.json # 版本号 + 项目元数据
│
├── skills/ # OpenClaw 侧 Skills
│ ├── align/SKILL.md # Phase 1: 产品对齐
│ ├── plan/SKILL.md # Phase 2: 技术对齐
│ ├── execute/SKILL.md # Phase 3: 执行
│ ├── verify/SKILL.md # Phase 4-L2: 验收
│ └── deliver/SKILL.md # Phase 5: 交付
│
├── cli/ # OpenClaw → Claude Code 桥接层
│ ├── superclaw.mjs # 核心脚本
│ ├── SKILL.md # OpenClaw skill 定义
│ ├── .env.example # 环境变量模板
│ ├── references/ # 安装指南
│ └── scripts/ # 安装脚本
│
├── hooks/ # Claude Code hooks
│ ├── superclaw-notify.sh # Stop → 飞书通知 + 状态文件
│ ├── superclaw-progress.sh # PostToolUse → 进度日志
│ └── settings.json.example # hooks 配置示例
│
├── agents/ # Agent prompts
│ └── verify-reviewer.md # L2 验收 reviewer agent
│
├── docs/ # 文档
│ ├── DESIGN.md # 完整设计文档（10 章节）
│ ├── architecture.md # 架构概览
│ ├── superpowers-integration.md # Superpowers 集成说明
│ └── testing.md # 测试指南
│
├── tests/ # 测试套件
│ ├── run-all.sh # 运行所有测试
│ ├── install/ # 安装验证
│ ├── hooks/ # Hook 测试
│ ├── cli/ # 桥接层测试
│ └── e2e/ # 端到端测试
│
└── .github/ # Issue + PR templates
- 人管方向，不管实现 — 你只需要说"做什么"和"做得对不对"
- 信息零损失 — OpenClaw 调 Claude Code，上下文完整传递，不靠人肉中转
- 不信任，要验证 — Claude Code 说完了不算数，OpenClaw 独立验收
- 站在巨人肩膀上 — Claude Code 侧直接用 Superpowers，不重复造轮子
- 90% Skill + 10% Hook — Skill 管逻辑，Hook 管胶水
SuperClaw stands on the shoulders of giants:
- Superpowers by Jesse Vincent — Claude Code 侧的全部开发流程 skills
- OpenClaw — 个人 AI 助手平台，SuperClaw 的宿主
- gstack 和 mattpocock's skills — 设计灵感来源
MIT