跳转到主要内容

​
1. 概述

本指南说明如何在 OpenClaw 中配置自定义模型提供商。 配置完成后，OpenClaw 可以通过指定的 API 端点调用模型，并将其用于本地 Agent 任务。

​
2. 前置条件

在开始之前，请确保你已具备以下条件：
  1. 你的设备上已安装 OpenClaw。
  2. 一个有效的 API Key。
  3. 你想要使用的模型名称。
  4. 能够正常访问 API 服务的网络环境。
1

打开终端或控制台

在本地设备上打开终端或命令行工具。macOS 或 Linux 用户可以使用终端（Terminal）。Windows 用户可以使用命令提示符（Command Prompt）、PowerShell 或开发环境中的终端。
2

打开 OpenClaw 配置界面

在终端中运行以下命令：
openclaw config
按 Enter 进入配置流程。
3

选择本地配置

在配置菜单中选择：
Local
按 Enter。此选项表示配置将应用于你的本地 OpenClaw 环境。
4

进入模型配置

继续选择：
Model
按 Enter。此选项用于配置 OpenClaw 使用的模型服务。
5

选择自定义提供商

选择：
Custom Provider
按 Enter。当你想要将 OpenClaw 连接到自定义的 OpenAI 兼容 API 服务时，请选择此选项。
6

配置 API Base URL

当提示输入 API Base URL 时，输入：
https://apihub.agnes-ai.com/v1
按 Enter。此地址告诉 OpenClaw 将模型请求发送到 Agnes AI API 网关。
7

输入 API Key

当提示输入 API Key 时，输入你的实际 API Key。示例：
YOUR_API_KEY
在大多数情况下，你不需要手动添加 Bearer 前缀，除非 OpenClaw 明确要求你输入完整的 Authorization Header。
8

输入模型名称

当提示输入模型名称时，输入你想要使用的模型 ID。示例：
agnes-2.0-flash
请确保输入平台提供的完整模型 ID。
9

保存配置

完成所有必填字段后，确认并保存配置。保存成功后，OpenClaw 将使用此自定义提供商进行本地模型调用。

​
12. 配置示例

提供商类型： Custom Provider API Base URL： https://apihub.agnes-ai.com/v1 API Key： YOUR_API_KEY 模型： agnes-2.0-flash

​
13. 验证配置

配置完成后，你可以运行一个 OpenClaw 任务或启动一个测试会话。 如果配置正确，OpenClaw 应该能够向 API 服务发送请求并正常返回模型响应。

​
14. 故障排查

检查 API Base URL 是否正确：
https://apihub.agnes-ai.com/v1
同时确认你的 API Key 是有效的。
检查模型名称是否输入正确。模型 ID 通常区分大小写。建议直接从平台复制模型名称。
检查 API Key 是否已过期、账户余额是否充足，以及该 Key 是否有权限访问目标模型。
确保你的设备能够正常访问 API 地址。如果请求无法完成，请检查你的防火墙、代理或 VPN 设置。

​
15. 注意事项

对于 OpenAI 兼容的 API 服务，API Base URL 通常以 /v1 结尾。正确示例：
https://apihub.agnes-ai.com/v1
通常不建议输入：
https://apihub.agnes-ai.com/v1/chat/completions
除非 OpenClaw 明确要求你输入完整的 API 端点。