Skip to main content

Prerequisites

  • Docker and Docker Compose v2 installed
  • An Anthropic API key (or any supported provider)
  • A server or VM with at least 2GB RAM

Deploy

1

Clone and run the install script

The script will ask for:
  • Your public URL (e.g. https://clawhq.yourdomain.com or http://localhost)
  • Your Anthropic API key
  • Optional: Discord bot token, Slack token
It creates a .env file and starts all services.
2

Open the dashboard

Navigate to your ClawHQ URL (or http://localhost:3000 for local installs).Sign in with the credentials you set during install. You’ll be taken through a 6-step onboarding wizard.
3

Complete onboarding

The wizard will:
  1. Ask what you want to use ClawHQ for
  2. Let you pick which agents to activate
  3. Confirm your API key
  4. Connect your first channel (Discord, Slack, or Telegram)
4

Talk to your agent

Once connected, message your bot in Discord (or whichever channel you chose). It should respond within a few seconds.

Manual install (without the script)

If you prefer to configure manually:
See Environment Variables for the full list of config options.

Update

ClawHQ services are versioned independently. The docker compose pull command fetches the latest image for each service.

Next steps

Connect Discord

Full Discord bot setup guide

Configure an Agent

Customize your first agent

Deploy to Railway

One-click cloud deploy

Install a Pack

Add pre-built agent bundles