Monk

集成指南 · 桌面

OpenClaw 集成指南

OpenClaw 模型配置指南

1. 概述

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

2. 前置条件

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

  1. 你的设备上已安装 OpenClaw。
  2. 一个有效的 API Key（sk-monk-*）。
  3. 你想要使用的模型名称：monk、monk-fast 或 monk-coding。
  4. 能够正常访问 API 服务的网络环境。

3. 分步配置

  1. 打开终端或控制台

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

  2. 打开 OpenClaw 配置界面

    在终端中运行以下命令，按 Enter 进入配置流程：

    openclaw config

  3. 选择本地配置

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

  4. 进入模型配置

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

  5. 选择自定义提供商

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

  6. 配置 API Base URL

    当提示输入 API Base URL 时，输入：

    https://monk.party/v1

    此地址告诉 OpenClaw 将模型请求发送到 Monk API 网关。

  7. 输入 API Key

    当提示输入 API Key 时，输入你的实际 API Key。示例：

    YOUR_API_KEY

    在大多数情况下，你不需要手动添加 Bearer 前缀，除非 OpenClaw 明确要求你输入完整的 Authorization Header。

  8. 输入模型名称

    当提示输入模型名称时，输入你想使用的模型 ID。示例：

    monk

    请确保输入平台提供的完整模型 ID。付费 Key 只接受 monk、monk-fast、monk-coding。

  9. 保存配置

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

4. 配置示例

提供商类型
Custom Provider
API Base URL
https://monk.party/v1
API Key
YOUR_API_KEY
模型
monk

5. 验证配置

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

curl https://monk.party/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"monk","messages":[{"role":"user","content":"你好"}]}'

6. 故障排查

1. API 请求失败

检查 API Base URL 是否正确：https://monk.party/v1。同时确认你的 API Key 是有效的 sk-monk-*。

2. 模型未找到

检查模型名称是否输入正确。模型 ID 区分大小写。建议直接填写 monk、monk-fast 或 monk-coding，不要填 gpt-4o 或 claude。

3. 认证失败

检查 API Key 是否已过期、月卡是否仍在有效期内，以及该 Key 是否有权限访问目标模型。可在「查询用量」核对。

4. 网络错误

确保你的设备能够正常访问 API 地址。如果请求无法完成，请检查防火墙、代理或 VPN 设置。

7. 注意事项

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

正确示例：

https://monk.party/v1

通常不建议输入：

https://monk.party/v1/chat/completions

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

← 帮助中心 · Oh My Pi 配置 · 常见问题