.env.example

# SpoonBot Environment Configuration
# Copy this file to .env and fill in your values

# ======= LLM API Keys (at least one required) =======

# Anthropic Claude (recommended)
ANTHROPIC_API_KEY=sk-ant-your-anthropic-api-key-here

# OpenAI GPT
OPENAI_API_KEY=sk-your-openai-api-key-here

# DeepSeek
DEEPSEEK_API_KEY=your-deepseek-api-key-here

# Google Gemini
GEMINI_API_KEY=your-gemini-api-key-here

# ======= OpenRouter Configuration (two options) =======
#
# Option A (recommended): use the native openrouter provider
#   SPOON_BOT_DEFAULT_PROVIDER=openrouter
#   OPENROUTER_API_KEY=sk-or-your-openrouter-api-key-here
#
# Option B: use the openai provider with OpenRouter base URL
#   SPOON_BOT_DEFAULT_PROVIDER=openai
#   OPENAI_API_KEY=sk-or-your-openrouter-api-key-here
#   OPENAI_BASE_URL=https://openrouter.ai/api/v1
#
# Pick ONE option; do not mix them.
OPENROUTER_API_KEY=sk-or-your-openrouter-api-key-here

# ======= Web Search (optional, for web_search tool) =======

# DuckDuckGo is the default web_search provider and does not require an API key.
# Optional Tavily Search API (https://tavily.com, 1000 free credits/month)
# TAVILY_API_KEY=tvly-your-tavily-api-key-here

# ======= Optional Configuration =======

# Custom base URL for providers (e.g., local LLM servers)
# BASE_URL=https://your-custom-endpoint/v1

# Shell command timeout in seconds (default: 3600 = 60 minutes)
# SPOON_BOT_SHELL_TIMEOUT=3600

# ======= Session Persistence (optional, default: file) =======
#
# Backend options: file (JSONL, default), sqlite, postgres
# SESSION_STORE_BACKEND=file
#
# SQLite (zero-dependency, single file):
# SESSION_STORE_BACKEND=sqlite
# SESSION_STORE_DB_PATH=./workspace/sessions.db
#
# PostgreSQL (requires psycopg2-binary):
# SESSION_STORE_BACKEND=postgres
# SESSION_STORE_DSN=postgresql://user:password@localhost:5432/spoonbot

# ======= Context Window (optional, auto-resolved from model) =======
#
# Override the context window size in tokens.
# If not set, auto-resolved based on the model (default: 128000).
# Examples: 128000 (128K), 400000 (GPT-5.4 operational cap), 1000000 (1M).
# Preferred env var:
# SPOON_BOT_CONTEXT_WINDOW=400000
# Legacy alias (still supported):
# CONTEXT_WINDOW=400000

# ======= YOLO Mode (optional) =======
#
# When enabled, the agent operates directly in SPOON_BOT_WORKSPACE_PATH
# without sandbox isolation — all shell commands and file operations run
# against your real filesystem.  Useful for local dev workflows.
# SPOON_BOT_YOLO_MODE=false

# ======= Channel Bot Tokens (optional) =======
# Set these to auto-enable channels without needing config.yaml.
# If config.yaml also specifies a token, the YAML value takes priority.
#
# Telegram (get from @BotFather on Telegram)
# TELEGRAM_BOT_TOKEN=123456:ABC-DEF...
# TELEGRAM_USER_ID=123456789          # Your Telegram user ID (restricts access, get from @userinfobot)
#
# Discord (get from Discord Developer Portal → Bot → Token)
# DISCORD_BOT_TOKEN=your_discord_bot_token
# DISCORD_GUILD_ID=123456789012345678  # Your server ID (restricts to one server)
# DISCORD_USER_ID=123456789012345678   # Your user ID (restricts access)
#
# Feishu / Lark (get from Feishu Open Platform)
# FEISHU_APP_ID=your_app_id
# FEISHU_APP_SECRET=your_app_secret
# FEISHU_VERIFICATION_TOKEN=your_verification_token
# FEISHU_ENCRYPT_KEY=your_encrypt_key


# ======= Web3 Configuration (optional, for blockchain features) =======

# Wallet private key (keep this secure!)
# PRIVATE_KEY=your-wallet-private-key-here

# RPC and network configuration
# ETHEREUM_RPC_URL=https://rpc.ankr.com/eth
# RPC_URL=https://mainnet-1.rpc.banelabs.org
# SCAN_URL=https://xt4scan.ngd.network/
# CHAIN_ID=47763