跳转到主要内容
OpenClaw 是一个开源(MIT)的个人 AI 助手,跑在你自己的电脑或服务器上,在 Telegram、WhatsApp、Discord、Slack、iMessage、Teams 等 20 多个服务里回复你。它自己不带模型:RuAPI 以自定义提供商(custom provider)的方式接进去——Claude 走原生 Anthropic 格式,DeepSeek、GPT、GLM 走 OpenAI 兼容格式。一个密钥用所有模型,请求直接发到 www.ruapi.ai,在俄罗斯不用 VPN。 OpenClaw 为什么要用 RuAPI 做提供商、模型价格,以及不用境外银行卡怎么付,简要说明见 www.ruapi.ai/openclaw-v-rossii;下面是具体设置步骤。
本文已对照 OpenClaw 源码和官方文档核对(2026-11-02)。如果新版 OpenClaw 里菜单或字段名称变了,以 docs.openclaw.ai 为准。

前置条件

1

RuAPI 账号和 API key

控制台 → 令牌管理 → 添加令牌。OpenClaw 会在聊天软件里自动回复、按计划执行任务,不需要你在场,所以建议给这个令牌设置额度——智能体最多只能花这么多。详见 API key 与安全。新账号通常会马上送 $0.05:这笔余额可以用 claude-haiku-5-5、deepseek-flash 和 gpt-6-luna。其他模型在第一次充值后开放——用 USDT 充值,5 USDT 起,不需要境外银行卡(怎么用卢布通过 SBP 买 USDT)。也可以用境外银行发行的卡。
2

操作系统

macOS、Linux、Windows 都可以。Windows 上可以装 Windows Hub 应用、用 PowerShell 脚本安装,或者在 WSL2 里用——几种方式见下文。
3

Node.js(只有用 npm 安装时才需要)

官方安装脚本发现没有 Node.js 会自己装。用 npm 安装的话,需要 Node.js 24(24.16 起)或 26(26.1 起);官方推荐 Node 26,出于安全修复建议不低于 24.22.1 或 26.12.1。检查:

安装 OpenClaw

安装脚本会检查 Node.js、装好 OpenClaw,然后直接打开配置向导:可以在向导里接入 RuAPI(下面的方法二),也可以退出,在配置文件里手写提供商(方法一)。确认安装成功:

接入 RuAPI

在 OpenClaw 看来,RuAPI 是共用一个密钥的两个自定义提供商: Claude 建议用 Anthropic 格式接入,这样 Claude 缓存才能生效(见下文「Claude 缓存」一节)。模型的写法是 提供商/模型,比如 ruapi/claude-sonnet-5-5、ruapi-openai/deepseek-flash。

方法一:编辑 openclaw.json(推荐)

1

打开配置文件

一般是 ~/.openclaw/openclaw.json,准确路径用这条命令看:
文件不存在就新建一个。已经有的话,原有内容一律不要删:把下一步的字段补进现有的 models 和 agents 段里,不要再写一个同名的段。
2

加上提供商和主模型

  • id 是 价格页 上的模型名,要一字不差,区分大小写。想调用的模型都要列在 models 里。
  • input: ["text", "image"] 表示模型能看图:这样 OpenClaw 会把聊天软件里收到的照片按图片发给模型。不写的话,模型按纯文本模型处理;glm-5.3 只支持文本,所以没写。
  • fallbacks 是备用模型:主模型没回应时,OpenClaw 按顺序依次尝试。
ruapi 提供商的地址不要加 /v1:OpenClaw 的 Anthropic 客户端会自己补上。
只有 $0.05 体验余额时,主模型先设成 ruapi/claude-haiku-5-5 或 ruapi-openai/deepseek-flash;claude-sonnet-5-5 要第一次充值后才能用。
3

检查配置

Gateway 会监视这个文件,改动自动生效。校验配置并查看当前模型:
models status 应显示主模型 ruapi/claude-sonnet-5-5、备用模型 ruapi-openai/deepseek-flash。如果改动没生效,运行 openclaw gateway restart。
把密钥放进 ~/.openclaw/.env:
然后两个提供商都写 apiKey: "${RUAPI_API_KEY}"。变量也可以写在 openclaw.json 的 env.vars 里,例如 env: { vars: { RUAPI_API_KEY: "sk-…" } }。像旧示例那样把变量直接写在 env 下(不包在 vars 里),现在的 OpenClaw 不接受。

方法二:用 openclaw onboard 向导

只接一个提供商的话,用向导比较方便。安装脚本会自动打开它;手动运行用下面的命令(已经配好的也用这条命令换提供商):
1

找到 Custom Provider

选 Quick start。OpenClaw 会列出它检测到的模型接入方式(如果有)和提供商列表:打开 More… → Custom Provider。
2

填写字段

遇到 OpenClaw 不认识的模型,向导还会问 Does this model support image input?——GLM 模型(比如 glm-5.3)只支持文本,选否。deepseek-flash 会被向导自动当成纯文本模型;想给它发图片,事后在 openclaw.json 里给它加上 input: ["text", "image"]。格式请明确选择,不要选 Unknown (detect automatically):自动检测可能把 Claude 接成 OpenAI 格式,这种格式下 OpenClaw 不打缓存标记,只有 RuAPI 的自动缓存。
3

等待验证

保存前,向导会给模型发一次真实请求。验证不通过时,可以改地址(Change base URL)或改模型(Change model)。
4

