SuperAPI AI 工具集

tmux

编程与开发

查看项目

更新于 10-16 00:00

技能介绍

用途:该技能面向需要交互式 TTY 的场景,通过 tmux 独立套接字远程控制会话,向窗格发送按键并抓取输出,可用于驱动交互式 CLI、并行编排编码智能体等。长时非交互任务应优先使用后台执行模式。

主要能力:创建、列举、附着与销毁 tmux 会话;按 session:window.pane 定位窗格;以字面量方式安全发送输入;发送控制键;抓取最近历史输出;等待指定文本/正则出现。配套脚本有 find-sessions.sh 与 wait-for-text.sh(后者支持 -t 目标、-p 模式、-F 固定字符串、-T 超时、-i 轮询间隔、-l 历史行数)。

必要用法:套接字目录取自 OPENCLAW_TMUX_SOCKET_DIR(兼容 CLAWDBOT_TMUX_SOCKET_DIR),默认套接字为 "$OPENCLAW_TMUX_SOCKET_DIR/openclaw.sock"。启动会话后应打印监控命令 attach 与 capture-pane -p -J。发送输入优先用字面量:tmux -S "$SOCKET" send-keys -t target -l -- "$cmd";控制键用 C-c。对 Claude Code/Codex 等 TUI,不要把文本与 Enter 放在同一条 send-keys,应分开并在中间加小延迟(如 sleep 0.1,环境不支持亚秒级则用 sleep 1)。python REPL 需设 PYTHON_BASIC_REPL=1。

并行编排:可创建多个会话在不同工作目录启动 codex 等智能体,通过抓取窗格检查是否返回提示符来判断完成;并行修复建议使用独立 git worktree,新克隆需先 pnpm install,非交互修复需 --yolo 或 --full-auto。

限制:支持 macOS/Linux,Windows 需在 WSL 内安装 tmux;技能限定 darwin/linux 且要求 tmux 在 PATH 中;附着后用 Ctrl+b d 分离。清理方式包括 kill-session、按名称批量 kill 或 kill-server。其他未在资料中说明的事项暂未提供。