帮你快速理解、总结文档立即下载
文档中心>云服务器>操作指南>企业 AI 智能体管控台 ClawPro 操作指南>模型配置>自定义模型接入指南

自定义模型接入指南

最近更新时间：2026-10-28 23:06:03
本文档已由 AI 辅助审校
我的收藏

本页目录：

操作场景

您在 ClawPro 用户端创建 Agent 后，可参考本文为该 Agent 接入自定义大模型。若 Agent 尚未配置模型，新增模型会作为主模型；若已有主模型，新增模型会作为备用模型，需切换后才能作为主模型使用。
注意：
用户端使用自定义模型产生的 Token 费用由用户个人自行承担，不计入企业提供的 Tokens 额度。

前提条件

已登录 ClawPro 用户端，目标 Agent 已创建，且处于运行中状态。
管理员已在 ClawPro 管控端基础信息 > 平台策略的功能权限开关中，开启允许用户「配置模型」与允许用户「添加自定义模型」。
已获取目标模型服务商的 API Key、Base URL 与模型 ID。

操作步骤

接入自定义模型

1. 登录 ClawPro 用户端，单击目标 Agent，进入基础配置页面。如下图所示：

2. 在模型中根据当前 Agent 的模型配置情况选择对应操作：
尚未配置模型：单击添加主模型。
已配置主模型：单击添加备用模型。
3. 本文以添加主模型为例，在弹出的添加主模型弹窗中，进行以下配置。如下图所示：

模型来源：选择自行配置 > 自定义模型。
选择表单输入或 JSON 输入填写配置。各字段说明如下表：
参数
是否必选
说明
示例
Base URL（base_url）
是
模型服务的基础 API 访问地址，需与所选协议匹配
https://api.siliconflow.cn/v1
API（api）
是
API 协议类型：
openai-completions 用于兼容 OpenAI Chat Completions API 的模型
anthropic-messages 用于兼容 Anthropic Messages API 的模型
openai-completions
API Key（api_key）
是
模型提供商提供的 API Key
sk-xxx
Model ID（model.id）
是
模型的唯一标识符
deepseek-ai/DeepSeek-V3.2
Model Name（model.name）
否
不填写则默认 Model ID
DeepSeek-V3.2
说明：
多模态模型开关用于向 ClawPro 声明该模型支持图片输入。请先确认模型本身支持多模态，否则对话中上传图片或文件可能失败。
4. 填写完成后，可单击连通性检测，检查所填 Base URL、API Key 与模型能否连通。检测通过仅表示该配置可连通，不代表模型输出效果或全部能力可用。
5. 单击确认添加。
如需将新增的备用模型设为主模型，可在已应用模型列表中单击对应模型的切换为主模型图标，并在弹窗中确认。切换后，原主模型将变为备用模型。切换过程中 Gateway 服务会重启，Agent 可能短暂不可用。

附录

以下示例用于说明字段结构与常见服务商的接入方式，不保证在您的账号、地域或模型版本下可直接使用。实际配置请以服务商当前文档中的 Base URL、模型 ID、API 协议、账号权限与计费规则为准；示例中的 api_key 请替换为实际值。

MiniMax 模型

中国版
国际版
您可前往 MiniMax 中国站官网 获取 API-Key，本文以使用 MiniMax-M2.5模型、Anthropic 协议为例，可按照如下代码进行配置：
  {
  "provider": "minimax",
  "base_url": "https://api.minimaxi.com/anthropic",
  "api": "anthropic-messages",
  "api_key": "your-api-key-here",
  "model": { "id": "MiniMax-M2.5", "name": "MiniMax M2.5" }
}
您可前往 MiniMax 国际站官网 获取 API-Key，本文以使用 MiniMax-M2.5模型、Anthropic 协议为例，可按照如下代码进行配置：
  {
  "provider": "minimax",
  "base_url": "https://api.minimax.io/anthropic",
  "api": "anthropic-messages",
  "api_key": "your-api-key-here",
  "model": { "id": "MiniMax-M2.5", "name": "MiniMax M2.5" }
}

硅基流动模型

