Use the CLI wizard to configure Clawdbot with guided setup for Gateway, channels, skills, and workspace defaults.

Overview

The onboarding wizard is the recommended setup method for Clawdbot on macOS, Linux, or Windows (via WSL2). It provides a guided configuration flow for local or remote Gateway connections, channels, skills, and workspace defaults.

Key Commands

Command	Description
`clawdbot onboard`	Primary setup wizard
`clawdbot dashboard`	Opens Control UI for browser-based chat
`clawdbot configure`	Reconfigure existing installation
`clawdbot configure --section web`	Configure web search (Brave Search API)

Setup Modes

QuickStart (Recommended)

Default configuration for most users:

Local gateway on loopback
Port 18789 with token authentication
Telegram/WhatsApp DMs use allowlist mode

Advanced Mode

Full control over all configuration steps for power users.

Configuration Flow

1. Existing Config Detection

The wizard detects ~/.clawdbot/clawdbot.json and offers:

Keep - Use existing configuration
Modify - Update specific settings
Reset - Start fresh

2. Model & Authentication

Choose your AI provider:

Provider	Description
Anthropic API Key	Recommended for best performance
Anthropic OAuth	For Claude Pro/Max subscribers
OpenAI API Key	GPT-4 and other models
OpenAI Codex	Code-focused subscription
Vercel AI Gateway	Proxy option
Local Models	Offline operation

3. Workspace Setup

Default workspace: ~/.clawdbot/workspace

Bootstrap files created:

AGENTS.md - Agent configuration
SOUL.md - Personality settings
TOOLS.md - Available tools
IDENTITY.md - Identity information

4. Gateway Configuration

Configure your Gateway settings:

Port: Default 18789
Bind Address: Loopback or network
Auth Mode: Token-based (recommended)
Tailscale: Optional remote exposure

5. Channel Setup

Optional integrations:

WhatsApp
Telegram
Discord
Slack
Signal
iMessage
Google Chat
Mattermost

6. Daemon Installation

macOS: LaunchAgent
Linux/WSL2: systemd user unit

7. Health Check

Validates Gateway startup and connectivity.

8. Skills Installation

Optional skill packages via npm/pnpm.

Remote Mode

Connect to an existing Gateway running elsewhere:

clawdbot onboard --remote

No installations performed on the remote host - only configures local client connection.

Non-Interactive Mode

For automation and scripting:

clawdbot onboard --non-interactive \
  --auth-choice anthropic \
  --anthropic-api-key $ANTHROPIC_API_KEY

Multiple Agents

Create isolated agent instances:

clawdbot agents add work
clawdbot agents add personal
clawdbot agents list

Each agent has its own workspace and configuration.

Next Steps

Setup Guide - Detailed setup instructions
Pairing - Configure access control
Channels - Set up messaging integrations

Onboarding Wizard (CLI)