桌面 AI 助手

在 Trae、WorkBuddy、悟空、OpenClaw 等桌面应用中使用自定义模型,通过 GUI 设置或配置文件接入网关。

通用环境变量

部分桌面应用支持通过环境变量配置 API Key 和 Base URL:

.env
# 所有支持环境变量的工具通用配置
export OPENAI_API_KEY="sk-your-api-key"
export OPENAI_API_BASE="https://api.example.com/v1"

Trae

字节跳动 AI IDE,内置多家模型提供商。目前不支持自定义 Base URL,仅能使用预定义 Provider 的官方端点。

GUI 配置OpenAI

安装

从 trae.ai 下载安装。

配置步骤

  1. 1

    安装 Trae

    从官网下载对应平台的安装包并安装。

    terminal
    # 从官网下载安装
    # https://www.trae.ai
  2. 2

    添加模型提供商

    在 Settings → Models → Add Model 中选择预定义的 Provider(如 OpenAI、Anthropic、DeepSeek 等)。

    Trae 设置
    操作步骤:
    1. 打开 Settings → Models → Add Model
    2. 选择 Provider(支持 OpenAI、Anthropic、DeepSeek、阿里云等)
    3. 填入对应 Provider 的 API Key
    4. 模型名会根据 Provider 自动填充
  3. 3

    局限性说明

    ⚠️ Trae 目前不支持自定义 Base URL,无法直接对接 千木(SilvaMux)。

    terminal
    # 当前限制
    # - 不支持自定义 Base URL
    # - 仅能使用预定义 Provider 的官方端点
    # - 如需使用自建网关,需关注后续版本更新
    #
    # 跟踪进展:关注 Trae 官方 GitHub Issue

    这是社区高频需求,可关注 Trae 官方 GitHub 获取自定义 Base URL 支持的最新进展。

注意事项

  • 目前不支持自定义 Base URL(社区高频需求,待官方支持)
  • 仅支持预定义 Provider 的官方端点(OpenAI、Anthropic、DeepSeek 等)

WorkBuddy

腾讯桌面 AI 助手,通过 models.json 配置文件添加自定义模型,支持 CodeBuddy(VS Code 版)和 WorkBuddy(桌面版)。

配置文件OpenAI

安装

从腾讯官网下载 WorkBuddy,或在 VS Code 扩展市场安装 CodeBuddy。

配置步骤

  1. 1

    安装 WorkBuddy / CodeBuddy

    下载桌面版或在 VS Code 安装扩展版。

    terminal
    # 桌面版:从腾讯官网下载安装
    # VS Code 扩展版:在扩展市场搜索 "CodeBuddy"
  2. 2

    创建模型配置文件

    WorkBuddy 桌面版配置路径为 ~/.workbuddy/models.json(用户级)或 <workspace>/.workbuddy/models.json(项目级)。CodeBuddy(VS Code 版)配置路径为 ~/.codebuddy/models.json。项目级配置优先于用户级。

    ~/.workbuddy/models.json
    {
      "models": [
        {
          "id": "deepseek-v3.2",
          "name": "DeepSeek V3.2",
          "vendor": "DeepSeek",
          "apiKey": "sk-your-api-key",
          "url": "https://api.example.com/v1/chat/completions",
          "maxInputTokens": 128000,
          "maxOutputTokens": 8192,
          "supportsToolCall": true
        },
        {
          "id": "claude-sonnet-4-20250514",
          "name": "Claude Sonnet 4",
          "vendor": "Anthropic",
          "apiKey": "sk-your-api-key",
          "url": "https://api.example.com/v1/chat/completions",
          "maxInputTokens": 200000,
          "maxOutputTokens": 8192,
          "supportsToolCall": true
        }
      ],
      "availableModels": ["deepseek-v3.2", "claude-sonnet-4-20250514"]
    }

    URL 必须写完整路径,以 /chat/completions 结尾。

  3. 3

    使用模型

    修改配置后,CodeBuddy 会热加载(约 1 秒),WorkBuddy 桌面版需重启才能生效。

    terminal
    # CodeBuddy(VS Code 版)
    # 修改 models.json 后自动热加载,无需重启
    # 在 CodeBuddy 面板的模型选择器中选择配置的模型
    
    # WorkBuddy(桌面版)
    # 修改 models.json 后需重启 WorkBuddy

注意事项

  • URL 必须写完整路径,以 /chat/completions 结尾
  • WorkBuddy 桌面版配置路径:~/.workbuddy/models.json
  • CodeBuddy(VS Code 版)配置路径:~/.codebuddy/models.json
  • 项目级配置优先于用户级配置
  • 修改后 CodeBuddy 热加载(1s),WorkBuddy 桌面版需重启
  • API Key 以明文存储在配置文件中,注意安全

