templates/ts03-bot.env.example

# Copy to ~/.config/ts03-bot.env  ·  chmod 600  ·  never commit the real file (.gitignore covers *.env)
# Values from WhatsApp (ids) come from /whoami replies; see docs/11.

# ---------------------------------------------------------------- who controls the bot
# Owner = you. Full ts03 commands (read + write) via Claude Code + Sheets MCP.
# WhatsApp shows one person as <number>@c.us in DMs and often <lid>@lid in groups: list both.
OWNER_ID=
OWNER_ALIASES=
# Chats where members may ask questions (comma-separated group ids [email protected])
ALLOWED_CHATS=
# Where the daily digest goes (defaults to OWNER_ID); a group id posts it to the group
DIGEST_CHAT=

# ---------------------------------------------------------------- shown to members
BOT_BUILDER=Your Name
BOT_CONTACT=message the group admin
# Default reply format: chat (cards) | table | json | yaml
CHAT_FORMAT=chat

# ---------------------------------------------------------------- member safety + cost
SNAPSHOT_TTL_MIN=30          # members read a snapshot refreshed at most this often (/refresh forces it)
MEMBER_RATE_PER_HOUR=6       # per person
MEMBER_DAILY_CAP=150         # whole group
COOLDOWN_SECONDS=10
COMMAND_TIMEOUT=240
PUBLIC_MODEL=sonnet
# PUBLIC_DENY_EXTRA=NewTool  # only if `ts03-bot selftest` ever lists a tool
# CLAUDE_BIN=/Users/you/.local/bin/claude   # only if the bot can't find claude

# ---------------------------------------------------------------- Telegram (from @BotFather)
TG_TOKEN=

# ---------------------------------------------------------------- WhatsApp via WAHA
WAHA_URL=http://127.0.0.1:3100       # k3d host port (docs/11). Docker compose default is also 3100
WAHA_KEY=                            # openssl rand -hex 16
WAHA_SESSION=default
HOOK_SECRET=                         # openssl rand -hex 16 ; webhook path = /hook/<HOOK_SECRET>
HOOK_PORT=5055
HOOK_BIND=0.0.0.0

# The linked WhatsApp account itself (from GET /api/sessions -> me.id, me.lid).
# Used to recognise real @mentions of the bot.
SELF_IDS=
# Only when the bot runs on YOUR OWN number and you command it from "Message yourself"
ALLOW_SELF_CHAT=0

# ---- Jev router (optional, off by default; see docs/17-jev-router) ----
# TS03_ROUTER_KEY=your-key-here                     # never commit this file