OpenClaw

使用 SurgeAI API 配合 OpenClaw - 您的个人 AI 助手

什么是 OpenClaw？

OpenClaw 是一个运行在您自己设备上的个人 AI 助手。它可以连接到各种消息平台（Telegram、Discord、Slack、WhatsApp 等），并可以通过我们的 API 配置使用 SurgeAI 的强大 AI 模型。

💡 提示：通过 SurgeAI 的统一 API，OpenClaw 可以访问 160+ AI 模型，包括 OpenAI、Google、Anthropic、DeepSeek 等顶级提供商——只需一个 API Key。

安装和配置 OpenClaw

步骤 1：获取 SurgeAI API Key

访问 surgeai.one 并注册或登录。

进入 控制台 并创建新的 API Key（sk-xxxxx）。

妥善保管此密钥——下一步需要用到。

⚠️ 注意：请妥善保管您的 API Key，切勿公开分享。请像对待密码一样对待它。

步骤 2：安装 OpenClaw

📖 详细的安装指南，请参考官方文档。

前置条件： Node.js 22 或更新版本

安装 OpenClaw 最简单的方式是使用官方安装脚本：

macOS/Linux：

Windows (PowerShell)：

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

步骤 3：设置 OpenClaw

运行安装命令后，设置向导会自动启动。如果没有启动，请运行：

如果您之前已经初始化过，可以运行 openclaw config 并选择 model 重新配置。

开始设置：

I understand this is powerful and inherently risky. Continue? | 选择 ● Yes

Onboarding mode | 选择 ● Quick Start

Model/auth provider | 选择 ● Skip for now

Filter models by provider | 选择 ● anthropic

Default model | 选择 ● Keep current

根据您的偏好完成其余配置。

💡 提示：选择 Skip for now 作为模型/认证提供商很重要——这样您就可以在下一步手动配置 SurgeAI 的自定义模型参数，而不是被锁定在预配置的提供商中。

步骤 4：配置 SurgeAI 模型

要配置自定义模型，请编辑 ~/.openclaw/openclaw.json。您可以使用任何文本编辑器打开它：

1. 添加 SurgeAI 提供商配置

在 models.providers 下添加以下内容。如果您跳过了初始化，models 部分可能还不存在——请手动添加。将 YOUR_SURGEAI_KEY 替换为步骤 1 中的 API Key。

{
  "models": {
    "mode": "merge",
    "providers": {
      "surgeai": {
        "baseUrl": "https://surgeai.one",
        "apiKey": "YOUR_SURGEAI_KEY",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "claude-opus-4-6",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 100000
          },
          {
            "id": "claude-sonnet-4-6",
            "name": "claude-sonnet-4-6",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 100000
          },
          {
            "id": "glm-5",
            "name": "glm-5",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 100000
          },
          {
            "id": "MiniMax-M2.5",
            "name": "MiniMax-M2.5",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 100000
          },
          {
            "id": "kimi-k2.5",
            "name": "kimi-k2.5",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 100000
          }
        ]
      }
    }
  }
}

2. 设置默认代理模型

{
  agents: {
    defaults: {
      model: {
        primary: "surgeai/claude-opus-4-6", // 默认模型
      },
      models: {
        // 可用模型
        "surgeai/claude-opus-4-6": {},
        "surgeai/claude-sonnet-4-6": {},
        "surgeai/glm-5": {},
        "surgeai/MiniMax-M2.5": {},
        "surgeai/kimi-k2.5": {},
      },
    },
  },
}

完整的 ~/.openclaw/openclaw.json 示例

{
  "meta": {...},
  "wizard": {...},
  "models": {
    "mode": "merge",
    "providers": {
      "surgeai": {
        "baseUrl": "https://surgeai.one",
        "apiKey": "YOUR_SURGEAI_KEY",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "claude-opus-4-6",
            ...
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "surgeai/claude-opus-4-6"
      },
      "models": {
        "surgeai/claude-opus-4-6": {},
        "surgeai/claude-sonnet-4-6": {},
        "surgeai/glm-5": {},
        "surgeai/MiniMax-M2.5": {},
        "surgeai/kimi-k2.5": {}
      }
    }
  }
}

步骤 5：完成设置

继续完成 OpenClaw 的其余配置：

Select channel | 选择并配置您首选的消息通道。

Configure skills | 选择并安装您需要的技能。

完成设置。

步骤 6：与您的机器人聊天

设置完成后，CLI 会询问 How do you want to hatch your bot?

选择 ● Hatch in TUI (recommended)

现在您可以在终端 UI 中与 AI 机器人聊天了！

OpenClaw 支持多种交互通道，包括 Web UI、Discord、Slack、Telegram 等。请参考官方文档进行通道设置：通道设置

对于 Web UI，请打开终端中显示的 Web UI (with token) 链接。

步骤 7：验证安装

验证一切正常：

📖 详细的配置指南，请参考官方文档。

⚠️ 警告：如果配置不当或部署时没有适当的访问控制，OpenClaw 可能存在安全风险。请参考官方安全文档。

高级配置

使用技能

技能是包含 SKILL.md 文件的文件夹。如果您想为 OpenClaw 代理添加新功能，ClawHub 是查找和安装技能的最佳方式。

安装 ClawHub

管理技能

搜索技能：

安装新技能：

更新已安装的技能：

插件管理

插件是扩展 OpenClaw 功能的小型代码模块（命令、工具和 Gateway RPC）。

查看已加载的插件：

安装官方插件（示例：voice-call）：

重启网关：

为什么选择 SurgeAI + OpenClaw？

功能	优势
160+ 模型	使用一个 API Key 访问 OpenAI、Google、Anthropic、DeepSeek 等
统一 API	OpenAI 兼容格式——切换模型时无需更改代码
自动故障转移	当一个提供商不可用时无缝切换
成本效益	按需付费，比较模型并选择最佳性价比
多通道	连接 Telegram、Discord、Slack、WhatsApp 等
可扩展	从 ClawHub 添加技能和插件，获得无限功能

故障排除

常见问题

API Key 认证

确保您的 SurgeAI API Key 有效且有足够余额

检查 API Key 是否正确设置在配置中

在 surgeai.one/dashboard 验证

模型可用性

在 surgeai.one/v1/models 查看可用模型

验证模型名称格式（例如：surgeai/gpt-5.2）

连接问题

确保 OpenClaw 网关正在运行：openclaw status

检查到 surgeai.one 的网络连接

运行 openclaw doctor 进行诊断

资源

SurgeAI 文档：docs.surgeai.one

SurgeAI 控制台：surgeai.one

OpenClaw 文档：docs.openclaw.ai

OpenClaw GitHub：github.com/openclaw/openclaw

社区技能：ClawHub

什么是 OpenClaw？#

安装和配置 OpenClaw#

步骤 1：获取 SurgeAI API Key#

步骤 2：安装 OpenClaw#

步骤 3：设置 OpenClaw#

步骤 4：配置 SurgeAI 模型#

步骤 5：完成设置#

步骤 6：与您的机器人聊天#

步骤 7：验证安装#

高级配置#

使用技能#

安装 ClawHub#

管理技能#

插件管理#

为什么选择 SurgeAI + OpenClaw？#

故障排除#

常见问题#

资源#