第二个提供商照样添加

Claude 和 DeepSeek/GPT 都要用的话,再运行一次 openclaw onboard,用另一个 Endpoint ID 添加第二个 Custom Provider。之后可以用 openclaw models set ruapi/claude-sonnet-5-5 切换主模型。

第一次请求

在终端里直接打开对话,让它用一句中文打个招呼:
也可以用 openclaw dashboard 打开网页控制台,在那里发消息。 正常拿到回复,并且 RuAPI 控制台 → 使用日志 里出现所选模型的记录,就说明接通了。实际扣费以使用日志为准:模型没写 cost 字段时,OpenClaw 自己的统计把费用算成 0。 想让 Gateway 在后台常驻、重启电脑后自动运行,就把它装成系统服务:openclaw gateway install(或 openclaw onboard --install-daemon)。查看状态:openclaw gateway status。

换用其他模型

也可以直接改 openclaw.json 里的 agents.defaults.model.primary。模型必须列在对应提供商的 models 里。 完整列表和价格见 价格页。 会话标题、摘要、聊天记录总结这类短小的内部任务,OpenClaw 交给「辅助模型」(utility model)处理,可以指定一个便宜的:

Claude 缓存

  • Anthropic 格式(ruapi 提供商):OpenClaw 会自己在工具说明、系统指令和最近几条消息上打 cache_control 标记,缓存保留 5 分钟。智能体反复发送的上下文按缓存读取价计费。
  • 1 小时缓存:给具体模型设置 cacheRetention: "long"。写入这种缓存按输入价的 2 倍计费(见 提示缓存)。
    "short" 是普通的 5 分钟缓存,"none" 表示不打标记。
  • OpenAI 格式:如果 Claude 是通过 ruapi-openai 接的,OpenClaw 不会给它打标记,只有 RuAPI 的自动缓存:新对话的第一轮最多只缓存系统提示和工具,隔了超过 5 分钟缓存会过期。DeepSeek 和 GPT 自动缓存,不需要标记。
在 使用日志 里可以确认缓存:重复请求的记录里应该有「缓存 Tokens」这一行。如果没有,给这个模型显式设置 cacheRetention: "short"。

常见问题

  • apiKey 填的是 RuAPI 令牌(sk-...),不是 Anthropic 或 OpenAI 官方 key。
  • 如果密钥写成了 ${RUAPI_API_KEY},确认 ~/.openclaw/.env 或 env.vars 里有这个变量。
  • 检查 RuAPI 控制台 → 令牌管理,确认 key 没禁用,这个模型也没被 key 的「模型限制列表」排除(如果设置了的话)。
  • 模型前面要带提供商:ruapi/claude-sonnet-5-5、ruapi-openai/deepseek-flash。
  • 模型要列在这个提供商的 models 里,id 和价格页上的名字完全一致,包括大小写(GLM-5.2,但 glm-5.3 是小写)。
  • baseUrl:anthropic-messages 用 https://www.ruapi.ai,openai-completions 用 https://www.ruapi.ai/v1。
  • 第一次充值前只能用 claude-haiku-5-5、deepseek-flash 和 gpt-6-luna。
OpenClaw 只接受完全符合格式定义的配置:多一个不认识的字段或填错值,Gateway 就不启动。检查:
旧示例里常见的错误:api: "openai"(应为 "openai-completions"),以及 models 写成字符串列表(应为 { id, name } 对象)。
本文旧版让你设置 ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY,模型写成 anthropic/claude-...。内置的 anthropic 提供商是为 Anthropic 官方 API 设计的,建议改用自定义提供商:
  1. 从 openclaw.json 的 env(或 env.vars)和 ~/.zshrc/~/.bashrc 里删掉 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY。
  2. 按上面的方法一添加 ruapi 提供商。
  3. 把 agents.defaults.model 里的 anthropic/... 改成 ruapi/...。
  • 检查能否 curl -I https://www.ruapi.ai 通。
  • 退出向导(Ctrl+C),按上面的方法一在 openclaw.json 里手写提供商。
对不认识的 OpenAI 兼容地址,OpenClaw 默认在流式模式下不请求 token 用量。这不影响 RuAPI 扣费。想让 OpenClaw 自己也能看到用量,给 ruapi-openai 的各个模型加上 compat: { supportsUsageInStreaming: true },RuAPI 支持这个选项。
OpenClaw 配置时会自动建一个定时任务(proactive check,定期主动检查)。查看任务:openclaw automations list --all;关掉不需要的:openclaw automations disable <id>。
Ollama 是 OpenClaw 内置的提供商(模型写成 ollama/...)。RuAPI 的提供商加在旁边就行:比如主模型用 ruapi/claude-sonnet-5-5,本地模型放进 agents.defaults.model.fallbacks,反过来也可以。详见 OpenClaw 文档。

接入聊天软件

OpenClaw 的核心价值是通过聊天软件和模型对话。配好 RuAPI 之后,按 OpenClaw 渠道文档 接入 Telegram、WhatsApp、Discord 等渠道即可,模型调用自动走 RuAPI。

另见

提示缓存

重复发送的上下文至少便宜 10 倍。

Hermes Agent

和 OpenClaw 最接近的同类工具,同样能接 RuAPI。

怎么用卢布买 USDT

Crypto Bot、Bybit P2P 或兑换商,三种方式。