CLI Commands

BabyClaw includes a CLI for configuration, service management, model setup, and diagnostics. The CLI has interactive prompts where needed -- if you omit a required option, it will ask you for it.

Setup

babyclaw setup

Interactive first-time setup wizard. Walks you through everything needed to get BabyClaw running:

1. Telegram bot token -- connect to your bot from @BotFather (can be skipped)
2. AI providers -- configure one or more providers (Anthropic, OpenAI, Google, etc.) with API keys
3. Model selection -- pick which models to use for chat
4. Timezone -- set your scheduler timezone
5. Tool settings -- choose shell access mode, configure web search
6. Service install -- optionally install and start BabyClaw as a system service

If a config file already exists, you can choose to update it or start fresh.

Config

babyclaw config init

Creates a new config file with default values and placeholder tokens. Run this first when setting up BabyClaw.

babyclaw config validate

Validates your current config file against the schema. Reports any errors without starting the gateway.

babyclaw config edit

Opens the config file in your default editor ($EDITOR).

Model management

babyclaw model

Shows the current model configuration -- which providers are set up, what models are assigned to chat/vision.

babyclaw model configure

Interactive wizard that walks you through setting up an AI provider. It asks which provider you want, prompts for your API key, and updates the config.

babyclaw model alias

Lists all configured model aliases.

babyclaw model alias set --name <name> --model <model>

Creates or updates a model alias. For example:

babyclaw model alias set --name sonnet --model anthropic:claude-sonnet-4-20250514

If you omit --name or --model, the CLI will prompt you interactively.

babyclaw model alias remove --name <name>

Removes a model alias. If you omit --name, the CLI will prompt you.

Service management

babyclaw service install

Installs BabyClaw as a system service so it starts automatically. Uses launchd on macOS and systemd on Linux.

babyclaw service uninstall

Removes the system service.

babyclaw service start

Starts the BabyClaw service.

babyclaw service stop

Stops the running service.

babyclaw service restart

Restarts the service.

babyclaw service status

Shows whether the service is running.

See Running as a Service for more details.

Gateway

babyclaw gateway status

Queries the running gateway for its current status (uptime, active turns, etc.) via the admin socket.

babyclaw gateway reload

Sends a health check / reload signal to the running gateway.

Skills

babyclaw skill search --query <query>

Searches ClawHub for available skills. If you omit --query, the CLI will prompt you.

babyclaw skill search --query notion

Additional options: --json to output raw JSON.

babyclaw skill install --slug <slug>

Installs a skill from ClawHub into the workspace. The skill is downloaded and placed in workspace/skills/<slug>/. If you omit --slug, the CLI will prompt you.

Additional options: --version, --force, --skip-setup.

Diagnostics

babyclaw doctor

Runs a set of diagnostic checks and reports any issues. Useful for debugging when something isn't working:

• Config file exists and validates
• Database is accessible
• Telegram bot token is valid
• AI provider keys are configured
• Workspace directory exists