Skip to main content
ClawControl requires the Bun runtime. The one-liner install scripts handle this automatically, or you can install Bun manually if using a package manager. The install scripts automatically detect your platform, install Bun if needed, and set up ClawControl globally. 
curl -fsSL https://raw.githubusercontent.com/ipenywis/clawcontrol/main/install.sh | bash
The install scripts will:
  • Check for Bun and install it if missing
  • Install ClawControl globally
  • Add the clawcontrol command to your PATH

​
Package managers

You can also install ClawControl using npm, pnpm, or Bun directly. Note: You must install Bun manually first, as these package managers only install ClawControl itself.

​
Install Bun first

curl -fsSL https://bun.sh/install | bash

​
Then install ClawControl

bun add -g clawcontrol
ClawControl requires the Bun runtime to execute. If you install via npm or pnpm without Bun, the CLI will not work. Always install Bun first when using package managers.

​
System requirements

1

Bun runtime

Required for running the ClawControl CLI. The install scripts handle this automatically, or install from bun.sh.
2

Node.js 20+

Only required if you’re developing or building ClawControl from source. Not needed for regular usage.
3

Terminal with true color support

For the best experience, use a modern terminal:
  • Recommended: Ghostty, iTerm2, Kitty, WezTerm
  • macOS Terminal.app: Requires macOS 26+ (Tahoe) for full color support
ClawControl will detect terminals without true color support and show a warning banner.

​
Verify installation

After installation, verify that ClawControl is available: 
clawcontrol --version

clawcontrol v0.2.3
You should see the version number (currently 0.2.3). To launch the interactive TUI, simply run: 
clawcontrol
This will open the ClawControl interface with the ASCII logo and command palette: 
   _____ _                  _____            _             _
  / ____| |                / ____|          | |           | |
 | |    | | __ ___      __| |     ___  _ __ | |_ _ __ ___ | |
 | |    | |/ _` \ \ /\ / /| |    / _ \| '_ \| __| '__/ _ \| |
 | |____| | (_| |\ V  V / | |___| (_) | | | | |_| | | (_) | |
  \_____|_|\__,_| \_/\_/   \_____\___/|_| |_|\__|_|  \___/|_|

Deploy and manage OpenClaw instances with ease

Type a command (e.g., /new)...

​
Updating ClawControl

To update to the latest version, run the install script again or use your package manager: 
curl -fsSL https://raw.githubusercontent.com/ipenywis/clawcontrol/main/install.sh | bash

​
Troubleshooting

The ClawControl binary is not in your PATH. Try:
  1. Close and reopen your terminal
  2. Check if ~/.bun/bin is in your PATH: echo $PATH
  3. Manually add to PATH: export PATH="$HOME/.bun/bin:$PATH"
  4. Reinstall using the one-liner script
Bun is not installed or not in your PATH:
curl -fsSL https://bun.sh/install | bash
Then restart your terminal or run: source ~/.bashrc (or ~/.zshrc)
Your terminal may not support true color. ClawControl will show a warning banner if this is detected.Solutions:
  • Switch to a modern terminal (Ghostty, iTerm2, Kitty, WezTerm)
  • On macOS, upgrade to macOS 26+ for Terminal.app true color support
  • On older systems, the CLI will still work but colors may render incorrectly
You may need to run with elevated permissions or fix ownership:
# Fix npm global directory ownership
sudo chown -R $(whoami) ~/.npm

# Or reinstall without sudo using the one-liner
curl -fsSL https://raw.githubusercontent.com/ipenywis/clawcontrol/main/install.sh | bash

​
Next steps

Quickstart

Deploy your first OpenClaw instance with ClawControl

Build docs developers (and LLMs) love

Get started for freeTalk to us