大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



 
本教程基于实际部署经验，涵盖 DeepSeek、硅基流动、Ollama 本地模型，以及阿里云千问、腾讯云混元、智谱AI 等主流云端模型的配置。每一步都包含可能出现的问题及解决方案。
 

---

• 一、前置条件检查
• 二、安装 Ollama 本地模型
• 三、配置云端模型 API
  • 3.1 DeepSeek
  • 3.2 硅基流动（SiliconFlow）
  • 3.3 阿里云千问
  • 3.4 腾讯云混元
  • 3.5 智谱AI（ChatGLM）
  • 3.6 OpenAI（备选）
• 四、验证模型配置
• 五、设置默认模型和切换方式
• 六、常见问题汇总

---

1.1 确认 OpenClaw 服务运行状态

bash

# 查看服务状态 systemctl –user status openclaw-gateway

如果未运行，启动服务

systemctl –user start openclaw-gateway

可能遇到的问题：

1.2 确认 OpenClaw 版本

bash

openclaw –version

要求：2026.3.x 或更高版本

---

2.1 安装 Ollama

bash

# 一键安装 curl -fsSL https://ollama.com/install.sh | sh

或使用国内镜像（推荐）

curl -fsSL https://mirrors.aliyun.com/ollama/install.sh | sh

2.2 启动 Ollama 服务

bash

# 后台启动 ollama serve &

验证服务运行

curl -s http://localhost:11434/api/tags | python3 -m json.tool

可能遇到的问题：

2.3 下载本地模型

bash

# 下载千问系列（推荐） ollama pull qwen2.5:7b # 约 4.7GB ollama pull qwen2.5:1.5b # 约 1GB，轻量级 ollama pull qwen3.5:4b # 约 3.4GB

下载 DeepSeek 系列

ollama pull deepseek-r1:7b # DeepSeek 推理模型

下载 Llama 系列

ollama pull llama3.2:3b # Meta Llama 轻量版

查看已下载模型

ollama list

可能遇到的问题：

---

3.1 DeepSeek

获取 API Key：

1. 访问 https://platform.deepseek.com/
2. 注册/登录 → API Keys → 创建 API Key
3. 复制保存（格式：sk-xxxxxxxxxxxxxxxx）

配置命令：

bash

openclaw config set ‘models.providers.deepseek’ –json ‘{ “baseUrl”: “https://api.deepseek.com/v1";, ”apiKey“: ”sk-你的DeepSeek-API-Key“, ”api“: ”openai-completions“, ”models“: [

{"id": "deepseek-chat", "name": "DeepSeek Chat"}, {"id": "deepseek-reasoner", "name": "DeepSeek Reasoner"} 

] }’

可能遇到的问题：

---

3.2 硅基流动（SiliconFlow）

硅基流动提供丰富的开源模型 API，包括千问、DeepSeek、Llama 等。

获取 API Key：

1. 访问 https://siliconflow.cn/
2. 注册/登录 → API 密钥 → 创建 API 密钥
3. 复制保存（格式：sk-xxxxxxxxxxxxxxxx）

配置命令：

bash

openclaw config set ‘models.providers.siliconflow’ –json ‘{ ”baseUrl“: ”https://api.siliconflow.cn/v1";, “apiKey”: “sk-你的硅基流动API-Key”, “api”: “openai-completions”, “models”: [

{"id": "Qwen/Qwen2.5-7B-Instruct", "name": "硅基流动 Qwen 2.5 7B"}, {"id": "Qwen/Qwen2.5-14B-Instruct", "name": "硅基流动 Qwen 2.5 14B"}, {"id": "Qwen/Qwen2.5-72B-Instruct", "name": "硅基流动 Qwen 2.5 72B"}, {"id": "deepseek-ai/DeepSeek-V2.5", "name": "硅基流动 DeepSeek V2.5"}, {"id": "deepseek-ai/DeepSeek-V3", "name": "硅基流动 DeepSeek V3"}, {"id": "meta-llama/Meta-Llama-3.1-8B-Instruct", "name": "硅基流动 Llama 3.1 8B"}, {"id": "meta-llama/Meta-Llama-3.1-70B-Instruct", "name": "硅基流动 Llama 3.1 70B"} 

] }’

可能遇到的问题：

---

3.3 阿里云千问

获取 API Key：

1. 访问 https://bailian.console.aliyun.com/
2. 登录阿里云账号（需实名认证）
3. 密钥管理 → 创建 API-Key
4. 复制保存

配置命令：

bash

openclaw config set ‘models.providers.qwen’ –json ‘{ “baseUrl”: “https://dashscope.aliyuncs.com/compatible-mode/v1";, ”apiKey“: ”sk-你的千问API-Key“, ”api“: ”openai-completions“, ”models“: [

{"id": "qwen-plus", "name": "千问 Plus"}, {"id": "qwen-max", "name": "千问 Max"}, {"id": "qwen-turbo", "name": "千问 Turbo"}, {"id": "qwen2.5-72b-instruct", "name": "千问 2.5 72B"}, {"id": "qwen2.5-32b-instruct", "name": "千问 2.5 32B"} 

] }’

可能遇到的问题：

---

3.4 腾讯云混元

获取 API Key：

1. 访问 https://console.cloud.tencent.com/hunyuan
2. 登录腾讯云账号（需实名认证）
3. 接入管理 → 创建 API Key
4. 复制保存

配置命令：

bash

