OpenClaw 配置 Ollama 本地 Qwen 模型完整指南下面将详细介绍如何将本地 Ollama 中已下载的 Qwen 模型配置到 OpenClaw 中实现完全本地化的 AI 助手体验。1. 环境准备与验证在开始配置前需要确保 Ollama 和 OpenClaw 的基础环境已正确安装并运行验证 Ollama 服务状态# 检查 Ollama 服务是否运行 ollama list如果正常显示已下载的模型列表如 qwen2.5:7b、qwen2.5:14b 等说明 Ollama 服务正常运行 。确认 Ollama API 可访问性# 测试 Ollama API 接口 curl http://localhost:11434/api/tags应该返回类似以下的 JSON 响应{ models: [ { name: qwen2.5:7b, modified_at: 2024-01-01T10:00:00.000Z, size: 7300000000, digest: sha256:abc123... } ] }2. OpenClaw 配置文件修改OpenClaw 的核心配置主要通过修改其配置文件来实现与 Ollama 的对接定位配置文件路径OpenClaw 主配置文件通常位于安装目录下的config文件夹中具体路径可能因安装方式而异常见位置包括~/.openclaw/config.json./config/gateway.json./config/model.json修改模型配置找到模型配置文件后需要添加或修改 Ollama 相关的配置项{ models: [ { name: qwen-local, type: ollama, config: { base_url: http://localhost:11434, model: qwen2.5:7b, api_key: , context_window: 8192, temperature: 0.7, max_tokens: 2048 } } ] }关键配置参数说明参数名称必需默认值说明base_url是http://localhost:11434Ollama 服务地址model是-Ollama 中下载的模型名称api_key否空字符串本地部署通常无需 API Keycontext_window否8192上下文窗口大小temperature否0.7生成文本的随机性max_tokens否2048单次生成的最大 token 数3. 网关服务配置如果使用 OpenClaw 的网关服务还需要配置网关文件网关配置文件示例# gateway.yaml 或类似配置文件 services: ollama-qwen: type: llm provider: ollama config: base_url: http://localhost:11434/v1 model: qwen2.5:7b credentials: api_key: 重要注意事项URL 路径确保使用/v1端点这是 OpenAI 兼容接口的标准路径模型标识模型名称必须与ollama list显示的名称完全一致网络可达性确保 OpenClaw 能够访问localhost:11434端口4. 服务重启与测试完成配置后需要重启相关服务使配置生效重启 OpenClaw 服务# 根据安装方式选择相应的重启命令 npm run restart # 或 ./scripts/restart.sh # 或 systemctl restart openclaw验证配置是否生效# 检查服务状态 curl http://127.0.0.1:18789/api/health # 或通过 OpenClaw Web 界面测试模型连接5. 常见问题排查连接失败问题# 检查端口监听状态 netstat -an | grep 11434 # 或 lsof -i :11434如果端口未监听可能需要重启 Ollama 服务# Windows net stop Ollama net start Ollama # macOS/Linux sudo systemctl restart ollama模型加载问题如果 OpenClaw 无法识别模型检查模型是否已正确下载# 重新拉取模型如果需要 ollama pull qwen2.5:7b # 验证模型详情 ollama show qwen2.5:7b性能优化配置对于资源受限的环境可以调整配置参数{ config: { base_url: http://localhost:11434, model: qwen2.5:0.5b, temperature: 0.3, max_tokens: 1024, timeout: 30000 } }6. 多模型配置示例如果需要配置多个 Qwen 模型可以按以下方式设置{ models: [ { name: qwen-fast, type: ollama, config: { base_url: http://localhost:11434, model: qwen2.5:0.5b, context_window: 4096 } }, { name: qwen-smart, type: ollama, config: { base_url: http://localhost:11434, model: qwen2.5:7b, context_window: 8192 } } ] }通过以上步骤您应该能够成功将本地 Ollama 中的 Qwen 模型配置到 OpenClaw 中实现完全本地化的 AI 助手功能。配置过程中如遇问题建议仔细检查每个步骤的日志输出多数问题都能通过日志信息找到解决方案 。参考来源Mac 本地部署 Ollama 大模型接入 OpenClaw 完整指南【Openclaw】零基础搭建本地AI助手用OpenClaw Ollama告别网络限制win11本地Qwen3.5 OllamaOpenClaw本地部署大模型省钱又安全OpenClaw小龙虾Ollama实操教程小白也能轻松上手本地离线部署AI大模型OpenClaw Ollama Qwen3.5:cloud/Qwen3:0.6b 超详细教程无需GPU最新中文版OpenClaw详细安装教程 包含云模型和本地模型部署方法