Provider、模型与智能路由

SeekClaw 把“服务地址与凭据”和“模型能力”都作为可编辑配置。默认配置提供常用服务模板，你可以在 Desktop、CLI 或 ~/.seekclaw/config.json 中增加任何兼容服务。

协议与预置 Provider

Runtime 当前实现两种线协议：

• anthropic：Anthropic Messages API；
• openai：OpenAI Chat Completions API，也用于所有 OpenAI-compatible 服务。

首次初始化的模板包括：

DeepSeek、Azure OpenAI、企业网关或其他兼容服务可以通过新增 kind: "openai" 的 Provider 接入。模型 ID、上下文窗口、最大输出、能力标签与价格均属于用户配置，不被 Runtime 写死。

在 Desktop 中配置

进入“设置 → 模型与 Provider”，可以管理 Provider、Profile 与模型目录：

1. 点击“+ Provider”或编辑现有项。
2. 选择 openai 或 anthropic 协议，填写 ID、名称、Base URL 和模型 ID。
3. 直接填写 API Key；该 Key 会保存到配置文件中。
4. 根据需要配置代理、超时、优先级、提示词缓存和启用状态。
5. 保存后点击“测试”；确认可用后切换活动 Provider 或模型。

apiKey 直接写入配置文件，由 Desktop 读取、显示和修改。Runtime 不会从环境变量读取 API Key。

请求失败时，Runtime 会保留 Provider 名称、HTTP 状态和响应正文。例如协议不兼容、工具调用消息缺少对应结果、模型 ID 错误等 400 响应会完整展示，方便按服务端提示修复。

配置文件结构

Provider 是数组，模型属于对应 Provider：

{
  "activeProfile": "default",
  "profiles": {
    "default": { "provider": "deepseek", "model": "deepseek-chat", "strategy": "balanced" }
  },
  "providers": [
    {
      "id": "deepseek",
      "name": "DeepSeek",
      "kind": "openai",
      "baseUrl": "https://api.deepseek.com/v1",
      "apiKey": "your-api-key",
      "promptCaching": true,
      "enabled": true,
      "priority": 0,
      "timeoutSeconds": 120,
      "models": [
        {
          "id": "deepseek-chat",
          "contextWindow": 128000,
          "maxOutput": 8192,
          "capabilities": { "streaming": true, "toolCalling": true }
        }
      ]
    }
  ]
}

需要直接保存 Key 时可使用 "apiKey": "sk-..."，但不要把包含凭据的个人全局配置提交到仓库。

promptCaching 默认启用。OpenAI-compatible 服务使用服务端的自动前缀缓存；Anthropic 协议还会在稳定的 System Prompt 和工具定义后写入 cache_control 检查点。若某个旧的 Anthropic-compatible 网关不接受该字段，可在 Desktop 中关闭此项或设置 "promptCaching": false。默认 Prompt 不包含动态时间，工具定义也会按名称稳定排序，避免每轮请求改变缓存前缀。

Profile 与路由

Profile 可固定 Provider / 模型，也可以只指定策略让 Runtime 构建候选链。默认策略为：

• fast：低延迟；
• balanced：质量、速度和成本的平衡；
• quality：优先高能力模型；
• cheap：优先低成本模型；
• offline：优先 Ollama 或 LM Studio。

默认负载方式是 priority。候选请求支持指数退避、最大尝试次数、熔断阈值和冷却时间。首个流式 Token 到达后，Runtime 不会在同一回答中途切换 Provider，以避免拼接两个模型的输出。

CLI 管理

# 查看 Provider
seekclaw provider list

# 添加 OpenAI-compatible Provider
seekclaw provider add --id deepseek --kind openai \
  --api-key "sk-..." \
  --base-url "https://api.deepseek.com/v1" \
  --model "deepseek-chat"

# 检查连通性
seekclaw provider test deepseek

# 查看模型与累计用量
seekclaw model list
seekclaw usage

完整字段见 配置参考，连接问题见 常见问题与排错。