云服务器 自定义模型接入指南

一、操作场景

注意：用户端使用自定义模型产生的 Token 费用由用户个人自行承担，不计入企业提供的 Tokens 额度。

二、前提条件

·已登录 ClawPro 用户端，目标 Agent 已创建，且处于运行中状态。

·管理员已在 ClawPro 管控端基础信息 > 平台策略的功能权限开关中，开启允许用户「配置模型」与允许用户「添加自定义模型」。

·已获取目标模型服务商的 API Key、Base URL 与模型 ID。

三、接入自定义模型

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

2. 在模型中根据当前 Agent 的模型配置情况选择对应操作：

·尚未配置模型：单击添加主模型。

·已配置主模型：单击添加备用模型。

3. 这篇以添加主模型为例，在弹出的添加主模型弹窗中，进行以下配置。如下：

·模型来源：选择自行配置 > 自定义模型。

·选择表单输入或 JSON 输入填写配置。各字段说明如下表：

注意：说明：

注意：多模态模型开关用于向 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" }}

十四、常见错误码