通过 BenPay AI API，用户可以在 OpenClaw 中接入平台支持的 AI 模型。配置时只需准备三个核心参数：
-
API Key
-
Base URL
-
Model ID
以 macOS 版 OpenClaw 和 OpenAI-compatible 接口为例，介绍完整配置流程。
一、配置前准备
开始前，请确认已经完成以下准备：
-
安装 OpenClaw CLI；
-
登录 BenPay 并进入 AI API 页面；
-
创建一个有效的 BenPay AI API Key；
-
账户中有可用试用额度或余额；
-
从 Supported Models 页面复制需要使用的完整 Model ID。
BenPay AI API 的完整 API Key 只会在创建时显示一次，请立即复制并妥善保存。不要将真实 API Key 展示在截图、社交媒体或公开代码仓库中。
本文示例配置：
Base URL: https://api.benpay.ai/openai/v1
Model ID: value/gpt-5.6-sol
API Key: 用户自己创建的 BenPay AI API Key
示例 Model ID 仅用于演示。实际使用时，请以 BenPay AI API 的 Supported Models 页面显示内容为准。
二、确认 OpenClaw CLI 可以使用
打开 macOS 终端，输入：
openclaw --version
如果终端能够显示 OpenClaw 版本号，说明 CLI 已经可以正常使用。
OpenClaw 的 macOS 应用在本地模式下需要 CLI 和 Gateway 配合运行。
如果提示 command not found
可以使用官方安装命令：
curl -fsSL https://openclaw.ai/install.sh | bash
安装完成后，关闭并重新打开终端，再次运行：
openclaw --version
该方式会将 OpenClaw 安装到用户本地目录，例如
~/.openclaw。
三、启动 OpenClaw Classic 配置向导
在终端运行：
OPENCLAW_LOCALE=zh-CN openclaw onboard --classic
OpenClaw 官方建议未列出的自定义模型服务通过 Classic 向导中的 Custom Provider 进行配置。该向导支持填写 Endpoint Compatibility、Base URL、API Key、Model ID 和可选模型别名。
进入向导后，根据页面提示完成以下选择。
1.安全确认
看到安全提示后选择：
Yes
按 Enter 继续。
2.设置模式
选择：
QuickStart
QuickStart 会使用本地 Gateway 的默认配置，适合首次配置用户。
四、添加 BenPay Custom Provider
进入模型服务商选择页面后，不要选择：
OpenAI API Key
该选项用于连接 OpenAI 官方接口，不能直接使用 BenPay API Key。
请向下查找并选择：
More...
然后选择：
Custom Provider
五、填写 BenPay API 参数
-
填写 Base URL
输入：https://api.benpay.ai/openai/v1
OpenClaw 会根据所选兼容类型自动使用对应请求路径。
-
填写 API Key
当页面询问 API Key 保存方式时，首次配置可以选择：
Paste API key now
粘贴刚才从 BenPay 创建并保存的完整 API Key。
输入密钥时，终端可能不会显示具体字符，这是正常现象。
-
填写 Model ID
输入从 BenPay Supported Models 页面复制的完整 Model ID，例如：
value/gpt-5.5-sol
参数对应关系
| OpenClaw 配置 | BenPay 参数 |
| Provider | Custom Provider |
| Compatibility | OpenAI-compatible /chat/completions |
| Base URL | https://api.benpay.ai/openai/v1 |
| API Key | 用户创建的 BenPay AI API Key |
| Model ID | Supported Models 页面中的完整 Model ID |
六、等待模型验证
填写完成后，OpenClaw 会向模型发起一次真实请求，用于检查：
-
API Key 是否有效；
-
Base URL 是否能够访问；
-
Model ID 是否正确；
-
模型是否能够正常回复。
OpenClaw 只有在真实模型请求验证成功后，才会保存并启用对应推理配置。
验证成功后，页面会显示类似：
验证成功
七、频道设置
模型配置完成后，OpenClaw 会询问是否连接消息频道，例如：
-
Telegram
-
Discord
-
Slack
-
Feishu
-
WhatsApp
-
iMessage
如果只准备在 OpenClaw 应用中使用，可以选择：
暂时跳过
频道属于可选功能，不会影响 BenPay AI API 的模型调用。之后可以通过以下命令单独配置：
openclaw channels add
八、完成配置并开始使用
完成向导后，重启打开 OpenClaw 应用。
OpenClaw 在检测到本地 Gateway 可用且默认模型已经配置后，会直接进入正常聊天界面。
如果模型能够正常回复，说明 BenPay AI API 已经成功接入 OpenClaw。