WOX 沃想 AI

OpenClaw 集成指南

OpenClaw 模型配置指南

OpenClaw 集成指南

OpenClaw 模型配置指南

1. 概述

本指南说明如何在 OpenClaw 中配置自定义模型提供商。

配置完成后,OpenClaw 可以通过指定的 API 端点调用模型,并将其用于本地 Agent 任务。

2. 前置条件

在开始之前,请确保你已具备以下条件:

  1. 你的设备上已安装 OpenClaw。
  2. 一个有效的 API Key。
  3. 你想要使用的模型名称。
  4. 能够正常访问 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. 故障排查

15. 注意事项

对于 OpenAI 兼容的 API 服务,API Base URL 通常以 /v1 结尾。

正确示例:

https://api.wox.lol/v1

通常不建议输入:

https://api.wox.lol/v1/chat/completions

除非 OpenClaw 明确要求你输入完整的 API 端点。