附录 C：配置参考

本附录以当前 ../octos main 分支的 octos-cli/src/config.rs、octos-cli/src/profiles.rs 和 octos-agent hook/schema 为准。顶层 config.json 面向单实例运行；profile 文件面向 serve/gateway 的多 profile / 多租户运行。

配置文件位置

顶层 Config 字段

Gateway 配置

Serve 配置

serve 的端口是 CLI 参数而非 Config 内嵌字段：octos serve --port <PORT>，默认端口为 50080。历史文档中的 serve.host / serve.port 不是当前 Config 结构体字段。

Provider / Embedding / Routing

Tool Policy / MCP / Hooks

Credential / Email / Voice / AppUI

Dashboard Auth / Monitor

这些字段只在启用 api feature 的 octos serve 构建中生效。未配置 dashboard_auth.smtp 时，OTP 仍可生成，但邮件发送会退化为日志提示。

Profile 配置

Profile 文件位于 ~/.octos/profiles/<id>.json。UserProfile 顶层字段包括 id、name、public_subdomain、enabled、data_dir、parent_id、config、created_at、updated_at。子账号通过 parent_id 继承父 profile 的 LLM contract 和低层 env vars。

当前主分支的 profile LLM 配置不再是旧的顶层 provider / model，而是放在 config.llm 下：

Profile 还包含 typed sections：search.providers、deep_crawl.page_settle_ms/max_output_chars、apps.slides、robot.realtime、channels[]、gateway、email、env_vars、hooks[]、admin_mode、sandbox、adaptive_routing、cost_budget、matrix.swarm_supervisor、content_routing、credential_pool。

示例配置

{
  // 当前配置版本；缺省也可由迁移逻辑处理
  "version": 1,
  // 主 LLM provider / model
  "provider": "anthropic",
  "model": "claude-sonnet-4-20250514",
  // API key env 覆盖
  "api_key_env": "ANTHROPIC_API_KEY",
  // 单 turn 最大 Agent 迭代数
  "max_iterations": 30,
  // 全局工具策略，deny 优先
  "tool_policy": {
    "deny": ["browser"]
  },
  // 针对特定 provider 的工具策略
  "tool_policy_by_provider": {
    "ollama": {
      "allow": ["read_file", "shell", "grep"]
    }
  },
  // Gateway 运行时配置
  "gateway": {
    "max_concurrent_sessions": 20,
    "queue_mode": "collect",
    "channels": [
      {
        "type": "telegram",
        "allowed_senders": [],
        "settings": { "token_env": "TELEGRAM_BOT_TOKEN" }
      }
    ]
  },
  // MCP server 配置
  "mcp_servers": [
    {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"],
      "env": {}
    }
  ],
  // Hook 使用 argv 数组，不经过 shell
  "hooks": [
    {
      "event": "before_tool_call",
      "command": ["./audit-hook.sh"],
      "timeout_ms": 3000,
      "tool_filter": ["shell"]
    }
  ],
  // AdaptiveRouter 配置
  "adaptive_routing": {
    "enabled": true,
    "mode": "lane",
    "qos_ranking": true
  },
  // AppUI session 默认 cwd
  "appui": {
    "default_session_cwd": "/workspace"
  }
}