Skip to main content

Quick Start

1. Initialize​

suprclaw onboard

This creates ~/.suprclaw/config.json and the workspace at ~/.suprclaw/workspace/.

2. Configure​

Edit ~/.suprclaw/config.json and add your AI provider:

{
  "agents": {
    "defaults": {
      "workspace": "~/.suprclaw/workspace",
      "model_name": "claude-sonnet-4.6",
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  },
  "model_list": [
    {
      "model_name": "claude-sonnet-4.6",
      "model": "anthropic/claude-sonnet-4.6",
      "api_key": "sk-ant-your-key"
    }
  ]
}

See Providers for all supported providers.

3. Chat​

One-shot message:

suprclaw agent -m "What is 2+2?"

Interactive mode:

suprclaw agent

Specify a model:

suprclaw agent -m "Hello" --model claude-opus-4-6-thinking

4. Start the Gateway (Optional)​

To use chat channels (Telegram, Discord, etc.):

suprclaw gateway

See Chat Channels for setup instructions.

What's Next?​