.env.example

# 环境变量示例（可安全提交仓库）| Environment example (safe to commit)
#
# 中文：
# 1. 本地复制：`cp .env.example .env`；敏感项可再建 `.env.local`（已在 .gitignore）。
# 2. 不要把含真实 token 的 `.env` / `.env.local` 提交到 Git。
# 3. 不要在等号两侧加空格。
#
# English:
# 1. Local copy: `cp .env.example .env`; put secrets in `.env.local` (gitignored).
# 2. Never commit real tokens in `.env` / `.env.local`.
# 3. Do not put spaces around `=`.

# 应用模式 | App mode (minimal = stable single-machine default)
AUTORESEARCH_MODE=minimal

# 核心 API 运行时 | Core API runtime
AUTORESEARCH_API_ENV=dev
AUTORESEARCH_API_HOST=127.0.0.1
AUTORESEARCH_API_PORT=8001

# SQLite 存储 | SQLite storage
AUTORESEARCH_API_DB_PATH=artifacts/api/evaluations.sqlite3

# Telegram 管家 / Panel | Telegram butler / Panel
# 说明 | Notes:
# - AUTORESEARCH_TELEGRAM_BOT_USERNAMES = bot Telegram username without @
# - AUTORESEARCH_TELEGRAM_ALLOWED_UIDS = real numeric UIDs, comma-separated (no wildcards)
# - CHANNEL_KEY / SHARED_ASSISTANT_ID: use one stable slug where possible
AUTORESEARCH_TELEGRAM_BOT_TOKEN=1234567890:replace-with-real-bot-token
AUTORESEARCH_TELEGRAM_BOT_USERNAMES=linux_max_bot
AUTORESEARCH_TELEGRAM_SHARED_ASSISTANT_ID=telegram-linux-max
AUTORESEARCH_TELEGRAM_CHANNEL_KEY=telegram-linux-max
AUTORESEARCH_TELEGRAM_CHANNEL_DISPLAY_NAME=Linux Max Bot
AUTORESEARCH_TELEGRAM_ALLOWED_UIDS=123456789,987654321
# Mac worker 完成/编辑 Telegram 气泡时显示的前缀（【…】）；设为空字符串则不加前缀 | Display name prefix in Mac worker Telegram replies; empty disables 【…】
# AUTORESEARCH_TELEGRAM_WORKER_DISPLAY_NAME=初代worker
# 管家兜底：worker 未送达完成消息时由 API 用同一 bot 编辑/补发摘要（基于 metrics.telegram_notify_status 去重）| Butler-side completion fallback when the worker did not deliver
# AUTORESEARCH_TELEGRAM_BUTLER_FALLBACK_ENABLED=true
# 管家 API 在完成 report 后编辑进队气泡（worker 委托的完整卡片）| API edits queue-ack bubble after worker delegates card
# AUTORESEARCH_TELEGRAM_BUTLER_API_COMPLETION_ENABLED=true
# 运行中同气泡节流更新（Hermes RUNNING report → editMessageText）| Live ack edits while Hermes runs
# AUTORESEARCH_TELEGRAM_BUTLER_LIVE_UPDATES_ENABLED=true
# AUTORESEARCH_TELEGRAM_BUTLER_LIVE_INTERVAL_SECONDS=30
# 轮询到新行时也触发 worker RUNNING 上报（API 仍节流）| Also report on newline deltas (API still throttles)
# AUTORESEARCH_TELEGRAM_BUTLER_LIVE_ON_NEWLINE=false
# Hermes 任务在 prompt 末尾追加「结束时输出 EOF」说明（软约定）| Append EOF instruction to Hermes prompt
# AUTORESEARCH_TELEGRAM_HERMES_APPEND_EOF_INSTRUCTION=false
# Agent stdout/stderr 写入队列/结果的预览长度上限（1000–32000）| Max chars for agent stdout preview in run results
# AUTORESEARCH_AGENT_STDOUT_PREVIEW_LIMIT=16000
# 运行中写入仓库的 stdout 预览上限（1000–32000）| Max chars for live stdout preview while subprocess runs
# AUTORESEARCH_AGENT_STDOUT_LIVE_PREVIEW_LIMIT=8000
# 运行中刷新仓库预览的最小间隔秒（0.3–10）| Min seconds between live preview DB writes during agent run
# AUTORESEARCH_AGENT_LIVE_PERSIST_INTERVAL_SEC=1.0
# 启动日志里的 build 标识（不设则自动用 package 版本 + git 短 SHA）| Build stamp in API/worker startup logs; unset = version + short git sha
# AUTORESEARCH_BUILD_LABEL=0.2.0+local

