AI API聚合平台Key获取与OpenClaw配置教程

详细步骤指南:如何获取API密钥并配置OpenClaw以节省40%以上的Token消耗

教程概述

本教程将指导您完成从AI API聚合平台获取API密钥,并将其配置到OpenClaw中的全过程。通过此方法,您可以显著降低Token消耗成本(节省40%以上),同时享受高质量的AI模型服务。

目录

第一部分:获取AI API聚合平台密钥

步骤1:访问聚合平台

访问 https://ai.32zi.com 或您常用的其他聚合平台。

在这里插入图片描述

步骤2:注册并进入API令牌页面

点击"API令牌",如果没有账号请先注册。该平台的金额比例为 1:0.56,即1个🔥=0.56人民币。

在这里插入图片描述

步骤3:添加令牌

点击"添加令牌",在左侧出现的输入框中依次输入名称、选择分组(分组需要与模型广场里的分组对应)。

在这里插入图片描述

重要提示:分组的选择需要与您想要的模型价格路线一致。例如,如果您想使用claude-haiku-4-5-20251001模型下的default分组,创建key时分组需要与此对应。

在这里插入图片描述

步骤4:获取API密钥和基础URL

正确填写后,您将获得API密钥和基础URL。

在这里插入图片描述

关键配置:您将获得keybaseUrl=https://ai.32zi.com。为了兼容OpenAI格式,最终的baseUrl需要加上/v1,即baseUrl=https://ai.32zi.com/v1

第二部分:配置OpenClaw

步骤1:找到配置入口

在OpenClaw菜单中找到 Settings » Config » Add Entry

在这里插入图片描述

步骤2:填写配置表单

在表单中依次输入或选择以下值:

在这里插入图片描述

步骤3:添加模型配置

点击 models 旁边的 add,依次输入或选择以下值:

在这里插入图片描述

注意:Id和name对应聚合平台的模型code,例如:claude-haiku-4-5-20251001

在这里插入图片描述

步骤4:保存配置

点击save保存配置。

在这里插入图片描述

步骤5:查看配置文件

查看配置文件,确认已添加的配置。

在这里插入图片描述

步骤6:启用模型

返回chat界面,输入/model list,此时可能看不到刚刚添加的端点。需要使用以下两种方法之一启用模型:

方法一:命令方式

输入命令:

openclaw models set custom-2/claude-haiku-4-5-20251001

在这里插入图片描述

方法二:修改配置文件
  1. 找到配置文件:执行openclaw gateway status,得到配置路径
Config (cli): C:\Users\admin\.openclaw\openclaw.json
Config (service): C:\Users\admin\.openclaw\openclaw.json
  1. 在配置文件中增加以下字段:
"custom-2/claude-haiku-4-5-20251001": {}

在这里插入图片描述

OpenClaw模型选择顺序

  1. 主要模型(agents.defaults.model.primary 或 agents.defaults.model)
  2. agents.defaults.model.fallbacks 中的回退模型(按顺序)
  3. agents.defaults.models 是 OpenClaw 可使用的模型白名单/目录(加上别名)
  4. agents.defaults.imageModel 仅在主要模型无法接受图像时使用

步骤7:验证配置

完成上述任一方法后,返回chat界面,输入/model list即可看到刚刚添加的端点。

总结

通过本教程,您已经成功完成了:

  1. 获取API密钥:从AI API聚合平台获取了有效的API密钥和基础URL
  2. 配置OpenClaw:将聚合平台配置集成到OpenClaw中
  3. 启用模型:通过命令或配置文件方式启用了自定义模型

核心优势

  • 成本节省:相比直接使用官方API,可节省40%以上的Token消耗
  • 模型多样性:支持多种AI模型,包括Claude、GPT等
  • 配置灵活:支持多种配置方式,适应不同使用场景

使用建议

  1. 分组选择:创建密钥时务必选择正确的分组,确保与目标模型的价格路线一致
  2. URL格式:注意baseUrl需要添加/v1后缀以兼容OpenAI格式
  3. 模型启用:配置完成后记得启用模型,否则无法在chat界面看到
  4. 成本监控:定期检查API使用情况,合理控制成本

常见问题

Q: 为什么在/model list中看不到新添加的端点?
A: 需要执行启用命令或在配置文件中添加对应字段。

Q: 分组选择错误怎么办?
A: 需要重新创建API密钥,选择正确的分组。

Q: 如何确认配置是否生效?
A: 执行openclaw gateway status查看配置状态,并在chat界面测试模型使用。


如果觉得本教程有帮助,请点赞收藏支持!

欢迎在评论区交流讨论使用心得和遇到的问题!

Q: 如何确认配置是否生效?
A: 执行openclaw gateway status查看配置状态,并在chat界面测试模型使用。


如果觉得本教程有帮助,请点赞收藏支持!

欢迎在评论区交流讨论使用心得和遇到的问题!

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