配置参考

SeekClaw 使用全局配置保存 Provider、模型、Profile、路由和 Agent 默认值，并允许工作区提供少量覆盖项。Desktop 与 CLI 操作的是同一份配置。

文件位置

首次运行时，Runtime 使用代码内建的默认配置（DefaultSeekClawConfig）自动序列化生成 ~/.seekclaw/config.json，仓库不再维护静态的默认配置文件。Provider 与模型数据随后完全由用户管理。

全局配置结构

下面示例使用当前实际字段：

{
  "activeProfile": "default",
  "profiles": {
    "default": {
      "provider": "openai",
      "model": "gpt-5.5",
      "strategy": "balanced",
      "temperature": 0.2,
      "mode": "edit"
    }
  },
  "providers": [
    {
      "id": "openai",
      "name": "OpenAI",
      "kind": "openai",
      "baseUrl": "https://api.openai.com/v1",
      "proxy": null,
      "timeoutSeconds": 120,
      "headers": null,
      "enabled": true,
      "priority": 1,
      "models": [
        {
          "id": "gpt-5.5",
          "alias": null,
          "contextWindow": 400000,
          "maxOutput": 128000,
          "capabilities": {
            "streaming": true,
            "thinking": false,
            "vision": true,
            "image": false,
            "toolCalling": true,
            "jsonMode": true,
            "reasoning": true,
            "maxReasoningLevel": "XHigh",
            "embedding": false,
            "mcp": true
          },
          "inputPricePerMTok": 1.25,
          "outputPricePerMTok": 10,
          "tags": ["balanced", "quality"]
        }
      ]
    }
  ],
  "routing": {
    "failoverEnabled": true,
    "strategies": {
      "balanced": ["openai/gpt-5.5"]
    },
    "fallback": ["openai/gpt-5.5"],
    "loadBalance": "priority",
    "retry": {
      "maxAttempts": 3,
      "baseDelaySeconds": 1,
      "maxDelaySeconds": 20,
      "circuitBreakThreshold": 4,
      "circuitCooldownSeconds": 60
    }
  },
  "agent": {
    "maxSteps": 40,
    "autoVerify": true,
    "maxRepairAttempts": 3,
    "enableContextCompaction": true,
    "maxOutputContinuations": 6,
    "mode": "edit",
    "systemPrompt": "system/default",
    "thinkingBudgetTokens": 16384,
    "reasoningLevel": "High",
    "maxToolOutputChars": 60000,
    "bashTimeoutSeconds": 180,
    "scheduledTurnTimeoutSeconds": 1800
  },
  "mcp": {
    "servers": {}
  }
}

thinkingBudgetTokens 是思考预算的基数，实际预算还会随思考深度档位放大（高×2、最大×4、极高×8、超级×16），并仅受模型 maxOutput 减去少量答案预留空间的限制——长任务不会被强限制在输出窗口的一半，避免思考到一半被强制截断。enableContextCompaction 开启后，当历史接近上下文上限时，Agent 会先把较早的对话总结成阶段性记忆（压缩上下文），再继续执行。当单次输出达到模型 maxOutput 上限（finish_reason 为 length/max_tokens）时，Agent 会自动继续下一轮而不是结束回合，空输出时会提示模型直接产出内容；连续截断超过 maxOutputContinuations（默认 6）次才会停止并给出明确警告。

Provider Key

• kind 只能是 openai 或 anthropic。
• apiKey 直接保存凭据；Desktop 会直接显示和编辑该值。Runtime 只读取配置文件中的 apiKey，不会从环境变量读取 API Key。
• organization、proxy、headers、timeoutSeconds 可按服务需要设置。
• promptCaching 默认启用；Anthropic 协议会发送原生缓存检查点，不兼容的第三方网关可关闭。
• reasoningEffortMap 可覆盖统一档位到 Provider 参数的映射，例如 { "ultra": "xhigh" }。
• agent.reasoningLevel 是 CLI/旧客户端的默认档位；Desktop 会把档位作为 Session 元数据独立保存。
• capabilities.maxReasoningLevel 声明模型支持的最高档位。默认是 Max，超过后自动降级；DeepSeek 的 XHigh 与 Ultra 固定降级为 Max。

路由

loadBalance 支持 priority、roundRobin、leastUsed、lowestCost、fastest 与 sticky。strategies 和 fallback 中的每个项目必须是 provider/model 引用。

failoverEnabled（默认 true）控制失败转移：开启时激活模型请求失败后会自动按路由链尝试其他候选模型；关闭时只使用激活模型，失败即停止并直接返回该模型的真实错误，不会静默切换到其他 Provider/模型（适合只使用本地模型的场景）。

Agent 模式

mode 支持 edit、plan、readonly 与 auto。Profile 中的值可以覆盖 Agent 默认值，工作区还可以再次覆盖。

工作区覆盖

<workspace>/.seekclaw/config.json 使用独立的精简结构，而不是复制完整全局配置：

{
  "provider": "openai",
  "model": "gpt-5.5",
  "strategy": "quality",
  "temperature": 0.2,
  "mode": "edit",
  "systemPrompt": "system/default",
  "disabledSkills": ["legacy-migration"],
  "disabledTools": [],
  "autoVerify": true,
  "verifyCommand": "dotnet test",
  "mcp": { "servers": {} }
}

重新加载行为

Desktop 通过 Daemon 管理接口保存时，会立即更新该 Daemon 持有的配置。CLI 命令会持久化文件，后续 CLI 进程会读取新值；已经在运行的另一个 Daemon 不会自动感知这次外部修改。若在 CLI 或编辑器中改动 JSON，请重新连接 / 重启已有 Daemon，或通过对应管理接口更新。Prompt 文件的热加载与配置文件是不同机制。

配置 JSON 损坏时，Runtime 会保留原文件用于检查，并回退到种子默认配置；先修复原文件再重启，避免无意保存回退结果。