用途:在需要交互式 TTY 时,用 tmux 远程控制会话,发送按键并抓取窗格输出,驱动交互式 CLI;非交互的长时任务优先用 bash 后台模式。
主要能力与用法:使用隔离 socket,路径默认 $CLAWDBOT_TMUX_SOCKET_DIR 或 ${TMPDIR:-/tmp}/clawdbot-tmux-sockets 下的 clawdbot.sock。创建会话: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;可用 list-sessions、list-panes -a 查看。
安全发送与监控:优先字面量发送 send-keys -l -- "$cmd",控制键如 C-c;用 {baseDir}/scripts/find-sessions.sh -S "$SOCKET" 或 --all 查找会话;用 {baseDir}/scripts/wait-for-text.sh -t session:0.0 -p 'pattern' 等待提示;可 attach 后 Ctrl+b d 分离。Python REPL 需设 PYTHON_BASIC_REPL=1,否则会破坏 send-keys 流程。
适用场景:并行编排 Codex、Claude Code 等编码智能体,用独立 socket 建多个会话,在不同工作目录启动,轮询提示符检测完成,再抓取输出;建议用独立 git worktree 避免分支冲突,新克隆先执行 pnpm install,Codex 非交互修复需 --yolo 或 --full-auto。
限制:仅支持 macOS/Linux,Windows 需 WSL 并在其中安装 tmux,且要求 tmux 在 PATH 中。清理可用 kill-session、批量 kill-session 或 kill-server。