Skip to content

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 protocolOpenAI-compatible
Base URLhttps://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、插件、记忆、工具或自动化策略可用。

API access is subject to the AIShop service terms.