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 之前，会：

识别本机环境：当前装了哪些 MCP server、哪些模型可用
根据任务选模型：简单任务用 haiku，常规开发用 sonnet，架构设计用 opus
设计提示词：不是转发用户原话，而是基于知识库 + 提示词模式库，针对任务类型构造最优提示词——告诉 Claude Code 该怎么分步骤、输出什么格式
配置合适的权限：根据任务需要配置 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 每次回复的内容，相当于实时监控。

若单次回复过长，on_complete.py 现在会对 Discord 通知执行自动分片发送，而不是简单截断：

超过 Discord 安全长度时自动拆成多条；
每条都会带分片编号，如 [1/N]、[2/N]；
分片逻辑优先按空行、换行、空格切分；
对 fenced code block（```）做了代码块感知处理：若在代码块中间切开，会自动在当前分片补 closing fence，并在下一分片补回 opening fence，避免 Discord 渲染错乱。

此外，当 Claude Code 从等待输入态切换到实际工作态时，pane_monitor.sh 也会向当前绑定 thread 主动发送一条“开始处理任务”通知，内容包含 session、workdir 与 trace_id，便于确认任务已开始执行并与后续日志对账。

2026-03-18 起，thread 回传链路又补了一层稳态修复：

forward_to_session.py 不再假设固定 tmux pane，而是先解析当前活动 pane；
发送前会等待 Claude Code 进入可输入状态，并识别当前常见的 ❯ prompt，避免刚启动时首条消息被吞；
完成通知与 monitor 通知会从真实的 openclaw message send --json 输出里递归提取 messageId，确保 reply-route map 能稳定记录；
因此，用户现在可以直接“回复 Claude 刚回到 thread 的那条消息”，路由器会优先通过 reply-target-message-id 把消息送回原 tmux session。

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 继续

两种审批模式

启动前由用户选择：

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

start_claude.sh 现在默认使用 自动模式（也就是默认免权限启动）；只有显式传 --approval 才切回人工审批模式。

另外，启动器现在还会在 Claude CLI 拉起后默认补发一次空回车，用来兼容首次进入新目录时可能出现的“信任目录 / 继续确认”提示，避免新 session 卡在第一屏等待确认。

两种模式下 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）

环境变量配置

环境变量	默认值	说明
`CODING_AGENT_NAME`	`coding`	只有 agent_name 等于此值时才触发 hook（避免 main 等其他 agent 误触发导致余额耗尽）

# 示例：自定义 agent 名称
export CODING_AGENT_NAME=coder

踩过的坑

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

多 session 独立通知

现在 hooks/start_claude.sh 已支持为不同 session 注入独立通知参数，适合同时运行多个 Claude Code 任务并分别回传到不同线程。

示例：

bash hooks/start_claude.sh claude-moss /path/to/moss \
  --chat-id channel:<moss_thread_id> \
  --channel discord \
  --account coder \
  --agent coding

bash hooks/start_claude.sh claude-benchmark /path/to/benchmark \
  --chat-id channel:<benchmark_thread_id> \
  --channel discord \
  --account coder \
  --agent coding

支持参数：

--approval
--auto
--chat-id <id>
--channel <channel>
--account <account>
--agent <agent>

这些参数只对当前 session 生效；未传时会回退到全局 CLAUDE_AGENT_* 环境变量。

注意：thread 通知 与 独立 thread 会话 是两回事。若还希望 coding agent 后续也在该 thread 回复，需要额外启用 OpenClaw 的 Discord thread bindings，并在目标 thread 内触发一条真实入站消息。

未来计划

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

上游说明

本仓库基于 N1nEmAn/claude-agent 进行二次开发，现作为独立仓库维护，并非 GitHub Fork。

原始上游仓库：

https://github.com/N1nEmAn/claude-agent

致谢

感谢 N1nEmAn/claude-agent 与 dztabel-happy/codex-agent 两个上游项目提供的基础设计与实现。本仓库在其思路基础上，补充了 thread 路由、reply-target 映射、bridge 工具和统一仓库布局。

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Claude Agent — 让 OpenClaw 替你操作 Claude Code

它是什么？

完全体 Claude Code

解决什么问题？

工作流程

技术原理：tmux + hook

tmux：像人一样操作终端

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

用户随时可接管

两种审批模式

知识库：OpenClaw 真正理解 Claude Code

文件结构

快速开始

更新

前置条件

环境变量配置

踩过的坑

多 session 独立通知

未来计划

上游说明

致谢

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

Claude Agent — 让 OpenClaw 替你操作 Claude Code

它是什么？

完全体 Claude Code

解决什么问题？

工作流程

技术原理：tmux + hook

tmux：像人一样操作终端

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

用户随时可接管

两种审批模式

知识库：OpenClaw 真正理解 Claude Code

文件结构

快速开始

更新

前置条件

环境变量配置

踩过的坑

多 session 独立通知

未来计划

上游说明

致谢