集成

OpenClaw

OpenClaw 是一款开源 AI Agent 平台，支持 Telegram、Discord、Slack、Signal 等多个消息渠道。通过将 OpenClaw 的 OpenAI 兼容 Provider 指向平台接口，即可使用 HypersHub 全系模型，统一计费与用量管理。

为什么通过平台使用 OpenClaw？

多渠道覆盖

同一配置可同时接入 Telegram、Discord、Slack 等消息平台，统一管理所有 AI Agent。

统一计费

与其他模型调用共用同一个 API Key，在控制台集中查看用量与账单，无需多账号切换。

稳定访问

国内直连，无需额外网络配置，请求低延迟、不中断。

前置条件

已安装 Node.js 22 LTS 或更高版本
已在控制台生成平台 API Key
确认目标模型 ID 在控制台可用

配置步骤

安装 OpenClaw CLI

通过 npm 全局安装最新版 OpenClaw：

终端

npm install -g openclaw@latest

编写配置文件

编辑 ~/.openclaw/openclaw.json，将 OpenAI provider 的 baseUrl 指向平台接口：

~/.openclaw/openclaw.json

{
  "env": {
    "OPENAI_API_KEY": "hy-..."
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/claude-sonnet-4-6"
      }
    }
  },
  "models": {
    "providers": {
      "openai": {
        "baseUrl": "https://apiclaw.cc/v1",
        "apiKey": "${OPENAI_API_KEY}"
      }
    }
  }
}

将 hy-... 替换为控制台生成的平台 API Key。 OpenClaw 使用 openai/* 格式引用模型，模型 ID 与平台模型名称直接对应。

完成初始化

运行引导向导安装后台服务：

终端

openclaw onboard --install-daemon

启动并验证

打开控制面板，发送一条消息，确认响应正常：

终端

openclaw dashboard

也可以连接 Telegram 等消息渠道，从手机直接发消息验证。

模型 ID

配置 models.providers.openai.baseUrl 指向平台后，所有 openai/* 请求均路由至平台。模型 ID 格式为 openai/<平台模型 ID>：

openclaw.json 中的模型 ID	供应商
openai/claude-sonnet-4-6	Anthropic
openai/claude-haiku-4-5	Anthropic
openai/claude-opus-4-6	Anthropic
openai/gpt-5.4	OpenAI
openai/gpt-5.4-mini	OpenAI
openai/deepseek-v4-pro	DeepSeek

完整模型列表参见模型与计费。

多模型 Fallback

OpenClaw 支持主模型不可用时自动切换到备用模型，结合平台的高可用路由，进一步提升可靠性：

~/.openclaw/openclaw.json（agents 片段）

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/claude-sonnet-4-6",
        "fallbacks": [
          "openai/claude-haiku-4-5"
        ]
      }
    }
  }
}

按渠道配置模型

可以为不同消息渠道（如 Telegram、Discord）指定独立的模型，在成本与能力之间灵活权衡：

~/.openclaw/openclaw.json

{
  "telegram": {
    "agents": {
      "defaults": {
        "model": {
          "primary": "openai/claude-haiku-4-5"
        }
      }
    }
  },
  "discord": {
    "agents": {
      "defaults": {
        "model": {
          "primary": "openai/claude-sonnet-4-6"
        }
      }
    }
  }
}

使用提示

用量监控

所有通过 OpenClaw 发起的请求均会记录在控制台「用量」页面，可按模型、时间段筛选，并设置预算告警。

查看可用模型

运行 openclaw models list --provider openai 可列出当前配置下的可用模型，确认平台接口已正确接入。

多渠道同时运行

单个 openclaw gateway run 进程可同时监听多个消息渠道，所有渠道共用同一个 API Key 和计费账户。

常见问题

收到 401 / 403 鉴权错误

确认 OPENAI_API_KEY 已正确填写平台 API Key（以 hy- 开头），并前往控制台「API Keys」页面确认 Key 有效且账户余额充足。

提示模型不存在或无法访问

确认模型 ID 格式为 openai/<平台模型 ID>，例如 openai/claude-sonnet-4-6，且该模型 ID 在控制台模型列表中可用。

baseUrl 配置后请求仍发往 OpenAI 官方

检查 models.providers.openai.baseUrl 是否拼写正确，并确保 openclaw.json 已保存后重启 Gateway（openclaw gateway run）。