Claude Agent — 让 OpenClaw 替你操作 Claude Code

English | 中文

你躺在床上说一句话，OpenClaw 帮你开 Claude Code、写提示词、处理审批、检查质量、汇报结果。你随时可以打开终端接管。

这是一个 OpenClaw 专用 Skill。 需要 OpenClaw 作为 AI agent 运行时，通过 OpenClaw 的 agent 唤醒、消息投递、cron 等能力驱动整个工作流。

它是什么？

一句话：OpenClaw 代替用户操作 Claude Code CLI。

Claude Code 是 Anthropic 的终端编程工具，很强，但需要你坐在电脑前盯着它——写提示词、等输出、审批工具调用、检查结果。这个 skill 让 OpenClaw 替你做这些事。

本质就两样东西：tmux + hook。

• tmux：Claude Code 跑在 tmux session 里，OpenClaw 通过 tmux 读输出、发指令，和人在终端里操作一模一样
• hook：Claude Code 完成任务或等审批时，自动通知用户（Telegram）+ 唤醒 OpenClaw 处理

用户随时可以 tmux attach 接入，看 Claude Code 在干什么，甚至直接接管操作。

完全体 Claude Code

普通用法：你手动写提示词丢给 Claude Code，Claude Code 只知道你告诉它的东西。

OpenClaw 在发任务给 Claude Code 之前，会：

1. 识别本机环境：当前装了哪些 MCP server、哪些模型可用
2. 根据任务选模型：简单任务用 haiku，常规开发用 sonnet，架构设计用 opus
3. 设计提示词：不是转发用户原话，而是基于知识库 + 提示词模式库，针对任务类型构造最优提示词——告诉 Claude Code 该怎么分步骤、输出什么格式
4. 配置合适的权限：根据任务需要配置 permissions.allow，按需授权工具

这意味着 Claude Code 每次收到的都是一个充分利用本机全部能力的精心设计的任务，而不是用户随手写的一句话。

解决什么问题？

正常用 Claude Code 的流程：

你坐在电脑前 → 打开终端 → 想提示词 → 启动 Claude Code → 盯着输出 →
审批工具调用 → 不满意就重来 → 满意了收工

用了这个 skill：

你躺在床上 → 在 Telegram 里说"帮我给这个项目加个 XX 功能" →
OpenClaw 开 Claude Code 干活 → 中间过程自己处理 → 完事了 Telegram 通知你 →
不满意？说一句就继续改 → 想看过程？tmux attach 看直播

核心价值：用户当老板，OpenClaw 当员工，Claude Code 当工具。

工作流程

1. 用户下任务（Telegram / 终端 / 任何渠道）
     ↓
2. OpenClaw 理解需求，追问不清楚的地方
     ↓
3. OpenClaw 设计提示词，选择执行模式，和用户确认
     ↓
4. OpenClaw 在 tmux 里启动 Claude Code
     ↓
5. Claude Code 干活，OpenClaw 通过 hook 被唤醒：
   ├── 任务完成 → OpenClaw 检查输出质量
   │   ├── 满意 → Telegram 通知用户，汇报结果
   │   └── 不满意 → 让 Claude Code 继续改
   ├── 等待审批 → OpenClaw 判断批准/拒绝
   └── 方向性问题 → 立即找用户确认
     ↓
6. 用户收到最终结果
   （整个过程可以随时 tmux attach 接入）

中间过程 OpenClaw 全权处理，但每一步都会同步发送到 Telegram——任务完成、审批等待、输出内容，用户在手机上实时可见。你可以选择不管（让 OpenClaw 自主处理），也可以随时插话干预。

技术原理：tmux + hook

tmux：像人一样操作终端

OpenClaw 操作 Claude Code 的方式和人完全一样：

# 启动 Claude Code（和你在终端里敲一样）
tmux send-keys -t claude-session 'claude --dangerously-skip-permissions' Enter

# 发送提示词（和你打字一样）
tmux send-keys -t claude-session '帮我实现 XX 功能'
sleep 1
tmux send-keys -t claude-session Enter

# 查看输出（和你看屏幕一样）
tmux capture-pane -t claude-session -p

tmux 的好处：

• 不受 OpenClaw turn 超时限制：Claude Code 跑多久都行，OpenClaw 被唤醒时再来看
• 用户可以随时接入：tmux attach -t claude-session 就能看到实时输出
• 持久化：OpenClaw 重启、网络断开，Claude Code 都不受影响

hook：任务完成和审批等待的自动通知

两套机制覆盖两种事件：

1. Claude Code Stop hook（任务完成）

Claude Code 的 hooks 系统，任务完成时调用脚本：

Claude Code 完成 turn → on_complete.py
                        ├── Telegram 通知用户（回复内容）
                        └── openclaw agent 唤醒（OpenClaw 自动检查输出）

用户在 Telegram 上能看到 Claude Code 每次回复的内容，相当于实时监控。

2. tmux pane monitor（审批等待）

Claude Code 的 Stop hook 不覆盖审批场景，所以用 pane_monitor.sh 监控 tmux 输出：