openclaw config set ‘models.providers.hunyuan’ –json ‘{ ”baseUrl“: ”https://api.hunyuan.cloud.tencent.com/v1";, “apiKey”: “你的混元API-Key”, “api”: “openai-completions”, “models”: [

{"id": "hunyuan-turbos-latest", "name": "混元 Turbo"}, {"id": "hunyuan-t1-latest", "name": "混元 T1"}, {"id": "hunyuan-lite", "name": "混元 Lite"} 

] }’

---

3.5 智谱AI（ChatGLM）

获取 API Key：

1. 访问 https://open.bigmodel.cn/
2. 注册/登录
3. API Keys → 创建 API Key
4. 复制保存

配置命令：

bash

openclaw config set ‘models.providers.zhipu’ –json ‘{ “baseUrl”: “https://open.bigmodel.cn/api/paas/v4";, ”apiKey“: ”你的智谱API-Key“, ”api“: ”openai-completions“, ”models“: [

{"id": "glm-4-plus", "name": "GLM-4 Plus"}, {"id": "glm-4-flash", "name": "GLM-4 Flash"}, {"id": "glm-4-air", "name": "GLM-4 Air"}, {"id": "glm-4-long", "name": "GLM-4 Long"} 

] }’

注意：智谱 API 的 baseUrl 可能需要根据文档调整。

---

3.6 OpenAI（备选）

获取 API Key：

1. 访问 https://platform.openai.com/
2. 注册/登录 → API Keys → Create new secret key
3. 复制保存

配置命令：

bash

openclaw config set ‘models.providers.openai’ –json ‘{ ”baseUrl“: ”https://api.openai.com/v1";, “apiKey”: “sk-你的OpenAI-API-Key”, “api”: “openai-completions”, “models”: [

{"id": "gpt-4o", "name": "GPT-4o"}, {"id": "gpt-4o-mini", "name": "GPT-4o Mini"}, {"id": "gpt-4-turbo", "name": "GPT-4 Turbo"}, {"id": "gpt-3.5-turbo", "name": "GPT-3.5 Turbo"} 

] }’

---

4.1 设置模型合并模式

bash

openclaw config set models.mode merge

4.2 查看已配置的模型提供商

bash

openclaw config get models.providers | python3 -c “ import sys, json data = json.load(sys.stdin) print(‘已配置的模型提供商:’) for provider in data.keys():

print(f' - {provider}') 

”

4.3 查看所有模型列表

bash

openclaw config get models.providers | python3 -c “ import sys, json data = json.load(sys.stdin) for provider, config in data.items():

print(f' 

{provider}:‘)

for model in config.get('models', []): print(f' - {model["id"]}') 

”

4.4 重启服务使配置生效

bash

systemctl –user restart openclaw-gateway sleep 3

可能遇到的问题：

---

5.1 查看当前默认模型

bash

openclaw config get agents.defaults.model.primary

5.2 设置默认模型

bash

# 设置为硅基流动千问 openclaw config set agents.defaults.model.primary siliconflow/Qwen/Qwen2.5-7B-Instruct

设置为 DeepSeek

openclaw config set agents.defaults.model.primary deepseek/deepseek-chat

设置为本地 Ollama

openclaw config set agents.defaults.model.primary ollama/qwen2.5:7b

设置为阿里千问

openclaw config set agents.defaults.model.primary qwen/qwen-plus

设置为智谱 GLM-4

openclaw config set agents.defaults.model.primary zhipu/glm-4-flash

5.3 重启服务

bash

systemctl –user restart openclaw-gateway

5.4 测试不同模型

bash

# 使用默认模型 openclaw agent –session-id test –message “你好，请用一句话介绍自己”

临时使用其他模型（不修改配置）

OPENCLAW_MODEL_PRIMARY=siliconflow/Qwen/Qwen2.5-7B-Instruct openclaw agent –session-id test –message “你好”

OPENCLAW_MODEL_PRIMARY=ollama/qwen2.5:7b openclaw agent –session-id test –message “1+1等于几？”

OPENCLAW_MODEL_PRIMARY=deepseek/deepseek-chat openclaw agent –session-id test –message “你好”

---

6.1 配置不生效

6.2 模型调用失败

6.3 openclaw models list 只显示部分模型

说明：这是正常现象。models list 可能只显示默认或已认证的模型，但配置的其他模型仍可通过环境变量或修改默认模型使用。

验证方法：

bash

# 直接测试模型是否可用 OPENCLAW_MODEL_PRIMARY=你的模型ID openclaw agent –session-id test –message “测试”

6.4 模型切换命令速查

bash

# 查看当前默认模型 openclaw config get agents.defaults.model.primary

切换默认模型（永久）

openclaw config set agents.defaults.model.primary 模型ID systemctl –user restart openclaw-gateway

临时切换（单次使用）

OPENCLAW_MODEL_PRIMARY=模型ID openclaw agent –session-id test –message “你的问题”

---

---

配置完成后，你拥有以下模型资源：

使用建议：

• 日常对话：DeepSeek 或硅基流动 Qwen 7B
• 复杂推理：硅基流动 DeepSeek V3 或千问 Max
• 中文任务：阿里千问或智谱 GLM-4
• 离线环境：本地 Ollama 模型

遇到问题：第一个命令永远是 openclaw doctor，它会自动检测并提示问题所在。

本回答由 AI 生成，内容仅供参考，请仔细甄别。