OpenClaw 集成指南
OpenClaw 模型配置指南
OpenClaw 集成指南
OpenClaw 模型配置指南
1. 概述
本指南说明如何在 OpenClaw 中配置自定义模型提供商。
配置完成后,OpenClaw 可以通过指定的 API 端点调用模型,并将其用于本地 Agent 任务。
2. 前置条件
在开始之前,请确保你已具备以下条件:
- 你的设备上已安装 OpenClaw。
- 一个有效的 API Key。
- 你想要使用的模型名称。
- 能够正常访问 API 服务的网络环境。
在本地设备上打开终端或命令行工具。
macOS 或 Linux 用户可以使用终端(Terminal)。
Windows 用户可以使用命令提示符(Command Prompt)、PowerShell 或开发环境中的终端。
在终端中运行以下命令:
openclaw config按 Enter 进入配置流程。
在配置菜单中选择:
Local按 Enter。
此选项表示配置将应用于你的本地 OpenClaw 环境。
继续选择:
Model按 Enter。
此选项用于配置 OpenClaw 使用的模型服务。
选择:
Custom Provider按 Enter。
当你想要将 OpenClaw 连接到自定义的 OpenAI 兼容 API 服务时,请选择此选项。
当提示输入 API Base URL 时,输入:
https://api.wox.lol/v1按 Enter。
此地址告诉 OpenClaw 将模型请求发送到 WOX API 网关。
当提示输入 API Key 时,输入你的实际 API Key。
示例:
YOUR_API_KEY在大多数情况下,你不需要手动添加 Bearer 前缀,除非 OpenClaw 明确要求你输入完整的 Authorization Header。
当提示输入模型名称时,输入你想要使用的模型 ID。
示例:
YOUR_MODEL_ID请确保输入平台提供的完整模型 ID。
完成所有必填字段后,确认并保存配置。
保存成功后,OpenClaw 将使用此自定义提供商进行本地模型调用。
12. 配置示例
提供商类型:Custom Provider
API Base URL: https://api.wox.lol/v1
API Key: YOUR_API_KEY
模型: YOUR_MODEL_ID
13. 验证配置
配置完成后,你可以运行一个 OpenClaw 任务或启动一个测试会话。
如果配置正确,OpenClaw 应该能够向 API 服务发送请求并正常返回模型响应。
14. 故障排查
检查 API Base URL 是否正确:
https://api.wox.lol/v1同时确认你的 API Key 是有效的。
检查模型名称是否输入正确。
模型 ID 通常区分大小写。建议直接从平台复制模型名称。
检查 API Key 是否已过期、账户余额是否充足,以及该 Key 是否有权限访问目标模型。
确保你的设备能够正常访问 API 地址。
如果请求无法完成,请检查你的防火墙、代理或 VPN 设置。
15. 注意事项
对于 OpenAI 兼容的 API 服务,API Base URL 通常以 /v1 结尾。
正确示例:
https://api.wox.lol/v1通常不建议输入:
https://api.wox.lol/v1/chat/completions除非 OpenClaw 明确要求你输入完整的 API 端点。