OpenClaw

OpenClaw 是一个跑在自己设备上的”个人 AI 助手”，可以通过 Telegram、WhatsApp、Discord、Signal、iMessage 等渠道使用。它默认支持多家模型供应商，Anthropic 兼容或 OpenAI 兼容 两种方式都能对接 RuAPI。

前置条件

RuAPI 账号 + API key

控制台 → 令牌 → 创建令牌。详见 API key 与安全。

Node.js ≥ 18

node --version

没装：nodejs.org。

操作系统

macOS / Linux 原生支持。Windows 推荐用 WSL2。

安装 OpenClaw

npm install -g openclaw@latest

确认版本：

openclaw --version

配置 RuAPI 端点

OpenClaw 走的是 Anthropic SDK，所以最简单的对接方式是设置 ANTHROPIC_BASE_URL + ANTHROPIC_API_KEY 两个环境变量，再在 ~/.openclaw/openclaw.json 里指定要用的模型。

方法一：env + config 组合（推荐）

先跑一次 onboarding 创建配置目录

openclaw onboard

跟着向导走完。中途问到 “选择模型提供商” 时随便选一个（比如 Anthropic API key），key 可以先随便填一个占位，下一步会改。这一步是为了创建 ~/.openclaw/ 目录和初始配置。

编辑 openclaw.json

打开 ~/.openclaw/openclaw.json（不存在就新建），改成：

{
  env: {
    ANTHROPIC_BASE_URL: "https://www.ruapi.ai",
    ANTHROPIC_API_KEY: "sk-你的RuAPI令牌",
  },
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-sonnet-5" },
    },
  },
}

ANTHROPIC_BASE_URL 末尾不要加 /v1。

重启 gateway

如果你之前装了 daemon：

openclaw onboard --install-daemon

或者手动起：

openclaw gateway:start

方法二：shell 环境变量

懒得改配置文件，直接：

macOS / Linux
WSL2

把这几行加进 ~/.zshrc 或 ~/.bashrc：

export ANTHROPIC_BASE_URL="https://www.ruapi.ai"
export ANTHROPIC_API_KEY="sk-你的KEY"

然后 source 一下或者新开终端。

同上，加进 WSL 里的 ~/.bashrc。

~/.openclaw/openclaw.json 里依然要写 agents.defaults.model 指定具体模型，否则跑起来会问你选哪个。

第一次验证

启动并发一条消息：

openclaw agent --message "用一句中文打招呼" --local

正常拿到回复 + RuAPI 控制台 → 日志看到对应的 Claude 调用 = 成功。如果你已经接好 Telegram / Discord 等渠道，直接在那边发消息也会用 RuAPI 处理。

选不同模型

改 ~/.openclaw/openclaw.json：

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-8" },
    },
  },
}

OpenClaw 用 <provider>/<model-id> 的命名格式。常用：

模型 ID	用途
`anthropic/claude-sonnet-5`	默认主力
`anthropic/claude-opus-4-8`	复杂任务
`anthropic/claude-haiku-4-5-20251001`	轻量 / 快速

完整列表（含具体版本号）在价格页面。

常见问题

401 Unauthorized

ANTHROPIC_API_KEY 填的是 RuAPI 令牌（sk-...），不是 Anthropic 官方 key。
检查 RuAPI 控制台 → 令牌，确认 key 没禁用、白名单没把这个模型排除。

404 / model not found

模型 ID 拼写要带 anthropic/ 前缀，例如 anthropic/claude-sonnet-5。
ANTHROPIC_BASE_URL 末尾不要加 /v1。

openclaw onboard 卡住 / 一直转圈

检查能否 curl -I https://www.ruapi.ai 通。
退出 onboarding（Ctrl+C），手工编辑 ~/.openclaw/openclaw.json，下次启动会读这个文件。

如何同时挂多个供应商做容灾

OpenClaw 支持 models.providers 配多个 provider + fallback 链。先跑通 RuAPI 单 provider，需要时参考官方配置文档加 fallback。

想用 OpenAI 兼容协议而不是 Anthropic

在 openclaw.json 配一个自定义 provider：

{
  models: {
    providers: {
      ruapi: {
        api: "openai",
        baseUrl: "https://www.ruapi.ai/v1",
        apiKey: "sk-你的KEY",
        models: ["你的模型名"],
      },
    },
  },
  agents: {
    defaults: { model: { primary: "ruapi/你的模型名" } },
  },
}

进阶：渠道接入

OpenClaw 的核心价值在 “通过 IM 调用 Claude”。配好 RuAPI 之后，接 Telegram / Discord / Signal 等渠道按 OpenClaw 渠道文档操作即可，模型调用自动走 RuAPI。

快速入门

指南

API 参考

模型指南

工具对接

能力进阶

实战教程

法律条款

前置条件

安装 OpenClaw

配置 RuAPI 端点

方法一：env + config 组合（推荐）

方法二：shell 环境变量

第一次验证

选不同模型

常见问题

进阶：渠道接入

​前置条件

​安装 OpenClaw

​配置 RuAPI 端点

​方法一：env + config 组合（推荐）

​方法二：shell 环境变量

​第一次验证

​选不同模型

​常见问题

​进阶：渠道接入

前置条件

安装 OpenClaw

配置 RuAPI 端点

方法一：env + config 组合（推荐）

方法二：shell 环境变量

第一次验证

选不同模型

常见问题

进阶：渠道接入