OpenClaw 安装好后,添加模型主要有三种方式:使用可视化面板配置、通过交互式命令(推荐新手) 或直接编辑配置文件。你可以根据自己使用的模型服务商(如硅基流动、阿里云、OpenAI等)选择对应的方法。
方式一:使用可视化面板配置(适合新手,无代码)
此方法无需具备任何编程知识,一般会提供一个易于操作的管理面板,如宝塔面板、阿里云、腾讯云等厂商,提供一键式OpenClaw部署,包括安装之后的模型配置。不过使用此方法需要购买其产品,一般是云服务器、VPS及其他服务。
相关教程:
方法二:使用交互式命令配置
在终端中运行配置向导,按照提示选择或输入模型信息:
# 启动配置向导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界面中选择并使用新添加的模型了。



