Config

Tailor Your Experience

MaestroBot isn't rigid. Its personality and tools are completely modular and customizable via a simple config.toml file. Rename config.example.toml and craft your perfect bot.

Assistant Personality

Shape exactly how the Agent behaves, talks, and identifies itself.

ASSISTANT_NAME

Give your bot a unique, personalized name (e.g., "Maestro").

ASSISTANT_ANIMAL & PURE_ANIMAL

Define its core persona (e.g., "tuxedo cat", "cat").

ANTHROPIC_MODEL

Specify the precise Claude model to power the engine (e.g., claude-sonnet-4-5-20250929).

ASSISTANT_ATTRIBUTES

Set its tone and conversational style (e.g., "friendly, highly witty, and clever").

ANIMAL_GUIDANCE

Direct its specific conversational quirks (e.g., "occasional purrs, meows, or feline puns").

ASSISTANT_OWNER_NAME

Dictate exactly how the bot should address you.

Modular Tools Status

Every utility feature is completely modular. Keep your bot lightweight and focused.

# Inside your config.toml
["Tools Status"]
youtube = true
birthday = false # Instantly disable unwanted features
calendar = true

Guest Users & Roles

You can allow trusted friends to interact with your bot by adding [[Guests]] blocks for each user.

  • id: The Discord User ID of the trusted guest.
  • agent: Set to true to allow the guest to utilize Claude's processing power.
  • admin: Set to true to grant high-level admin access (excludes sensitive billing tools).
  • confirm: If granting admin access, you must explicitly include a confirmation string acknowledging the risks.

Custom Emojis

In the [EMOJIS] section, swap out default unicode emojis for custom server emojis to perfectly match your server's aesthetic!

General Integrations

Configure RESEND_PERSONAL_DOMAIN for primary emails, RESEND_SPECIAL_DOMAIN for secondary tasks, and JULES_ACCOUNT_POSITION for precise GitHub automation.

Next: View Security Protocols