一、問題描述

容器正在運行，端口已正確映射，但無法通過 http://localhost:18789 訪問OpenClaw Web界面。

二、問題根源

配置向導可能修改了Web UI的綁定地址或啟用了身份驗證機制，導致外部無法正常訪問。

常見原因：

• 配置文件中的 bind 被設置 為 loopback 或 127.0.0.1
• 啟用了Token或密碼身份驗證
• 配置文件中的認證模式設置不當

三、排查步驟

步驟1：確認容器是否還在運行

docker ps | Select-String "openclaw"

• ? 如果看到狀態(tài)為 Up，說明容器還在運行，繼續(xù)下一步
• ? 如果沒有輸出或狀態(tài)為 Exited，說明容器意外退出

查看錯誤日志：

docker logs openclaw --tail=50

步驟2：檢查端口映射是否正常

docker port openclaw

預期輸出：18789/tcp -> 0.0.0.0:18789

• ? 如果輸出正確，繼續(xù)下一步
• ? 如果輸出為空或端口不對，說明端口映射丟失

步驟3：查看容器日志

docker logs openclaw 2>&1 | Select-String -Pattern "token|http|listening|bind"

重點關注：

• Gateway listening on http://0.0.0.0:18789 - 服務正常監(jiān)聽
• Access with token: http://localhost:18789?token=xxxx - 需要Token訪問
• bind address already in use - 端口被占用
• permission denied - 權限問題

步驟4：重啟容器

docker restart openclaw

等待10-20秒后，再次訪問 http://localhost:18789

四、問題解決

問題1：bind設置為loopback

癥狀：配置文件中的 "bind": "loopback" 導致Web UI只允許容器內部訪問

解決方法：

1. 編輯配置文件 Z:\Tools\docker\openclaw\data\openclaw.json
2. 找到 "bind": "loopback" 這一行
3. 修改為：

"bind": "0.0.0.0"

或者直接刪除該行（使用默認值）

1. 保存文件
2. 重啟容器：

docker restart openclaw

問題2：啟用了Token認證

癥狀：日志中顯示需要Token才能訪問

解決方法：

1. 從日志中找到完整的Token URL：

Access with token: http://localhost:18789?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

1. 直接使用該URL訪問

問題3：需要密碼登錄

癥狀：訪問時彈出密碼輸入框

解決方法：

使用設置的環(huán)境變量密碼：Perfect1@34

問題4：認證模式設置為必須驗證

癥狀：所有訪問都被拒絕

解決方法：

1. 編輯配置文件 Z:\Tools\docker\openclaw\data\openclaw.json
2. 添加或修改認證模式：

{
  "gateway": {
    "auth": {
      "mode": "none"
    }
  }
}

1. 保存并重啟容器

注意：禁用認證會讓任何能訪問該端口的人直接控制OpenClaw，僅在個人電腦或內網環(huán)境使用。

五、完整配置文件示例

以下是推薦的配置文件內容：

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

六、驗證修復

1. 確認bind配置已更改

docker exec openclaw Select-String -Pattern "bind" /home/node/.openclaw/openclaw.json

應該顯示 "bind": "0.0.0.0"

2. 測試Web訪問

在瀏覽器中訪問：

http://localhost:18789

或嘗試：

http://127.0.0.1:18789

3. 檢查服務狀態(tài)

docker logs openclaw 2>&1 | Select-String -Pattern "listening|ready"

七、終極解決方案

如果以上方法都不奏效，可以刪除容器并重新創(chuàng)建（保留數(shù)據(jù)卷）：

# 停止并刪除容器
docker stop openclaw
docker rm openclaw

# 重新創(chuàng)建容器
docker run -d `
  --name openclaw `
  --restart always `
  -p 18789:18789 `
  --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

八、補充說明

為什么會出現(xiàn)bind設置為loopback？

配置向導中某個選項（如安全提示）可能導致自動生成了 loopback 配置。在容器環(huán)境下，loopback 只允許容器內部訪問，對外不可見。

Windows防火墻檢查

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

端口沖突檢查

如果18789端口被其他程序占用，可以：

1. 查找占用端口的進程：netstat -ano | Select-String "18789"
2. 結束占用進程或使用其他端口

九、預防措施

1. 一勞永逸的配置方法：使用環(huán)境變量和 --add-host 參數(shù)創(chuàng)建容器
2. 定期備份配置文件：備份 Z:\Tools\docker\openclaw\data\openclaw.json
3. 記錄關鍵配置：記錄Token、密碼等重要信息
4. 使用固定版本鏡像：避免使用latest版本導致配置不兼容

以上就是OpenClaw無法訪問問題的排查指南的詳細內容，更多關于OpenClaw無法訪問問題的資料請關注腳本之家其它相關文章！

最新評論