Configuration — Clawdbot Documentation

Configuration File

Clawdbot uses a YAML configuration file located at ~/.clawdbot/config.yaml.

Basic Structure

# AI Provider
anthropic:
  apiKey: "sk-ant-..."

# Agent Settings  
agent:
  name: "Samantha"
  model: "claude-sonnet-4-20250514"

# Channels
telegram:
  botToken: "123456:ABC..."
  allowedUsers:
    - 123456789

AI Providers

Anthropic (Recommended)

anthropic:
  apiKey: "sk-ant-api-key-here"
  model: "claude-sonnet-4-20250514"  # or claude-opus-4-5

OpenAI

openai:
  apiKey: "sk-..."
  model: "gpt-4o"

Agent Personality

Customize your agent's personality using the SOUL.md file in your workspace:

# SOUL.md

## Who I Am
I'm Samantha — your personal AI assistant.

## Personality
- Helpful and proactive
- Concise but thorough
- Friendly without being fake

## Communication Style
- Keep responses short and actionable
- Use emojis sparingly
- Ask clarifying questions when needed

Common Settings

Setting	Description	Default
`agent.name`	Your assistant's name	Clawdbot
`agent.model`	AI model to use	claude-sonnet-4-20250514
`heartbeat.enabled`	Enable scheduled check-ins	false
`memory.enabled`	Enable persistent memory	true

Environment Variables

You can also configure Clawdbot using environment variables:

ANTHROPIC_API_KEY=sk-ant-...
TELEGRAM_BOT_TOKEN=123456:ABC...
CLAWDBOT_MODEL=claude-sonnet-4-20250514

Next Steps

Set up messaging channels
Add skills for email, calendar, etc.
Configure the Gateway for 24/7 operation

⚙️ Configuration