绿联 NAS：OpenClaw 调用 AI Plugins 本地大模型配置指南

绿联 NAS：OpenClaw 调用 AI Plugins 本地大模型配置指南


绿联 NAS 的 AI Plugins 应用集成了 Ollama 和 Open WebUI，可以方便地运行本地大模型。而 OpenClaw（小龙虾） 是一个强大的 AI 智能体，支持工具调用、知识库搜索等高级功能。
但默认情况下，OpenClaw 只能使用云端模型（如 MiniMax），无法直接调用 AI Plugins 中的本地模型——这限制了数据隐私和离线使用场景。
本配置方案可实现小龙虾调用AI Plugins 应用中Ollama服务，实现小龙虾本地模型调用，彻底摆脱云token焦虑。

📌 适用场景

• 绿联 NAS 已安装 AI Plugins（集成了 Ollama + Open WebUI）
• 绿联 NAS 已安装 OpenClaw（小龙虾）
• OpenClaw 使用 network_mode: host（常见于官方 Docker Compose 部署）
• 目标：让 OpenClaw 直接调用 AI Plugins 中的 Ollama 本地模型（如 qwen2.5:1.5b）
  
  
  

---

✅ 成功配置核心步骤

1️⃣ 确认 AI Plugins 容器内 Ollama 服务正常

# 进入 AI Plugins 容器
docker exec -it aiplugins-ai-plugins-1 bash

# 检查 Ollama 进程
ps aux | grep ollama

# 测试 Ollama API（应返回模型列表）
curl http://localhost:11434/api/tags

# 确认环境变量（应有 OLLAMA_HOST=0.0.0.0:11434）
env | grep OLLAMA

exit  # 退出容器
2️⃣ 获取 AI Plugins 容器的 IP 地址
docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' aiplugins-ai-plugins-1ect -f '{{range .NetworkSettings.Networks}}{{.IP   示例输出：172.17.0.2

记下这个 IP，后续会用到。

3️⃣ 修改 OpenClaw 配置文件

OpenClaw 的配置文件通常位于容器内的 /root/.openclaw/openclaw.json。
由于 OpenClaw 使用 host 网络模式，你可以直接在宿主机上编辑该文件（如果挂载了卷），或者进入容器修改。

方法 A：进入容器修改（推荐，避免路径错误）

docker exec -it openclaw-gateway-1 bash
vi /root/.openclaw/openclaw.json

docker exec -it openclaw-gateway-1 bashvi /root/.openclaw/openclaw.json

方法 B：如果配置文件已挂载到宿主机（例如 /volume1/docker/openclaw/config/openclaw.json），直接编辑。

需要修改的两处位置：

a) 添加本地模型供应商（在 models.providers 中）

"models": {
  "providers": {
    "my-local-ollama": {
      "baseUrl": "http://172.17.0.2:11434/v1",   // 替换为第2步获取的 IP
      "apiKey": "none",
      "api": "openai-completions",
      "models": [
        { "id": "qwen2.5:1.5b", "name": "本地Qwen 1.5B" },
        { "id": "deepseek-r1:1.5b", "name": "本地DeepSeek 1.5B" }
      ]
    }
  }
}

注意：id 必须与 ollama list 显示的模型名完全一致（包括 :1.5b 等标签）。

b) 修改默认模型（在 agents.defaults.model 中）
"agents": {
  "defaults": {
    "model": {
      "primary": "my-local-ollama/qwen2.5:1.5b"
    },
    ...
  }
}

保存文件并退出容器（如果是在容器内编辑）。

4️⃣ 重启 OpenClaw 网关

docker restart openclaw-gateway-1

5️⃣ 验证

• 方法一（命令行）：
  docker exec openclaw-gateway-1 openclaw chat --model my-local-ollama/qwen2.5:1.5b --prompt "你好"
• 方法二（Web 界面）：
  访问 http://你的NAS_IP:18789，在聊天界面下拉选择 本地Qwen 1.5B，发送消息测试。
  
  
  

---

⚠️ 重要注意事项

要点	说明
网络模式	OpenClaw 使用 host 模式时，无法通过容器名访问其他容器，必须用 IP 地址。
IP 变化	容器重启后 IP 可能改变，需要重新获取并修改配置。如需固定 IP，可创建自定义网络（但 host 模式容器无法加入自定义网络）。
模型名称	Ollama 模型名必须完全一致（含标签），例如 qwen2.5:1.5b 不能简写为 qwen2.5。
AI Plugins 状态	容器显示 unhealthy 不影响 Ollama 服务，只要 curl 测试正常即可。
防火墙	确保 NAS 防火墙未阻断 11434 端口（宿主机访问容器 IP 通常无需额外开放）。

---

🔁 快速修复清单（如果下次连接失败）

• 检查 AI Plugins 容器 IP 是否变化 → 重新执行 docker inspect 获取新 IP，并更新 openclaw.json 中的 baseUrl。
• 检查 Ollama 服务是否运行 → 进入 AI Plugins 容器执行 curl http://localhost:11434/api/tags。
• 检查 OpenClaw 配置格式 → 确保 JSON 语法正确（可用 cat openclaw.json | jq 验证）。
• 重启 OpenClaw 网关 → docker restart openclaw-gateway-1。
• 查看 OpenClaw 日志 → docker logs openclaw-gateway-1 --tail 50。
  
  
  

---

📦 可选：独立部署 Ollama 容器（避免依赖 AI Plugins）

如果你希望更稳定、不依赖 AI Plugins 的健康状态，可以单独运行官方 Ollama 容器：

docker run -d --name ollama \
  --network host \
  -v ollama_models:/root/.ollama \
  -e OLLAMA_HOST=0.0.0.0:11434 \
  ollama/ollama

然后 OpenClaw 的 baseUrl 直接填 http://127.0.0.1:11434/v1（因为 host 网络模式）。
这种方式更简单，且不受 AI Plugins 升级影响。

---

💎 总结

你的成功关键在于：

• ✅ 确认 AI Plugins 内部 Ollama 正常
• ✅ 获取正确的容器 IP
• ✅ 修改 OpenClaw 配置指向该 IP
• ✅ 重启服务
  
  
  

以上步骤已完整验证，下次直接按顺序操作即可。如果遇到新问题，随时可以回来参考这份指南。

以上步骤亲测有效，有问题欢迎探讨和补充。

如果需小龙虾进行tools调用能力，需本地模型7b及以上！

本内容部分/全部由AI生成