tmux Skill (Clawdbot)

tmux Skill (Clawdbot) 是什么

为 Agent 提供可重复的 tmux 会话控制方法，适合必须通过 TTY 运行的交互式程序和长时间任务。

适用场景

适合启动编码 Agent、控制 REPL、轮询输出、跨断线保留进程和并行隔离多个终端会话。

核心能力与工作机制

清单规范私有 socket、session:window.pane 定位、字面量按键、控制键、capture-pane、等待文本脚本、会话查找和清理。

执行流程

创建独立 socket 和短名称会话，启动程序后用字面量发送输入；通过 capture-pane 或 wait-for-text 检测状态，完成后保存输出并清理会话。

输入与输出

需要命令、工作目录、会话与窗格名、预期提示文本和超时。输出窗格文本、会话状态和交互程序结果，并在后台维持进程。

依赖、账号与权限

支持 macOS/Linux；Windows 需 WSL，且 tmux 必须在 PATH，辅助脚本需可执行。

副作用、限制与风险

发送到错误窗格可能执行危险命令；无界等待和遗留会话会耗资源，自动化 Agent 还可能改动代码。会启动持久进程、发送真实按键并创建 socket、会话和日志。

不适用边界

不适合无 TTY 的简单命令，也不应通过模糊窗口匹配执行破坏性操作。

失败处理与验收

先列出 socket、会话和窗格，捕获最近输出；超时时中断单个进程而不是盲目重启全部任务。核对目标窗格、提示返回、退出码或最终产物，并在结束时确认会话已清理。

适合谁使用

适合自动化交互式 CLI、远程开发和 Agent 编排的工程师。

来源、版本与许可

本条目依据 SkillHub 热门榜、发布者详情和版本 1.0.0 的完整 SKILL.md 整理，核验日期为 2026 年 9 月 21 日。完整 SKILL.md 未声明许可证，公开可下载不代表可以任意复制、修改或再分发。 SkillHub 当前两套安全扫描状态为 benign、benign；该状态只是平台信号，不能替代对脚本、凭据、网络请求、数据外送与后续版本的人工审查。

常见问题

1. tmux Skill (Clawdbot) 主要解决什么问题？

为 Agent 提供可重复的 tmux 会话控制方法，适合必须通过 TTY 运行的交互式程序和长时间任务。适合启动编码 Agent、控制 REPL、轮询输出、跨断线保留进程和并行隔离多个终端会话。是否采用它，应以实际任务边界和可核验材料为准，不要因为榜单热度而跳过来源审查。

2. 开始前需要准备什么？

需要命令、工作目录、会话与窗格名、预期提示文本和超时。准备阶段不要代替用户猜测关键事实；缺少会改变路线、费用或权限的输入时，应先补齐再执行。

3. 它怎样完成任务并交付结果？

创建独立 socket 和短名称会话，启动程序后用字面量发送输入；通过 capture-pane 或 wait-for-text 检测状态，完成后保存输出并清理会话。每个阶段都要保留输入、决策、输出和检查点，不能把计划、预览或排队状态描述成最终交付。

4. 需要哪些工具、账号或权限？

支持 macOS/Linux；Windows 需 WSL，且 tmux 必须在 PATH，辅助脚本需可执行。凭据应放在安全环境中，并按最小权限授权；账号、网络或本地依赖不满足时应明确停止条件。

5. 它会产生哪些外部操作或副作用？

会启动持久进程、发送真实按键并创建 socket、会话和日志。涉及外部写入、上传、发送、付费或持久配置时，应在实际动作前说明影响范围并取得相应确认。

6. 哪些情况不适合使用？

不适合无 TTY 的简单命令，也不应通过模糊窗口匹配执行破坏性操作。超出来源明确能力、专业资质或授权范围时，应切换到更合适的工具或交给专业人员处理。

7. 失败或结果异常时怎样恢复？

先列出 socket、会话和窗格，捕获最近输出；超时时中断单个进程而不是盲目重启全部任务。恢复时优先查询已有任务、日志或备份，避免无上限重试、重复扣费、重复发送或覆盖唯一原件。

8. 如何验收结果并控制风险？

核对目标窗格、提示返回、退出码或最终产物，并在结束时确认会话已清理。验收应基于真实文件、页面、任务终态或权威来源，并把未能实际检查的部分明确标记出来。