在 OpenClaw 中配置索元 AI+ 模型 API

Secret的AI探索笔记
0 阅读1分钟

📋 前置准备

在开始配置之前，请完成以下步骤：

在索元 AI+ 平台创建 API 密钥

进入www.soyenai.com，登录后点击菜单位置的【令牌管理】，会出现系统自动创建的默认令牌(如果没有出现默认密钥，请点击【添加令牌】-【名称】随意-【令牌分组】选择【Default】，点击提交即可),点击复制按钮即可得到密钥。

🦞OpenClaw 安装与基础初始化

脚本安装

macOS / Linux / WSL2

curl -fsSL https://openclaw.ai/install.sh | bash

就这样 —— 脚本会处理 Node 检测、安装和新手引导。

如果要跳过新手引导，只安装二进制文件：

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

Windows (PowerShell)

iwr -useb https://openclaw.ai/install.ps1 | iex

就这样 —— 脚本会处理 Node 检测、安装和新手引导。

如果要跳过新手引导，只安装二进制文件：

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

npm安装

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

1.全局安装：

npm install -g openclaw@latest

2.执行引导（根据提示完成基础设置）：

openclaw onboard --install-daemon

更多安装方法请查阅【OpenClaw官方安装文档】

安装后

验证一切是否正常工作：

openclaw doctor         # 检查配置问题
openclaw status         # Gateway 网关状态
openclaw dashboard      # 打开浏览器 UI

🚀 索元 AI+ 模型 API 配置步骤

步骤 1：进入模型配置页面

  1. 点击左侧导航栏 「设置」-「AI与代理」

  2. 选择 Models（模型）

  3. 向下滚动到 Model Providers（模型提供商）

  4. 在 Custom entries（自定义条目）区域，点击 + Add Entry（添加条目）按钮

界面说明：

- Models（模型）- 模型配置子菜单

- Model Providers（模型提供商）- 模型提供商管理标签

- Custom entries（自定义条目）- 自定义模型区域

- + Add Entry（添加条目）- 添加新模型提供商按钮

步骤 2：填写 Provider ID 和 API Key

  1. 向下滚动到新建的提供商，在 Provider ID 输入框中填写提供商标识（如 custom-1 或 soyenai）

  2. Model Provider API Adapter（模型提供商 API 适配器）选择 openai-completions

  3. Model Provider API Key（模型提供商 API 密钥）粘贴从索元 AI+ 复制的 密钥

  4. 选择 api-key 认证方式标签

界面说明：

- Provider ID（提供商标识）- 自定义的提供商唯一标识符

- Model Provider API Key（模型提供商 API 密钥）- 用于 API 认证凭据

- security / auth / models - 密钥关联的安全标签

- api-key - API 密钥认证方式

步骤 3：填写 Base URL

  1. 向下滚动到 Model Provider Base URL（模型提供商基础地址）区域

  2. 在输入框中粘贴索元 AI+ 的 API URL：www.soyenai.com/v1

界面说明：

- Model Provider Authorization Header（模型提供商授权头）- 可选，默认关闭

步骤 4：配置模型列表

1. 向下滚动到 Model Provider Model List（模型提供商模型列表）区域

2. 点击 + Add（添加）按钮添加模型

3. 配置 Context Window（上下文窗口）- 设置模型的上下文长度（token 数，可留空，系统自动补全）

界面说明：

- Model Provider Model List（模型提供商模型列表）- 管理可用模型

- Context Window（上下文窗口）- 模型支持的最大上下文长度

- Cost（成本）- 可选，设置模型使用成本

步骤 5：配置模型详细信息

  1. 在 Id（标识）输入框中填写模型 ID（根据索元 AI+ 模型广场中模型对应的模型填写，如：MiniMax-M2.5）

  2. 配置 Input（输入）类型，点击 + Add（添加）按钮添加（多模态模型需添加2个类型）：

- text - 文本输入

- image - 图像输入

  1. 设置 Max Tokens（最大 token 数）- 使用 +/- 按钮调整

  2. 在 Name（名称）输入框中填写模型显示名称

  3. 配置 Reasoning（推理）开关（可选）- 若配置的模型具备推理能力，启用高级推理功能

界面说明：

- Id（标识）- 模型的唯一标识符

- Input（输入）- 模型支持的输入类型

- text - 文本输入模式

- image - 图像输入模式

- Max Tokens（最大 token 数）- 模型单次输出最大长度

- Name（名称）- 模型在界面中显示的名称

- Reasoning（推理）- 高级推理功能开关

步骤 6：保存并测试

1. 点击右上角 Save（保存）按钮保存配置

2. 进入 Chat（聊天）界面，在顶部模型选择框中选择配置的索元 AI+ 模型（如：soyenai/Mini-Max2.5），测试模型

✅ 配置完成

配置成功后，你就可以在 OpenClaw 中使用索元 AI+ 的模型 API 了！

测试建议：

  1. 发送简单消息测试连接

  2. 检查响应速度

  3. 验证模型功能是否正常

❓ 常见问题

1. API Key 格式错误

问题： 提示认证失败

解决方案：

  • 检查 API Key 是否完整复制（无多余空格）

  • 确认 API Key 未过期

2. Base URL 格式错误

问题： 连接超时或无法访问

解决方案：

  • 检查 URL 末尾是否有不必要的斜杠

3. 模型 ID 不匹配

问题： 调用模型时返回错误

解决方案：

  • 确认模型 ID 与索元 AI+ 平台一致

  • 检查模型是否已启用

  • 联系索元 AI+ 客服确认模型可用性

4. Context 过大

问题： 请求被拒绝或超时

解决方案：

  • 参考索元 AI+ 文档设置合理的上下文窗口

  • 不要超过模型实际支持的最大值

  • 给 OpenClaw 设置合理的上下文压缩机制

📞 技术支持

索元 AI+ 官方支持：

OpenClaw 官方文档：

avatar
文章
阅读
粉丝