Skip to content

🛠️ Opencode & OpenClaw 接入指南

对于追求极致定制化的极客用户,OpencodeOpenClaw 提供了强大的模型路由和网关功能。本教程将指导您如何配置这两个工具,使其通过 Old Dog AI 调用全球顶尖模型。


🟢 第一部分:Opencode 配置教程

Opencode 是一款基于 AI SDK 的高效命令行工具。它不直接读取环境变量,而是依赖于一个专门的 JSON 配置文件。

1. 创建配置文件

在您的用户主目录下新建一个名为 opencode.json 的文件。

  • Windows 路径: C:\Users\<您的用户名>\opencode.json
  • macOS / Linux 路径: ~/.opencode.json

2. 编写配置内容

打开该文件,粘贴以下内容(请将 sk-xxxx 替换为您在 Old Dog AI 生成的密钥):

json
{
  "models": {
    "claude-sonnet-4-6": {
      "name": "Sonnet 4.6"
    },
    "claude-opus-4-6": {
      "name": "Opus 4.6"
    },
    "gpt-5.2": {
      "name": "GPT-5.2"
    }
  },
  "npm": "@ai-sdk/anthropic",
  "options": {
    "apiKey": "sk-您的专属API_KEY",
    "baseURL": "[https://api.olddog.shop/v1](https://api.olddog.shop/v1)"
  }
}

3. 设置系统环境变量 (核心步骤)

OpenCode 必须通过环境变量知道配置文件的具体位置,否则无法加载:

  1. 变量名OPENCODE_CONFIG

  2. 变量值:填写您刚才创建的文件的完整路径(例如 C:\Users\Administrator\opencode.json)。

  3. 生效:设置完成后,请务必重启您的终端(PowerShell 或 CMD)。

4. 登录鉴权与验证

在终端中依次运行以下命令:

  1. 登录命令opencode auth login

  2. Provider ID:输入 olddog(或自定义名称)。

  3. 选择类型:选择 Other

  4. 验证模型:进入 opencode 界面后,输入 /models。如果您能看到配置的 Sonnet 4.6 等模型,说明接入成功!


🔵 第二部分:OpenClaw 配置教程

OpenClaw 允许您通过 Web UI 或命令行深度定制模型路由。按照以下步骤修改配置文件,即可将您的本地网关指向 Old Dog AI

1. 进入配置界面

您可以通过以下任一方式打开配置文件:

  • 方式一(Web UI 推荐):在终端运行 openclaw dashboard 打开管理面板,点击左侧菜单栏的 Config > Raw

  • 方式二(终端编辑):直接运行 nano ~/.openclaw/openclaw.json 进入编辑模式。

2. 修改 JSON 配置文件

请将以下 JSON 内容粘贴到配置编辑器中(请务必将 sk-xxxx 替换为您自己的密钥):

JSON
{
    "gateway": {
        "mode": "local"
    },
    "agents": {
        "defaults": {
            "model": {
                "primary": "olddog/claude-sonnet-4-6"
            },
            "models": {
                "olddog/claude-sonnet-4-6": {},
                "olddog/claude-opus-4-6": {},
                "olddog/gpt-5.2": {}
            }
        }
    },
    "models": {
        "mode": "merge",
        "providers": {
            "olddog": {
                "baseUrl": "https://api.olddog.shop",
                "apiKey": "sk-您的专属API_KEY",
                "api": "anthropic-messages",
                "models": [
                    {
                        "id": "claude-sonnet-4-6",
                        "name": "claude-sonnet-4-6",
                        "reasoning": false,
                        "contextWindow": 200000,
                        "maxTokens": 64000
                    },
                    {
                        "id": "claude-opus-4-6",
                        "name": "claude-opus-4-6",
                        "reasoning": true,
                        "contextWindow": 200000,
                        "maxTokens": 128000
                    }
                ]
            }
        }
    }
}

3. 保存并激活配置

  • Web UI 操作:点击右上角的 Save 保存,然后点击 Update 使配置立即生效。

  • 终端操作:保存文件并退出后,运行以下命令重启网关:

    Bash
    openclaw gateway restart

📚 更多极客工具参考资料

如果您需要更深入的研究,可以参考各工具的官方文档: