Installation Guide

TinyClaw 🦞

Multi-agent · Multi-team · Multi-channel · 24/7 AI assistant
Run multiple teams of AI agents that collaborate simultaneously with isolated workspaces.

Multi-Agent

TypeScript

Node.js v18+

Telegram · Discord · WhatsApp

MIT License

Prerequisites

🟢

Node.js

v18 or higher

📟

tmux

for 24/7 operation

🔧

jq + Bash 4.0+

macOS: brew install bash

🤖

Claude Code CLI

or Codex CLI

Installation Steps

Install TinyClaw

Choose one of three installation methods. One-line install is recommended.

bash

# Option 1: One-line install (Recommended)
curl -fsSL https://raw.githubusercontent.com/jlia0/tinyclaw/main/scripts/remote-install.sh | bash

# Option 2: From release tarball
wget https://github.com/jlia0/tinyclaw/releases/latest/download/tinyclaw-bundle.tar.gz
tar -xzf tinyclaw-bundle.tar.gz
cd tinyclaw && ./scripts/install.sh

# Option 3: From source
git clone https://github.com/jlia0/tinyclaw.git
cd tinyclaw && npm install && ./scripts/install.sh

Install AI Provider CLI

TinyClaw requires either Claude Code CLI or Codex CLI — it does not support direct API keys or OpenRouter.

🟣 Anthropic (Claude)

Install Claude Code CLI
authenticate with your
Anthropic account

Models: Sonnet, Opus

🟢 OpenAI (Codex)

Install Codex CLI
authenticate with your
OpenAI account

Models: gpt-5.3-codex

Run Setup Wizard

The interactive wizard walks you through channels, workspace, agents and provider selection.

bash

tinyclaw start   # Runs interactive setup wizard

Wizard covers: channel selection (Discord/WhatsApp/Telegram) · bot tokens · workspace name · default agent · AI provider · model · heartbeat interval

Configure Agents & Teams

Edit .tinyclaw/settings.json to define your agents and teams.

json · .tinyclaw/settings.json

{
  "channels": {
    "enabled": ["telegram", "discord"],
    "telegram": { "bot_token": "YOUR_TOKEN" }
  },
  "agents": {
    "coder": {
      "name": "Code Assistant",
      "provider": "anthropic",
      "model": "sonnet"
    },
    "writer": {
      "name": "Technical Writer",
      "provider": "anthropic",
      "model": "sonnet"
    }
  },
  "teams": {
    "dev": {
      "name": "Dev Team",
      "agents": ["coder", "writer"],
      "leader_agent": "coder"
    }
  }
}

Key Commands

bash

tinyclaw start                        # Start daemon
tinyclaw status                       # Check status
tinyclaw agent list                   # List agents
tinyclaw team visualize dev           # Live TUI dashboard
tinyclaw logs all                     # View all logs

# In-chat routing (Telegram/Discord/WhatsApp)
@coder fix the authentication bug      # Route to agent
@dev review this PR                    # Route to team
/agent                                 # List available agents