karuo-ai/开发文档/10、使用手册/OpenClaw控制台/04-模型与Provider配置.md

04 模型与 Provider 配置

OpenClaw 控制台使用手册 > 模型与 Provider 配置

---

4.1 当前默认模型与 Provider（本机状态）

根据 clawdbot/references/Claw中Ollama配置说明.md，当前本机默认配置为：

项	值
主模型	ollama/qwen2.5:3b
Provider	内置 ollama（本机 http://localhost:11434）
认证方式	auth.profiles["ollama:local"]，mode: "api_key"
配置文件	~/.openclaw/openclaw.json

本机已存在模型：qwen2.5:1.5b、qwen2.5:3b、nomic-embed-text:latest，默认用 qwen2.5:3b。

---

4.2 在控制面板中切换 Ollama 模型

1. 打开 http://127.0.0.1:18789/config。
2. 左侧进入「配置」→「Models」。
3. 在「代理默认模型」处选择或填写其中一种：
   • ollama/qwen2.5:3b（当前默认）
   • ollama/qwen2.5:1.5b
   • ollama/nomic-embed-text:latest（一般用于嵌入，不建议当主对话模型）
4. 保存配置，新建的会话将使用新模型。

注意：如果在会话中没有立刻感知到变化，请新建会话再测试。

---

4.3 确保 Ollama 服务运行

如果模型调用失败，首先确认 Ollama 是否在本机运行：

curl -s http://localhost:11434/api/tags

预期结果：返回一个包含模型列表的 JSON。如果无返回或报错：

• 尝试从启动项中打开 Ollama 应用；
• 或在菜单中选择「Open Ollama」并确认服务已启动。

---

4.4 配置 v0/Claude 作为备选 Provider（可选）

当你希望在本地模型之外，保留一个云端模型作为后备时，可以添加 v0 Provider：

1. 在控制面板「配置」→「Models」中新增一个 Provider：
   • 基础 URL：https://api.v0.dev/v1
   • 模型 ID：v0-1.5-md 或 v0-1.5-lg（不要再使用 v0-1.0-md）
   • API 密钥：你的 v0 secret。
2. 将该 Provider 标记为 fallback，而主 Provider 仍保持为 ollama 的 qwen2.5:3b。

数据流将变为：

• 正常情况下优先使用本机 ollama/qwen2.5:3b。
• 当本机调用失败时，由网关自动尝试 fallback Provider（如 v0，对接 Claude 等）。

---

4.5 常见配置错误与排查

症状	可能原因	排查建议
所有对话都报超时或 500	Ollama 未启动，或 baseUrl 配错	使用 curl 测本机接口；检查 ~/.openclaw/openclaw.json 中的 Provider 配置。
仅部分会话报错	某个 Provider 或模型配置不完整	在「配置 → Models」中检查该 Provider 的 baseUrl、API Key、模型 ID。
使用量统计中 Provider 一直是 unknown	会话未正确记录 Provider 字段	升级 OpenClaw 版本或检查日志，确认请求是否被中间层改写。

---

上一篇：03 界面与基础操作 | 下一篇：05 飞书与 Cloud Boot 集成

返回 章节目录