Files

2.5 KiB

Common Bot Configuration Snippets

Quick-reference config patterns extracted from documentation.

Discord Setup

Basic Discord Bot

{
  "discord": {
    "botToken": "YOUR_BOT_TOKEN",
    "guilds": {
      "*": {
        "requireMention": true
      }
    }
  }
}

Discord with Specific Channels

{
  "discord": {
    "botToken": "YOUR_BOT_TOKEN",
    "guilds": {
      "GUILD_ID": {
        "channels": {
          "CHANNEL_ID": { "enabled": true }
        },
        "requireMention": true
      }
    }
  }
}

Telegram Setup

{
  "telegram": {
    "botToken": "YOUR_BOT_TOKEN",
    "allowedUsers": ["username1", "username2"]
  }
}

WhatsApp Setup

{
  "whatsapp": {
    "enabled": true
  }
}

Then run: bot login to scan QR code.

Signal Setup

{
  "signal": {
    "number": "+1234567890",
    "allowedNumbers": ["+1987654321"]
  }
}

Gateway Configuration

Local Only (default)

{
  "gateway": {
    "mode": "local",
    "bind": "loopback",
    "port": 18789
  }
}

With Tailscale

{
  "gateway": {
    "mode": "local",
    "tailscale": {
      "mode": "serve",
      "resetOnExit": true
    }
  }
}

Agent Defaults

{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-sonnet-4-5",
      "userTimezone": "America/New_York"
    }
  }
}

Message Settings

{
  "messages": {
    "ackReaction": "👀",
    "textChunkLimit": 1900,
    "historyLimit": 20,
    "replyToMode": "first"
  }
}

Retry Configuration

{
  "retry": {
    "attempts": 2,
    "minDelayMs": 2000,
    "maxDelayMs": 60000,
    "jitter": 0.2
  }
}

Cron Jobs

{
  "cron": {
    "jobs": [
      {
        "id": "morning-check",
        "schedule": "0 9 * * *",
        "message": "Good morning! What's on the agenda today?",
        "enabled": true
      }
    ]
  }
}

Skills Configuration

{
  "skills": {
    "directories": ["./skills", "~/my-skills"],
    "entries": {
      "my-skill": {
        "apiKey": "xxx"
      }
    }
  }
}

Model Overrides

{
  "models": {
    "aliases": {
      "fast": "anthropic/claude-sonnet-4-5",
      "smart": "anthropic/claude-opus-4-5"
    },
    "failover": {
      "enabled": true,
      "fallbacks": ["openai/gpt-4o"]
    }
  }
}

Heartbeat

{
  "heartbeat": {
    "enabled": true,
    "intervalMinutes": 30
  }
}

These snippets are starting points - see full docs for all options.