SuperAPI AI 工具集

tmux

智能体与模型

查看项目

更新于 10-15 20:35

技能介绍

用途:该技能用于远程控制 tmux 会话,向交互式 CLI 发送按键并抓取窗格输出。仅在需要交互式 TTY 时使用;长时、非交互任务优先使用 exec 后台模式。

主要能力:创建隔离 socket 上的会话、发送字面文本与控制键、抓取窗格历史输出、等待提示文本、并行编排多个编码智能体(如 Codex、Claude Code)。

使用方式:先建 socket 目录并创建会话,例如: SOCKET_DIR="${OPENCLAW_TMUX_SOCKET_DIR:-${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/openclaw-tmux-sockets}}" mkdir -p "$SOCKET_DIR" SOCKET="$SOCKET_DIR/openclaw.sock" SESSION=openclaw-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

目标格式为 session:window.pane(默认 :0.0)。发送输入优先用字面发送:tmux -S "$SOCKET" send-keys -t target -l -- "$cmd";控制键如 C-c。对 Claude Code/Codex 等 TUI,不要把文本和 Enter 放在同一次 send-keys,应分开并加小延迟:tmux -S "$SOCKET" send-keys -t target -l -- "$cmd" && sleep 0.1 && tmux -S "$SOCKET" send-keys -t target Enter。

查看输出:tmux -S "$SOCKET" capture-pane -p -J -t target -S -200;等待提示可用 {baseDir}/scripts/wait-for-text.sh -t session:0.0 -p 'pattern'。查找会话可用 {baseDir}/scripts/find-sessions.sh -S "$SOCKET" 或 --all。

适用场景:需要交互式 TTY 的 CLI、并行运行多个编码智能体、监控与抓取终端输出。

限制:该技能限定 darwin/linux,且要求 tmux 在 PATH 中;Windows 需在 WSL 内安装 tmux。Python REPL 需设 PYTHON_BASIC_REPL=1。清理可用 kill-session、kill-server。