OpenClaw
本页只覆盖 OpenClaw 的 OpenAI-compatible 配置,不包含 Gemini 原生路线。先使用当前 OpenClaw 官方版本,确认该版本支持自定义 OpenAI-compatible provider、Base URL 与 API Key。
准备与系统差异
按官方说明在 Windows、macOS 或 Linux 主机安装 OpenClaw。服务型部署应使用专用的最小权限 Key、专用预算和模型允许列表;不要将个人 Key 放入机器人频道、插件配置或共享日志。
先查询 Key 可见模型:
bash
curl 'https://ai.tavonilo.com/v1/models' \
-H "Authorization: Bearer $AI_SHOP_API_KEY"只选择返回的模型。Windows 服务、macOS 后台应用和 Linux 守护进程都需要在修改配置后重启实际运行的服务进程。
配置
在当前 OpenClaw 版本的模型 provider 设置中创建 OpenAI-compatible provider:
| 字段 | 值 |
|---|---|
| Provider protocol | OpenAI-compatible |
| Base URL | https://ai.tavonilo.com/v1 |
| API Key | 专用 API Key |
| Primary model | 当前 /v1/models 返回的模型 ID |
不要填入完整 /v1/chat/completions 地址,也不要选择 Gemini 或其他原生协议。配置字段的具体名称随 OpenClaw 版本变动时,应保留以上协议值并以当前官方设置表单为准。
验证与恢复
重启 OpenClaw 服务后,先在私有测试频道发送一条不含敏感数据的短消息。确认基础对话后,再开放外部频道、工具或自动化。
401:替换错误或已撤销的 Key,不要在机器人消息中排障。403:检查 Key 分组、模型权限、余额和路由。404:检查 Base URL 是否重复/v1或被填写为完整 endpoint。429:降低并发与队列深度。5xx或超时:保留脱敏诊断;不要因为超时盲目重放可能已处理的任务。
本页不承诺 OpenClaw 的全部 provider、插件、记忆、工具或自动化策略可用。