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
- macOS / Linux / WSL2
- Windows(PowerShell)
- Windows Hub
- npm
接入 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 按顺序依次尝试。
3
检查配置
Gateway 会监视这个文件,改动自动生效。校验配置并查看当前模型:
models status 应显示主模型 ruapi/claude-sonnet-5-5、备用模型 ruapi-openai/deepseek-flash。如果改动没生效,运行 openclaw gateway restart。不想把密钥直接写在 openclaw.json 里
不想把密钥直接写在 openclaw.json 里
把密钥放进 然后两个提供商都写
~/.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 自动缓存,不需要标记。
cacheRetention: "short"。
常见问题
找不到模型(503)或 404
找不到模型(503)或 404
- 模型前面要带提供商:
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.json 后 Gateway 起不来
改完 openclaw.json 后 Gateway 起不来
OpenClaw 只接受完全符合格式定义的配置:多一个不认识的字段或填错值,Gateway 就不启动。检查:旧示例里常见的错误:
api: "openai"(应为 "openai-completions"),以及 models 写成字符串列表(应为 { id, name } 对象)。按本文旧版配置过(ANTHROPIC_BASE_URL)
按本文旧版配置过(ANTHROPIC_BASE_URL)
本文旧版让你设置
ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY,模型写成 anthropic/claude-...。内置的 anthropic 提供商是为 Anthropic 官方 API 设计的,建议改用自定义提供商:- 从
openclaw.json的env(或env.vars)和~/.zshrc/~/.bashrc里删掉ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY。 - 按上面的方法一添加
ruapi提供商。 - 把
agents.defaults.model里的anthropic/...改成ruapi/...。
openclaw onboard 卡住或验证不通过
openclaw onboard 卡住或验证不通过
- 检查能否
curl -I https://www.ruapi.ai通。 - 退出向导(Ctrl+C),按上面的方法一在
openclaw.json里手写提供商。
OpenClaw 对 ruapi-openai 的模型提示「returned no token usage」
OpenClaw 对 ruapi-openai 的模型提示「returned no token usage」
对不认识的 OpenAI 兼容地址,OpenClaw 默认在流式模式下不请求 token 用量。这不影响 RuAPI 扣费。想让 OpenClaw 自己也能看到用量,给
ruapi-openai 的各个模型加上 compat: { supportsUsageInStreaming: true },RuAPI 支持这个选项。没给智能体发消息,也在消耗 token
没给智能体发消息,也在消耗 token
OpenClaw 配置时会自动建一个定时任务(proactive check,定期主动检查)。查看任务:
openclaw automations list --all;关掉不需要的:openclaw automations disable <id>。同时用 Ollama 和 RuAPI
同时用 Ollama 和 RuAPI
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 或兑换商,三种方式。