首页 / 数字化 / 人工智能 / OpenClaw教程

OpenClaw添加模型

OpenClaw

类型：人工智能

OpenClaw（曾用名：Clawdbot、Moltbot），一款可以部署在个人电脑上的AI代理，采用“龙虾”图标设计，核心开发语言为TypeScript。如果你想快速上手OpenClaw却不知从何开始，本系列教程就是你的一站式指南！站长百科会手把手拆解OpenClaw安装的前置条件、OpenClaw安装部署的关键步骤，以及OpenClaw使用个性化配置与平台对接技巧，让你从配置到实操，每一步都清晰易懂。

OpenClaw小龙虾交流群：1087382156

百科词条 访问网站

OpenClaw 安装好后，添加模型主要有三种方式：使用可视化面板配置、通过交互式命令（推荐新手） 或直接编辑配置文件。你可以根据自己使用的模型服务商（如硅基流动、阿里云、OpenAI等）选择对应的方法。

方式一：使用可视化面板配置（适合新手，无代码）

此方法无需具备任何编程知识，一般会提供一个易于操作的管理面板，如宝塔面板、阿里云、腾讯云等厂商，提供一键式OpenClaw部署，包括安装之后的模型配置。不过使用此方法需要购买其产品，一般是云服务器、VPS及其他服务。

相关教程：

《阿里云部署OpenClaw集成钉钉》

《宝塔OpenClaw插件版快速部署》

《腾讯云部署OpenClaw》

《UCloud部署OpenClaw》

《七牛云一键部署OpenClaw》

《华为云部署OpenClaw接入钉钉》

方法二：使用交互式命令配置

在终端中运行配置向导，按照提示选择或输入模型信息：

# 启动配置向导openclaw onboard

在配置过程中：

Model/Auth Provider：选择你的模型服务商（如 OpenAI、Custom 或 Skip for now 稍后配置）。

如果选择 Custom，会提示输入 Base URL（模型API地址）、API Key（你的密钥）和 Model Name（模型ID）

方法三：直接编辑配置文件

OpenClaw 的主配置文件位于 ~/.openclaw/openclaw.json，你可以直接修改它来添加模型。

1、打开配置文件

#nano ~/.openclaw/openclaw.json

2、根据你的服务商添加配置

找到配置文件中的 models.providers 字段，按照下面的模板添加你的模型。添加完成后，保存文件并重启网关生效：

#openclaw gateway restart

配置示例：添加 OpenAI 兼容接口（如硅基流动、本地 Ollama 等）

这是最通用的格式，适用于大多数服务商

{ "models": { "mode": "merge", "providers": { "my-provider": { // 自定义服务商名称 "baseUrl": "https://api.siliconflow.cn/v1", // 替换为你的API地址 "apiKey": "sk-xxxxxxxxxx", // 替换为你的真实密钥 "api": "openai-completions", "models": [ { "id": "deepseek-ai/DeepSeek-V3", // 模型ID "name": "DeepSeek-V3", // 显示名称 "contextWindow": 65536, // 上下文窗口大小 "maxTokens": 8192, // 最大输出token "input": ["text"] } ] } } }, "agents": { "defaults": { "model": { "primary": "my-provider/deepseek-ai/DeepSeek-V3" // 引用格式：服务商名/模型ID } } } }

配置示例：添加阿里云百炼（DashScope）

阿里云百炼也兼容OpenAI接口格式，注意地域对应的 baseUrl 不同。

{ "providers": { "bailian": { "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", // 北京地域 "apiKey": "sk-xxxxxxxxxx", // 你的DashScope API Key "api": "openai-completions", "models": [ { "id": "qwen3-max-2026-01-23", // 千问模型ID "name": "通义千问Max", "reasoning": false, // 千问模型需设置为false "contextWindow": 262144, "maxTokens": 65536 } ] } } }

配置示例：添加百度千帆

百度千帆的模型配置类似，需要替换 apiKey 和模型 id。

{ "providers": { "qianfan": { "baseUrl": "https://qianfan.baidubce.com/v2", "apiKey": "你的千帆API Key", "api": "openai-completions", "models": [ { "id": "ernie-4.5-turbo-128k-preview", // 千帆模型ID "name": "文心4.5", "maxTokens": 12288 } ] } } }

3、验证模型是否添加成功

配置完成后，运行以下命令检查模型列表和状态：

# 查看所有已配置的模型 #openclaw models list # 检查整体配置是否有误 #openclaw doctor

如果一切正常，你就可以在 openclaw tui 或 openclaw dashboard 的Web界面中选择并使用新添加的模型了。

广告合作

QQ群号：4114653