OpenClaw 自定义模型供应商教程｜对接 Ollama、LM Studio、企业内部接口
本系列第十一篇：突破官方限制——给“龙虾”装上任意第三方大脑，从本地私有模型到企业内部推理服务
在上一篇文章中，我们系统讲解了阿里云百炼、OpenAI、Kimi K2.5 等主流供应商的接入方法。这些内置供应商已经足够应对大多数日常场景。
但在真实使用中，你一定会遇到官方列表之外的模型服务。比如公司内部的私有推理接口、新出的实验性模型、LM Studio 本地部署的自研模型，或是任何兼容 OpenAI API 协议的自定义服务。
这正是 OpenClaw Custom Provider 功能的用武之地。它让你能够接入任何支持 OpenAI API 兼容协议的模型服务——无论是云端还是本地、官方还是自建、付费还是免费。
本文将系统讲解 自定义模型供应商的完整接入流程，覆盖从命令行向导、手动配置文件编辑，到 Ollama、LM Studio、SGLang 等主流本地推理引擎的实战配置，以及模型降级、故障切换等企业级高阶技巧。
一、什么是 Custom Provider？为什么要用？
OpenClaw 内置支持的模型供应商（如 OpenAI、Anthropic、阿里云百炼、Moonshot 等）覆盖了大部分主流选择。但当你需要接入以下服务时，就需要用到自定义供应商功能：
本地推理引擎：Ollama、LM Studio、llama.cpp、SGLang 等本地运行的模型服务
企业内部 API：公司自建的私有推理服务（兼容 OpenAI 协议）
新兴云平台：官方尚未内置集成的新兴模型平台，如硅基流动 (SiliconFlow)、NVIDIA NIM、DeepSeek API 等
自定义端点：任何兼容 OpenAI API 协议的第三方服务
Custom Provider 的本质是为 OpenClaw 提供一个“万能适配器”——只要目标模型服务提供了 OpenAI 兼容的 API 端点，就可以通过自定义配置接入。
⚠️ 关键约束：自定义模型仅支持 OpenAI 兼容协议的 API 地址。请确认你的目标服务提供了类似
https://api.example.com/v1格式的端点，并支持/v1/chat/completions接口。绝大多数本地推理引擎（Ollama、LM Studio）都满足这一要求。
二、两种接入方式：向导 vs 手动配置
OpenClaw 提供了两种添加自定义供应商的方法，适用于不同使用场景。
2.1 方式一：通过 openclaw onboard 向导快速添加（推荐新手）
对于初学者或追求效率的场景，使用命令行向导是最直接的方式。该工具会以交互式问答的形式引导完成配置，无需手动编写 JSON 文件。
交互式设置步骤：
bash
openclaw onboard在向导的「Model and auth」步骤中，选择 Custom provider 选项。向导会依次询问以下关键信息：
| 参数 | 说明 | 示例 |
|---|---|---|
| Provider ID | 自定义供应商的唯一标识符 | my-local-llm |
| Base URL | 模型服务的 API 接入点地址 | http://localhost:1234/v1 |
| Model ID | 你要使用的具体模型的 ID | llama3-8b |
| API Key | 访问服务的 API 密钥。无需认证可填任意字符 | none 或 local-key |
| Compatibility | 兼容的 API 格式，通常选择 openai | openai |
完成这些步骤后，向导会自动将配置写入 ~/.openclaw/openclaw.json 文件。
非交互式命令（适合脚本化配置）：
如果需要在脚本中自动化配置，或者已经清楚所有配置参数，可以使用非交互式命令一次性完成设置：
bash
openclaw onboard \ --auth-choice custom-api-key \ --custom-provider-id my-local-model \ --custom-base-url http://localhost:8000/v1 \ --custom-model-id deepseek-coder-v2 \ --custom-api-key "your-api-key-if-needed" \ --custom-compatibility openai这条命令直接指定了所有必要信息，执行后即可完成自定义供应商的添加。
2.2 方式二：手动编辑配置文件（精细控制）
命令行向导只支持添加基础配置。如果需要更精细的控制，比如为同一个供应商定义多个模型、设置模型的上下文窗口大小、调整参数等，就需要手动编辑 OpenClaw 的核心配置文件。
配置文件位置：
Linux/macOS：
~/.openclaw/openclaw.jsonWindows：
C:\Users\用户名\.openclaw\openclaw.json
编辑前建议先备份此文件。
理解 models.providers 结构
打开配置文件，找到或添加 models 顶级字段，并在其中创建 providers 对象。所有的自定义供应商都将在这里定义。
一个基本的供应商配置结构如下：
json
{ "models": { "providers": { "my-provider": {