悟空

阿里钉钉 AI 原生工作平台,支持 GUI 配置自定义模型,兼容 OpenClaw Skill 生态(26000+ 社区技能)。

GUI 配置OpenAI + Anthropic

安装

从钉钉应用市场搜索 "悟空" 或从官网下载。

配置步骤

  1. 1

    安装悟空

    在钉钉应用市场搜索 "悟空" 安装,或从官网下载桌面客户端。

    terminal
    # 方式一:钉钉客户端
    # 打开钉钉 → 搜索 "悟空" → 添加应用
    
    # 方式二:桌面客户端
    # 从官网下载独立客户端
  2. 2

    添加自定义模型

    通过左下角头像进入模型设置,点击 "添加自定义模型",填写网关信息。

    悟空 设置
    操作步骤:
    1. 打开悟空客户端
    2. 点击左下角头像 → 设置 → 模型
    3. 点击 "添加自定义模型"
    4. 填写配置:
       - API Key: sk-your-api-key
       - API 代理地址: https://api.example.com/v1
       - 模型名称: deepseek-v3.2
    5. 保存并测试

    自定义模型需要悟空 Premium(99 元/月)才能使用。API Key 必须为单行格式,不能含换行符或空格。

  3. 3

    使用模型

    配置完成后,在对话界面选择自定义模型即可使用。内置模型(通义千问等)无需配置即可使用。

    悟空
    # 在对话界面切换模型
    # 点击模型选择器 → 选择你配置的自定义模型
    #
    # 支持的能力:
    # - 多轮对话
    # - 代码生成
    # - OpenClaw Skill 生态(26000+ 社区技能)

注意事项

  • 支持 OpenAI、Claude、Gemini 等多种协议的自定义接入
  • 自定义模型功能需要悟空 Premium(99 元/月)
  • API Key 必须为单行格式,不能含换行符或空格
  • 内置模型(通义千问等)无需配置即可使用
  • 兼容 OpenClaw Skill 生态(26000+ 社区技能)

OpenClaw

开源 AI Agent 平台(356k+ stars),同时支持 OpenAI 和 Anthropic 协议,支持 API Key 轮换和多 Provider 插件。

配置文件OpenAI + Anthropic

安装

terminal
npm install -g openclaw@latest

配置步骤

  1. 1

    安装 OpenClaw

    通过 npm 全局安装 OpenClaw CLI,然后运行 onboard 完成初始化。

    terminal
    npm install -g openclaw@latest
    
    # 首次使用需运行 onboard 安装守护进程
    openclaw onboard --install-daemon
  2. 2

    创建配置文件

    在 ~/.openclaw/openclaw.json 创建配置。可以同时配置 OpenAI 和 Anthropic 两种协议的 Provider。

    ~/.openclaw/openclaw.json
    {
      "models": {
        "mode": "merge",
        "providers": {
          "silvamux-gateway-openai": {
            "baseUrl": "https://api.example.com/v1",
            "apiKey": "${SILVAMUX_API_KEY}",
            "api": "openai-completions",
            "models": [
              { "id": "deepseek-v3.2", "name": "DeepSeek V3.2", "contextWindow": 128000 },
              { "id": "claude-sonnet-4-20250514", "name": "Claude Sonnet 4", "contextWindow": 200000 }
            ]
          },
          "silvamux-gateway-anthropic": {
            "baseUrl": "https://api.example.com",
            "apiKey": "${SILVAMUX_API_KEY}",
            "api": "anthropic-messages",
            "models": [
              { "id": "claude-sonnet-4-20250514", "name": "Claude Sonnet 4", "contextWindow": 200000 }
            ]
          }
        }
      }
    }

    API Key 使用 ${ENV_VAR} 引用环境变量,避免在配置文件中明文存储。设置环境变量:export SILVAMUX_API_KEY="sk-your-api-key"

  3. 3

    设置环境变量

    将 API Key 设置为环境变量(与配置文件中的引用对应)。

    ~/.zshrc
    # 添加到 ~/.zshrc 或 ~/.bashrc
    export SILVAMUX_API_KEY="sk-your-api-key"
    
    # 使配置生效
    source ~/.zshrc
  4. 4

    启动 OpenClaw

    在项目目录下启动 OpenClaw。

    terminal
    # 进入项目目录
    cd /path/to/your/project
    
    # 启动 OpenClaw
    openclaw

注意事项

  • 同时支持 openai-completions 和 anthropic-messages 两种协议
  • API Key 支持 ${ENV_VAR} 环境变量引用
  • 支持 API Key 轮换(多 Key、限流感知故障转移)
  • 75+ 内置 Provider 插件,支持本地模型自动发现