OpenClaw 接入 KoalaAPI

访问地址：https://koalaapi.com（OpenAI 兼容接口在末尾加 /v1）。

配置速查

配置项	填写内容
Base URL	`https://koalaapi.com`；OpenAI 兼容接口填 `https://koalaapi.com/v1`
API Key	控制台 → 令牌管理创建的令牌，形如 `sk-...`
模型名称	与控制台【模型广场】完全一致；不同令牌分组可用的模型不同

1. 这份教程要做什么

OpenClaw 负责调用模型

首先确保你已经安装了 Node.js 24+ 环境，然后在终端执行：

openclaw安装方式：

方式一：npm安装（推荐）

npm install -g openclaw

方式二：一键安装脚本

安装完成后执行引导（根据提示完成基础设置）
openclaw onboard --install-daemon

-选择yes和快速启动

在模型提供商这里选择 Custom Provider

在4spi网站创建令牌，如果已有令牌要检查分组与你要调用的模型是否匹配

填写 URL 并粘贴刚才上面令牌的key。

（截图待补）

注意：

这里填写 URL 时如果不行就在 URL 后面添加 /v1 后尝试。
兼容类型要选对：Claude 模型选 Anthropic-compatible，其他模型选 OpenAI-compatible。

（截图待补）

模型名称在模型广场复制

（截图待补）

粘贴模型名称

（截图待补）

验证成功则为成功连通站点
要是失败，在url后面加个 /v1

（截图待补）

选择web ui

如果不能成功运行，就按下面顺序执行

openclaw gateway run
openclaw dashboard

成功运行如下

（截图待补）

（可选）
如果 OpenClaw 提示上下文窗口过小，可以修改下面配置

（截图待补）

在.openclaw目录下的openclaw.json文件中修改这两个参数

（截图待补）

缓存与费用注意（重要）

OpenClaw 默认把最新变动的内容放在对话最前面。这样一来每一轮的开头都不一样，上一轮算好的缓存全部作废，整段内容按更贵的缓存写入重新计价。

10 月有位用户碰到过：长会话里同样的内容被反复重写，一次累计 36 万 token，费用比正常情况高了约 10 倍。

建议做法

稳定的内容放前面，会变的内容放后面：系统提示、背景资料放最前；日志、刚读到的文件、查询结果放末尾。

长任务分段：跑一段时间就另开会话，别让同一段历史反复重写。

留意 OpenClaw 自己的日志：提示上下文窗口过小时会建议调大，但窗口越大、单次内容越多，没吃上缓存时花的钱也越多。

什么时候建议换官方 CLI

如果是长时间挂着跑、连续读代码库或大文件：

Claude 模型 → Claude Code CLI

GPT 模型 → Codex CLI

这两个是官方客户端，缓存命中能到 90% 以上。怎么选见《客户端怎么选：会直接影响你的账单》。

更新于 2026-11　官方文档：https://openclaw.ai/

OpenClaw 接入 koalaapi 教程

OpenClaw 接入 KoalaAPI#

1. 这份教程要做什么#

缓存与费用注意（重要）#

建议做法#

什么时候建议换官方 CLI#

OpenClaw 接入 KoalaAPI

1. 这份教程要做什么

缓存与费用注意（重要）

建议做法

什么时候建议换官方 CLI