接入 OpenClaw

将 OpenClaw 连接到 Puyun AI，为个人 AI 助手、消息渠道和 MCP 工具提供统一模型入口。

安装 OpenClaw

OpenClaw 需要 Node.js 22 或更高版本：

bash
node --version

macOS / Linux 推荐使用安装脚本：

bash
curl -fsSL https://openclaw.ai/install.sh | bash

也可以使用 npm：

bash
npm install -g openclaw@latest

Windows PowerShell：

powershell
iwr -useb https://openclaw.ai/install.ps1 | iex

首次安装时可以在向导中选择 Skip for now，稍后手动配置 Puyun AI 模型。

手动配置

OpenClaw 配置文件位于 ~/.openclaw/openclaw.json。如果你已有钉钉、飞书、微信、QQ 或 MCP 配置，请只合并 models.providers.puyunai 这一段，不要全量覆盖旧配置。

最小配置示例：

json
{
  "models": {
    "mode": "merge",
    "providers": {
      "puyunai": {
        "baseUrl": "https://ai.tracup.com",
        "apiKey": "sk-your-api-key",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "claude-sonnet-4-6",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
          },
          {
            "id": "gpt-4o",
            "name": "gpt-4o",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 128000,
            "maxTokens": 4096,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
          },
          {
            "id": "deepseek-chat",
            "name": "deepseek-chat",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 128000,
            "maxTokens": 8192,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
          }
        ]
      }
    }
  }
}

保存后重启网关：

bash
openclaw gateway restart

验证配置

进入 OpenClaw 终端界面：

bash
openclaw tui

输入：

text
/model

选择 Puyun AI provider 下的模型。如果能正常发起对话，说明配置成功。

常见问题

已有渠道配置，如何避免覆盖

不要把示例 JSON 整体复制到已有文件中。只需要把 puyunai provider 合并到现有的 models.providers 下，并保留原有 channels、plugins、agents 等配置。

401 或 No API key found

检查 apiKey 是否完整，并确认 OpenClaw 没有读取历史缓存。必要时删除 ~/.openclaw/agents/main/agent/models.json 中旧的 provider 缓存后重启。

Base URL 怎么填

OpenClaw 的 api 设置为 anthropic-messages 时，baseUrl 填写 https://ai.tracup.com，不要添加 /v1。