一、概述

本文檔介紹如何在OpenClaw（龍蝦）中連接并使用本地Ollama模型。配置成功后，可以在Web界面中選擇并使用已下載的Ollama模型進行智能對話。

二、驗證Ollama服務(wù)狀態(tài)

在配置之前，先確認Ollama服務(wù)正常運行并已下載所需模型。

1. 檢查Ollama服務(wù)

訪問以下地址確認服務(wù)狀態(tài)：

http://host.docker.internal:11434

應(yīng)返回 “Ollama is running”

2. 查看可用模型

訪問API接口查看已下載的模型列表：

http://host.docker.internal:11434/api/tags

當(dāng)前已安裝的模型：

• deepseek-r1:latest - 8.2B參數(shù)，深度求索開發(fā)，中文理解能力強
• llama3:latest - 8.0B參數(shù)，Meta開發(fā)，通用對話能力強
• nomic-embed-text:latest - 137M參數(shù)，文本嵌入模型

三、網(wǎng)絡(luò)配置問題解決

問題根源

Docker容器內(nèi)部所理解的 127.0.0.1 或 localhost，指向的是容器自己的虛擬空間，而不是運行Ollama的Windows宿主機。這就像容器在問"自己"要模型，自然就找不到服務(wù)。

解決方案：使用 host.docker.internal

對于Windows版的Docker Desktop，它內(nèi)置了一個特殊的域名 host.docker.internal，專門用來讓容器訪問宿主機上的服務(wù)。

四、配置方法

方法一：Web UI配置（推薦）

• 訪問OpenClaw Web界面：http://localhost:18789
• 登錄后，點擊側(cè)邊欄的 Settings 進入設(shè)置頁面
• 找到 Model Providers 或類似的模型管理選項
• 在提供商列表中找到 Ollama，點擊進行配置
• 確認 API URL 或 Base URL 正確：

http://host.docker.internal:11434

• 如果沒有自動發(fā)現(xiàn)模型，手動添加模型，填寫完整的模型名稱：
  • deepseek-r1:latest
  • llama3:latest
• 配置完成后，在創(chuàng)建新聊天對話時，在頂部下拉菜單中選擇所需的Ollama模型

方法二：使用 onboard 命令配置

如果Web界面中沒有找到合適的設(shè)置入口，可以使用交互式向?qū)渲茫?/p>

進入OpenClaw容器終端：

docker exec -it openclaw /bin/sh

運行配置向?qū)В?/p>

openclaw onboard

當(dāng)向?qū)нM行到 “Ollama base URL” 這一步時，輸入新地址：

http://host.docker.internal:11434

繼續(xù)完成后續(xù)的設(shè)置，確認默認模型

退出容器并重啟服務(wù)：

exit
docker restart openclaw

方法三：環(huán)境變量配置（推薦長期使用）

為了避免每次都需要手動輸入地址，可以通過修改容器配置來一勞永逸地解決問題：

停止并移除當(dāng)前容器：

docker stop openclaw
docker rm openclaw

重新創(chuàng)建容器，添加 --add-host 參數(shù)和環(huán)境變量：

docker run -d `
  --name openclaw `
  --restart always `
  -p 18789:18789 `
  -p 3000:3000 `
  -p 5173:5173 `
  --add-host=host.docker.internal:host-gateway `
  -v "Z:\Tools\docker\openclaw\data:/home/node/.openclaw" `
  -v "Z:\Tools\docker\openclaw\config:/app/config" `
  -e OLLAMA_BASE_URL=http://host.docker.internal:11434 `
  -e DEFAULT_MODEL=deepseek-r1:latest `
  ghcr.io/openclaw/openclaw:latest

關(guān)鍵參數(shù)說明：

• --add-host=host.docker.internal:host-gateway：將宿主機地址固化到容器配置
• OLLAMA_BASE_URL=http://host.docker.internal:11434：設(shè)置Ollama服務(wù)地址

方法四：配置文件手動配置

• 導(dǎo)航到持久化數(shù)據(jù)目錄：Z:\Tools\docker\openclaw\data
• 找到或創(chuàng)建 openclaw.json 配置文件
• 添加或修改以下內(nèi)容：

{
  "models": {
    "providers": {
      "ollama": {
        "baseUrl": "http://host.docker.internal:11434",
        "apiKey": "ollama-local"
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "ollama/deepseek-r1:latest"
      }
    }
  }
}

• 保存文件并重啟容器：

docker restart openclaw

五、驗證配置成功

1. 容器內(nèi)測試連通性

運行以下命令，檢查容器是否能連接到Ollama并返回模型列表：

docker exec openclaw curl http://host.docker.internal:11434/api/tags

如果返回了包含 deepseek-r1:latest 模型的JSON信息，代表連接成功。

2. Web界面測試

• 訪問 http://localhost:18789
• 創(chuàng)建新聊天對話
• 在模型選擇下拉菜單中確認能看到Ollama模型
• 發(fā)送測試消息，確認模型能正常響應(yīng)

3. 命令行驗證

# 列出OpenClaw可用的所有模型
docker exec openclaw openclaw models list

如果列表中包含 deepseek-r1:latest，說明配置成功。

六、常見問題排查

1. 確保Ollama服務(wù)已運行

• 確認宿主機上的Ollama服務(wù)正在運行
• 確認 deepseek-r1:latest 模型已下載

2. 網(wǎng)絡(luò)連通性測試

在容器內(nèi)執(zhí)行：

curl http://host.docker.internal:11434/api/tags

如果返回模型列表，說明網(wǎng)絡(luò)連接正常。

3. Windows防火墻檢查

如果依然連接失敗，檢查Windows Defender防火墻，確保沒有阻止Docker的網(wǎng)絡(luò)訪問。

4. 模型響應(yīng)失敗

• 確認模型已下載到Ollama
• 驗證模型名稱正確
• 查看OpenClaw和Ollama日志尋找錯誤信息

5. 檢查模型是否支持工具調(diào)用

為了完整使用OpenClaw的Skills功能，模型需要支持工具調(diào)用（Function Calling）。

支持工具調(diào)用的主流模型：

• deepseek-r1
• qwen2.5
• llama3.1

七、最佳實踐

• 推薦使用方法三：通過環(huán)境變量和--add-host參數(shù)配置，一勞永逸
• 優(yōu)先使用Web UI配置：最方便直觀，不易出錯
• 使用onboard向?qū)?/strong>：自動完成大部分配置工作
• 選擇支持工具調(diào)用的模型：充分發(fā)揮OpenClaw能力
• 定期檢查模型更新：保持Ollama和OpenClaw為最新版本