# Telegram 管家执行后端：claude（默认）或 hermes（走 HermesRuntimeAdapter v1 契约）| Butler worker backend
# AUTORESEARCH_TELEGRAM_RUNTIME_ID=hermes
# Hermes profile name on disk (stock Hermes is usually `default`, not the Telegram “butler” product name)
# AUTORESEARCH_TELEGRAM_HERMES_PROFILE=default
# AUTORESEARCH_TELEGRAM_HERMES_TOOLSETS=shell,git
# AUTORESEARCH_TELEGRAM_HERMES_APPROVAL_MODE=manual

# Panel / Mini App（占位 URL，按你的隧道或域名替换）| Placeholder URLs — replace for your tunnel/domain
AUTORESEARCH_PANEL_BASE_URL=https://your-tunnel.example.invalid
AUTORESEARCH_PANEL_JWT_SECRET=replace-with-random-secret
AUTORESEARCH_TELEGRAM_MINI_APP_URL=https://your-tunnel.example.invalid/api/v1/panel/view

# Telegram webhook 验签（可选）| Optional webhook secret
AUTORESEARCH_TELEGRAM_SECRET_TOKEN=<RANDOM_32_PLUS_CHARS_SECRET>

# 可选：OpenAI 兼容 / Anthropic | Optional model providers
# OPENAI_API_KEY=sk-...
# OPENAI_BASE_URL=https://api.openai.com/v1
# GATEKEEPER_OPENAI_MODEL=gpt-5.4
# MAS_FACTORY_LLM_MODEL=gpt-5.4
OPENAI_API_KEY=your-openai-api-key
ANTHROPIC_API_KEY=your-anthropic-api-key

# 可选：upstream watcher | Optional upstream watcher
AUTORESEARCH_UPSTREAM_WATCH_URL=https://github.com/openclaw/openclaw.git
AUTORESEARCH_UPSTREAM_WATCH_WORKSPACE_ROOT=/Volumes/AI_LAB/ai_lab/workspace
AUTORESEARCH_UPSTREAM_WATCH_MAX_COMMITS=5

# 管理后台初始化 | Admin bootstrap
AUTORESEARCH_ADMIN_BOOTSTRAP_KEY=replace-with-admin-bootstrap-key
AUTORESEARCH_ADMIN_JWT_SECRET=replace-with-admin-jwt-secret

# Linux 远端 worker 起步（按需取消注释）| Linux remote worker (uncomment if needed)
# OPENHANDS_RUNTIME=host

# GitHub assistant 模板 | GitHub assistant template
GH_ASSISTANT_BOT_ACCOUNT=your-bot-account
GH_ASSISTANT_WORKSPACE_ROOT=/tmp/github-assistant
GH_ASSISTANT_EXECUTOR_ADAPTER=codex
GH_ASSISTANT_EXECUTOR_BINARY=codex
# GH_ASSISTANT_EXECUTOR=

# Hermes 运行时适配器（本机 CLI）| Hermes runtime adapter (local CLI)
# 中文：
# - 默认值 `hermes` 适合已把 Hermes 装进 PATH 的单机 macOS / Linux 环境。
# - 如需固定二进制或包装器，可写成完整命令，例如：`AUTORESEARCH_HERMES_COMMAND="/opt/hermes/bin/hermes --profile local"`
# - 当前 Hermes v1 只保证文本 prompt 闭环，不承诺 image / skill 注入语义。
#
# English:
# - The default `hermes` assumes the Hermes CLI is already on PATH for local macOS / Linux use.
# - To pin a wrapper or binary, provide a full command, for example: `AUTORESEARCH_HERMES_COMMAND="/opt/hermes/bin/hermes --profile local"`
# - Hermes v1 currently guarantees only the text-prompt runtime path; image / skill injection is not promised.
AUTORESEARCH_HERMES_COMMAND=hermes