by 运行时依赖
OSmacOS · Linux
安装命令
点击复制官方npx clawhub@latest install tmux
镜像加速npx clawhub@latest install tmux --registry https://cn.longxiaskill.com 镜像可用
本土化适配说明
Tmux — 终端会话管理 安装说明： 安装命令：["openclaw skills install tmux"] 支持国内镜像加速，使用 --registry https://cn.longxiaskill.com 参数可加速下载
技能文档
仅在需要交互式 TTY 时使用 tmux。对于长时间运行、非交互式任务，请优先使用 bash 后台模式。
快速开始（独立 socket，bash 工具）
SOCKET_DIR="${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/clawdbot-tmux-sockets}" mkdir -p "$SOCKET_DIR" SOCKET="$SOCKET_DIR/clawdbot.sock" SESSION=clawdbot-python
tmux -S "$SOCKET" new -d -s "$SESSION" -n shell tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- 'PYTHON_BASIC_REPL=1 python3 -q' Enter tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200
启动会话后，请始终打印监控命令：
监控命令：
tmux -S "$SOCKET" attach -t "$SESSION"tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200
Socket 规范
- 使用 CLAWDBOT_TMUX_SOCKET_DIR（默认为 ${TMPDIR:-/tmp}/clawdbot-tmux-sockets）
- 默认 socket 路径：
$CLAWDBOT_TMUX_SOCKET_DIR/clawdbot.sock
定位窗格和命名
- 目标格式：session:window.pane（默认为 :0.0）
- 名称保持简短，避免空格
- 检查命令：
tmux -S "$SOCKET" list-sessions
- tmux -S "$SOCKET" list-panes -a查找会话
列出 socket 上的会话：{baseDir}/scripts/find-sessions.sh -S "$SOCKET"
扫描所有 socket：{baseDir}/scripts/find-sessions.sh --all
安全发送输入
- 优先使用字面发送：
tmux -S "$SOCKET" send-keys -t target -l -- "$cmd" - 控制键：
tmux -S "$SOCKET" send-keys -t target C-c
监控输出
- 捕获最近历史：
tmux -S "$SOCKET" capture-pane -p -J -t target -S -200 - 等待提示符：
{baseDir}/scripts/wait-for-text.sh -t session:0.0 -p 'pattern'
附加和分离
- 附加：
tmux -S "$SOCKET" attach -t "$SESSION" - 分离：Ctrl+b d
启动进程
对于 Python REPL，设置 PYTHON_BASIC_REPL=1（非基础 REPL 会破坏 send-keys 流程）。
Windows / WSL
tmux 支持 macOS/Linux。在 Windows 上，请使用 WSL 并在 WSL 内安装 tmux。
此技能仅限 darwin/linux 系统使用，且需要 PATH 中有 tmux。
编排编码代理（Codex、Claude Code）
tmux 擅长并行运行多个编码代理。