跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
前置条件

1

RuAPI 账号 + API key

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

Node.js ≥ 18

node --version
没装：nodejs.org。
3

操作系统

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 组合（推荐）

1

先跑一次 onboarding 创建配置目录

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

编辑 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-4-6" },
    },
  },
}
ANTHROPIC_BASE_URL 末尾 不要 加 /v1。
3

重启 gateway

如果你之前装了 daemon：
openclaw onboard --install-daemon
或者手动起：
openclaw gateway:start

​
方法二：shell 环境变量

懒得改配置文件，直接：
把这几行加进 ~/.zshrc 或 ~/.bashrc：
export ANTHROPIC_BASE_URL="https://www.ruapi.ai"
export ANTHROPIC_API_KEY="sk-你的KEY"
然后 source 一下或者新开终端。
~/.openclaw/openclaw.json 里依然要写 agents.defaults.model 指定具体模型，否则跑起来会问你选哪个。

​
第一次验证

启动并发一条消息： 
openclaw agent --message "用一句中文打招呼" --local
正常拿到回复 + RuAPI 控制台 → 日志 看到对应的 claude-sonnet-4-6 调用 = 成功。 如果你已经接好 Telegram / Discord 等渠道，直接在那边发消息也会用 RuAPI 处理。

​
选不同模型

改 ~/.openclaw/openclaw.json： 
{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-7" },
    },
  },
}
OpenClaw 用 <provider>/<model-id> 的命名格式。常用：
模型 ID用途
anthropic/claude-sonnet-4-6默认主力
anthropic/claude-opus-4-7复杂任务
anthropic/claude-haiku-4-5轻量 / 快速
完整列表在 模型广场。

​
常见问题

  • ANTHROPIC_API_KEY 填的是 RuAPI 令牌（sk-...），不是 Anthropic 官方 key。
  • 检查 RuAPI 控制台 → 令牌，确认 key 没禁用、白名单没把这个模型排除。
  • 模型 ID 拼写要带 anthropic/ 前缀，例如 anthropic/claude-sonnet-4-6。
  • ANTHROPIC_BASE_URL 末尾不要加 /v1。
  • 检查能否 curl -I https://www.ruapi.ai 通。
  • 退出 onboarding（Ctrl+C），手工编辑 ~/.openclaw/openclaw.json，下次启动会读这个文件。
OpenClaw 支持 models.providers 配多个 provider + fallback 链。先跑通 RuAPI 单 provider，需要时参考 官方配置文档 加 fallback。
在 openclaw.json 配一个自定义 provider：
{
  models: {
    providers: {
      ruapi: {
        api: "openai",
        baseUrl: "https://www.ruapi.ai/v1",
        apiKey: "sk-你的KEY",
        models: ["gpt-5", "gpt-5-mini"],
      },
    },
  },
  agents: {
    defaults: { model: { primary: "ruapi/gpt-5" } },
  },
}

​
进阶：渠道接入

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