核心用法
cc 技能本质是一个 tmux 会话转发器,让用户能在 Telegram、Discord 等 OpenClaw 支持的聊天渠道中远程操控 Claude Code 编程助手。工作流程分为三个层次:
1. 会话管理:通过 /cc on <project> 在项目目录启动 claude -c 后台会话,建立持久的 tmux 窗口;/cc off 关闭会话
2. 消息中继:进入 relay 模式后,用户所有文本消息被透明转发至 Claude Code,系统仅返回 ⏳ 确认 + Claude 的输出内容,绝不自行解释或回答
3. 状态监控:/cc ? 检测进程存活状态,/cc tail 获取最近输出,/cc projects 管理多项目列表
关键设计在于强制透明管道机制 —— 技能文档反复强调 "You are a transparent pipe",禁止 AI 助手在 relay 模式下对 Claude 的输出进行任何解读、总结或二次加工,确保用户获得的是原汁原味的 Claude Code 交互体验。
显著优点
- 远程接入:打破终端限制,手机 Telegram 即可操控代码助手
- 会话持久:tmux 后台保持 Claude Code 上下文,随用随连
- 多项目切换:支持
projects列表管理和快速目录切换 - 输出智能截断:>4000 字符自动摘要,避免消息轰炸
- 零配置依赖:仅需系统预装 tmux 和 npm 全局安装的 claude CLI
潜在缺点与局限
- 单点故障:tmux 会话崩溃或服务器重启会导致上下文丢失
- 延迟累积:消息需经过 OpenClaw → 脚本 → tmux → Claude → 返回的链条,复杂输出可能有明显等待
- 安全风险:tmux 共享会话若配置不当,可能存在权限泄露隐患;技能本身未涉及输入过滤,恶意指令可被直接转发
- 交互受限:无法使用 Claude Code 的原生交互功能(如文件选择器、确认提示的交互式处理)
- 输出截断副作用:长代码生成场景下自动摘要可能隐藏关键中间步骤
适合人群
- 需要离开工位仍保持 Claude Code 会话的开发者
- 习惯用移动端即时通讯工具快速查询代码问题的工程师
- 已部署 OpenClaw 基础设施并追求 workflow 统一的技术团队
常规风险
| 风险类型 | 说明 |
|---------|------|
| 命令注入 | 用户消息直接拼接进 shell 脚本参数,若未妥善转义可能触发 |
| 会话劫持 | tmux socket 若全局可读写,同服务器其他用户可能 attach 会话 |
| 日志残留 | 项目路径、代码片段可能在服务器日志或 Telegram 云端留存 |
| 依赖失效 | tmux/claude CLI 版本变更可能导致脚本兼容性问题 |