OpenClaw 接入 kkaiapi
最后更新:
使用 models.providers 注册 KK 的 Chat Completions 连接,通过环境变量读取 Key,选择 provider/model 并核对一次 Agent 任务。
注册 provider,再选择 provider/model
在 OpenClaw 配置中注册 models.providers.kkai。api 选择 openai-completions 对应 Chat Completions;agents.defaults.model.primary 使用 kkai/模型ID。下面是配置合并片段,先备份原文件,保留已有 providers 与 Agent 设置。
| 配置项 | 值 |
|---|---|
| 协议 | OpenAI Chat Completions |
| Base URL | https://api.kkaiapi.com/v1 |
| 模型 ID | claude-sonnet-5-5 |
| 凭据 | 从当前工具进程的安全配置读取 |
合并配置片段
配置中只引用环境变量;应合并到现有配置,保留已有账户与其他模型条目。
{
"models": {
"mode": "merge",
"providers": {
"kkai": {
"baseUrl": "https://api.kkaiapi.com/v1",
"api": "openai-completions",
"apiKey": "${KKAI_API_KEY}",
"models": [
{
"id": "claude-sonnet-5-5",
"name": "claude-sonnet-5-5",
"input": [
"text"
]
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "kkai/claude-sonnet-5-5"
}
}
}
}核对实际生效的工具路径
在启动 OpenClaw 的进程中提供 KKAI_API_KEY,然后重载或重启网关,核对模型选择与一次小任务。环境变量插值由 OpenClaw 读取,不要将真实 Key 写进配置。Responses 需要模型页明确提供 /v1/responses,不能只靠模型名推定。
配置依据与能力验证
配置完成后用一个短任务核对实际模型 ID 与 KK 调用记录,再单独验证工具往返、图片输入等所需能力。聊天成功只能证明该聊天路径可用。
配置字段依据openclaw 官方说明;工具界面可能随版本变化,所需能力应在已安装版本中核对。
常见问题
为什么 API 请求成功,工具仍不能完成任务?
继续核对工具实际选择的 provider、模型、能力声明和运行进程的网络出口;工具调用、文件编辑和图片入口应分别验证。