Claude Code 弹出权限提示 → pane_monitor.sh 检测到关键词
                           ├── Telegram 通知用户（待审批的工具调用）
                           └── openclaw agent 唤醒（OpenClaw 自主判断批准/拒绝）

两套机制都是双通道同时触发：用户和 OpenClaw 同时收到消息。用户看到后可以不管（OpenClaw 会处理），也可以直接回复干预。

用户随时可接管

这不是黑箱。任何时候：

• tmux attach -t claude-session：直接看 Claude Code 在干什么
• 在 tmux 里直接打字：接管操作
• tmux detach：看完了，还给 OpenClaw 继续

两种审批模式

启动前由用户选择：

模式	谁审批	适用场景
自动 (--dangerously-skip-permissions)	Claude Code 自行执行	常规开发，省心
OpenClaw 审批 (默认)	OpenClaw 判断批准/拒绝	敏感操作，需要把关

两种模式下 pane monitor 都会启动。

知识库：OpenClaw 真正理解 Claude Code

OpenClaw 不是盲目转发命令。它维护一套 Claude Code 知识库：

文件	内容
features.md	CLI 参数、斜杠命令、内置工具
config_schema.md	settings.json 完整字段定义
capabilities.md	本机 MCP/模型/工具能力
prompting_patterns.md	提示词模式库（按任务类型）
UPDATE_PROTOCOL.md	数据源更新协议
changelog.md	版本变更追踪

知识库会过时，所以有更新协议：版本变更 / 超 7 天 / 手动触发时，按 CLI 自省 → GitHub → 官方文档 → 社区的优先级更新。

文件结构

claude-agent/
├── SKILL.md                    # OpenClaw 工作流指令（给 OpenClaw 读的）
├── README.md                   # 本文件（给人读的）
│
├── hooks/
│   ├── on_complete.py          # Claude Code 完成 → Telegram + OpenClaw 唤醒
│   ├── pane_monitor.sh         # 审批检测 → Telegram + OpenClaw 唤醒
│   ├── start_claude.sh         # 一键启动（Claude Code + monitor）
│   └── stop_claude.sh          # 一键清理
│
├── knowledge/                  # Claude Code 知识库（6 文件）
│   ├── features.md
│   ├── config_schema.md
│   ├── capabilities.md
│   ├── prompting_patterns.md
│   ├── UPDATE_PROTOCOL.md
│   └── changelog.md
│
├── workflows/
│   ├── standard_task.md        # 标准任务流程
│   └── knowledge_update.md     # 知识库更新流程
│
├── references/
│   └── claude-code-reference.md  # CLI 命令参考
│
└── state/
    ├── version.txt             # 当前 Claude Code 版本
    └── last_updated.txt        # 知识库最后更新日期

快速开始

详细的安装步骤见 INSTALL.md（7 步，约 5 分钟）。

或者，把下面这段话直接发给你的 OpenClaw，它会自动帮你完成配置：

请帮我安装和配置 claude-agent skill。 先读一遍完整的安装指南 ~/.openclaw/workspace/skills/claude-agent/INSTALL.md，然后按照步骤帮我完成配置。 如果还没有这个文件，先从 GitHub 克隆到 ~/.openclaw/workspace/skills/claude-agent/，再读 INSTALL.md 执行。

配置完成后，在 Telegram 里对 OpenClaw 说一句话就能用：

"用 Claude Code 帮我在 /path/to/project 实现 XX 功能"

更新

已安装的用户更新到最新版本：

cd ~/.openclaw/workspace/skills/claude-agent
git pull

更新日志见 CHANGELOG.md。

前置条件

• OpenClaw 已安装并运行
• Claude Code 已安装（claude --version）
• tmux 已安装
• Telegram 已配置为 OpenClaw 消息通道
• OpenClaw session 自动重置必须关闭或调大（默认每天重置会丢失任务上下文，详见 INSTALL.md）

踩过的坑

问题	解决
OpenClaw 默认每天重置 session，长任务上下文丢失	关闭自动重置（见前置配置）
tmux send-keys 文本 + Enter 一起发，Claude Code 不响应	分两次发，中间 sleep 1s
--dangerously-skip-permissions 仅 -p 模式可用	交互模式用 permissions.allow 配置
Claude Code Stop hook 不覆盖审批等待	pane_monitor.sh 补齐

未来计划

• 补充更多提示词模式（代码审查、架构设计）
• pane monitor 支持更多审批模式检测
• 支持 Claude Code 多 session 并行管理

致谢

本项目基于 codex-agent 改造而来。codex-agent 由 @dztabel-happy 原创，实现了通过 OpenClaw 操作 OpenAI Codex CLI 的完整工作流（tmux + hook 双通道通知架构、知识库维护体系、项目经理式多步骤任务执行）。

claude-agent 继承了 codex-agent 的核心架构设计，将目标 CLI 从 OpenAI Codex 迁移到 Anthropic Claude Code，适配了 Claude Code 的 hooks 系统、权限模型和 settings.json 配置格式。

感谢原作者的出色工作。