Tmux Skill — Manage Terminal Sessions via Chat

Work with terminal sessions through OpenClaw. Start processes, send commands, monitor output — from anywhere.

Features

• 🖥️ Create and manage tmux sessions
• ⌨️ Send commands and keystrokes
• 📺 Read live terminal output
• 🔄 Interact with running programs (htop, vim, etc.)
• 📋 Multiple windows and panes

Install

clawhub install tmux

---

Usage Examples

Launch programs:

"Start htop in tmux"
"Open vim with server.conf"
"Run npm run dev in a session called frontend"

Control running sessions:

"What's in the terminal right now?"
"Send Ctrl+C"
"Type 'exit' and press Enter"
"Press the arrow keys to scroll down"

Session management:

"Create a session named dev"
"Switch to the server session"
"List all active sessions"
"Kill the build session"

Log monitoring:

"What's the server outputting?"
"Any errors in the logs?"
"Tail the application log"

---

Prerequisites

Tmux must be installed on your server:

# Ubuntu / Debian
sudo apt install tmux

# macOS
brew install tmux

# Verify
tmux -V

---

How It Works

The skill:

1. Creates or attaches to a named tmux session
2. Sends commands via tmux send-keys
3. Reads output via tmux capture-pane
4. Returns the terminal content to OpenClaw, which summarizes or forwards it

---

Practical Tips

• Name sessions descriptively — dev, logs, deploy, build
• Great for long-running tasks — builds, deployments, server processes
• Real-time log monitoring — “watch the server logs and tell me if there are any errors”
• Combine with scheduling — check logs every 30 minutes automatically

---

Example Workflow

You: "Start the dev server in a tmux session"
Bot: Started session 'dev'. Running: npm run dev

You: "What's the dev server showing?"
Bot: Server is running on http://localhost:3000 — compiled in 1.2s, no errors.

You: "Kill the dev session"
Bot: Session 'dev' terminated.