配置指南
本文档详细介绍 OpenHuman 的所有配置选项。
配置文件
OpenHuman 使用 config.toml 配置文件：
# config.toml
[app]
name = "OpenHuman"
version = "1.0.0"
[ai]
chat_model = "claude-sonnet-4-20250514"
reasoning_model = "claude-sonnet-4-20250514"
vision_model = "claude-sonnet-4-20250514"
[local_ai]
enabled = false
provider = "ollama"
ollama_url = "http://localhost:11434"
embedding_model = "all-minilm:latest"
memory_model = "gemma3:1b-it-qat"
[core]
mode = "local"
[search]
searxng_enabled = false
searxng_base_url = "http://localhost:8080"
max_results = 3
环境变量
必需变量
OPENHUMAN_API_KEY=sk_xxx # 从控制台获取
可选变量
OPENHUMAN_BASE_URL=https://api.tinyhumans.ai # 默认值
OPENHUMAN_MODEL_CHAT=claude-sonnet-4-20250514
OPENHUMAN_MODEL_REASONING=claude-sonnet-4-20250514
OPENHUMAN_TRIGGER_TRIAGE_DISABLED=false
OPENHUMAN_AUTO_FETCH_ENABLED=true
AI 配置
模型选择
| 模型 | 用途 | 推荐场景 |
|---|---|---|
claude-sonnet-4-20250514 | 日常对话、写作 | 默认推荐 |
claude-opus-4-20250514 | 复杂推理、代码 | 复杂任务 |
claude-haiku-4-20250514 | 快速响应 | 简单任务 |
模型路由
[model]
chat = "claude-sonnet-4-20250514"
reasoning = "claude-opus-4-20250514"
vision = "claude-sonnet-4-20250514"
本地 AI 配置
[local_ai]
enabled = true
provider = "ollama"
[local_ai.ollama]
url = "http://localhost:11434"
embedding_model = "all-minilm:latest"
memory_model = "gemma3:1b-it-qat"
heartbeat_model = "gemma3:1b-it-qat"
[local_ai.lm_studio]
url = "http://localhost:1234"
Core 配置
本地 Core
[core]
mode = "local"
远程 Core
[core]
mode = "remote"
rpc_url = "https://your-core.example/rpc"
token = "your-core-token"
搜索配置
SearXNG 自托管
[searxng]
enabled = true
base_url = "http://localhost:8080"
max_results = 10
default_language = "en"
timeout_seconds = 10
集成配置
Gmail
[integrations.gmail]
enabled = true
sync_interval = "5m"
max_results = 50
Slack
[integrations.slack]
enabled = true
workspace_id = "T0123456789"
channel_sync = ["C0123456789"]
Notion
[integrations.notion]
enabled = true
database_ids = ["xxx", "yyy"]
sync_interval = "15m"
日志配置
[logging]
level = "info" # debug, info, warn, error
format = "json" # json, text
output = "file" # file, stdout
[logging.file]
path = "./logs/openhuman.log"
max_size = "100mb"
max_backups = 5
安全配置
[security]
encrypt_local_data = true
require_auth_for_api = true
api_key_prefix = "sk_"
[security.rate_limit]
enabled = true
requests_per_minute = 60
burst = 10