82 lines
2.9 KiB
Markdown
82 lines
2.9 KiB
Markdown
## 04 模型与 Provider 配置
|
||
|
||
> [OpenClaw 控制台使用手册](README.md) > 模型与 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 是否在本机运行：
|
||
|
||
```bash
|
||
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 界面与基础操作](03-界面与基础操作.md) | 下一篇：[05 飞书与 Cloud Boot 集成](05-飞书与CloudBoot集成.md)
|
||
|
||
返回 [章节目录](README.md)
|
||
|