本文以使用 DeepSeek V3.2 模型、OpenAI 协议为例，可按照如下代码进行配置：
  {
  "provider": "siliconflow",
  "base_url": "https://api.siliconflow.cn/v1",
  "api": "openai-completions",
  "api_key": "your-api-key-here",
  "model": {
    "id": "deepseek-ai/DeepSeek-V3.2",
    "name": "DeepSeek-V3.2"
  }
}

Kimi Code 模型

本文以使用 Kimi-K2.5 模型、Anthropic 协议为例，可按照如下代码进行配置：
注意
在非官方（Kimi CLI）中使用 Kimi Code 会员权益可能被 Kimi 视为滥用和违规，导致会员权益停用或账号封禁。详情请参见 Kimi Code 使用范围。
  {
  "provider": "kimicode",
  "base_url": "https://api.kimi.com/coding",
  "api": "anthropic-messages",
  "api_key": "your-api-key-here",
  "model": {
    "id": "kimi-k2.5",
    "name": "Kimi K2.5"
  }
}

Google Gemini 模型

本文以使用 Gemini 3 Flash 模型、OpenAI 协议为例，可按照如下代码进行配置：
  {
  "provider": "google",
  "base_url": "https://generativelanguage.googleapis.com/v1beta/openai",
  "api": "openai-completions",
  "api_key": "your-api-key-here",
  "model": {
    "id": "gemini-3-flash-preview",
    "name": "Gemini 3 Flash"
  }
}

OpenAI (GPT) 模型

以使用 GPT-5.2 模型、OpenAI 协议为例，可按照如下代码进行配置：
  {
  "provider": "openai",
  "base_url": "https://api.openai.com/v1",
  "api": "openai-completions",
  "api_key": "your-api-key-here",
  "model": {
    "id": "gpt-5.2",
    "name": "GPT-5.2"
  }
}

Anthropic Claude 模型

本文以使用 Claude Opus 4.6 模型、Anthropic 协议为例，可按照如下代码进行配置：
您也可参考 官方文档 进行配置。
  {
  "provider": "anthropic",
  "base_url": "https://api.anthropic.com",
  "api": "anthropic-messages",
  "api_key": "your-api-key-here",
  "model": {
    "id": "claude-opus-4-6",
    "name": "Claude Opus 4.6"
  }
}

xAI Grok 模型

本文以使用 Grok 4.1 模型、OpenAI 协议为例，可按照如下代码进行配置：
  {
  "provider": "xai",
  "base_url": "https://api.x.ai/v1",
  "api": "openai-completions",
  "api_key": "your-api-key-here",
  "model": {
    "id": "grok-4.1",
    "name": "Grok 4.1"
  }
}

OpenRouter 模型

本文以使用 NVIDIA: Nemotron 3 Nano 30B A3B 模型、OpenAI 协议为例，可按照如下代码进行配置：
 {
  "provider": "openrouter",
  "base_url": "https://openrouter.ai/api/v1",
  "api": "openai-completions",
  "api_key": "your-api-key-here",
  "model": {
    "id": "nvidia/nemotron-3-nano-30b-a3b:free",
    "name": "NVIDIA: Nemotron 3 Nano 30B A3B"
  }
}

其他模型

如上述示例中无期望模型，您也可以使用以下通用模板接入任何兼容 OpenAI/Anthropic 协议的模型：
{
  "provider": "provider_name",
  "base_url": "baseurl",
  "api": "API协议",
  "api_key": "your-api-key-here",
  "model": {
    "id": "model_id",
    "name": "model_name"
  }
}

常见错误码

错误码
原因
解决方案
401 not authorized
API-Key 不正确
前往模型提供商检查写入的 API-Key 是否正确。
429/500
余额不足
充值或检查 API-Key 是否正确。
rate_limit
速率限制
更换提供商，或联系提供商获取更大配额。
名词释义：
RPM（Requests Per Minute）表示每分钟请求数。
TPM（Tokens Per Minute）表示每分钟处理的 Tokens 数量。
404
base_url 不正确
查看提供商文档寻找兼容 OpenAI Chat Completions API 或 Anthropic Messages API 的 base_url 地址。
403
该模型不支持此服务器地域
更换服务器地域为模型支持的地域或更换模型。


中国站