OpenClaw无法访问问题的排查指南

一、问题描述

容器明明还在运行，端口映射也检查了好几遍，但就是死活打不开 http://localhost:18789 这个地址。OpenClaw的Web界面始终无响应，这到底是怎么回事？

二、问题根源

问题往往出在配置向导上——它可能在你不经意间，修改了Web UI的绑定地址，或者顺手开启了身份验证机制，导致外部访问被拦在了门外。

那么，常见的原因有哪些？

• 配置文件中的 bind 被设置成 loopback 或 127.0.0.1，只允许容器内部访问
• 启用了Token或密码验证，访问时缺少凭证
• 认证模式配置不当，直接拒绝所有请求

三、排查步骤

步骤1：确认容器是否还在运行

俗话说得好，先确认“它还在”。

docker ps | Select-String "openclaw"

• ✅ 如果看到状态为 Up，说明容器还在喘气，可以继续往下走
• ❌ 如果没有任何输出，或者状态是 Exited，说明容器已经挂了

顺手看看错误日志，可能能抓到一些线索：

docker logs openclaw --tail=50

步骤2：检查端口映射是否正常

接下来，确认端口映射没丢：

docker port openclaw

正常情况下，你应该看到类似这样的输出：18789/tcp -> 0.0.0.0:18789

• ✅ 输出正确，说明端口映射没问题
• ❌ 输出为空，或者端口对不上，那映射确实丢了

步骤3：查看容器日志

日志里藏着大量信息，重点关注这几个关键词：

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

看看日志里有没有这些提示：

• Gateway listening on http://0.0.0.0:18789 - 服务正常监听，一切正常
• Access with token: http://localhost:18789?token=xxxx - 需要Token才能访问
• bind address already in use - 端口被占用了
• permission denied - 权限问题在作祟

步骤4：重启容器

有时候，重启能解决80%的问题——试试看：

docker restart openclaw

等待10-20秒，让容器重新启动完毕，然后再次访问 http://localhost:18789。

四、问题解决

问题1：bind设置为loopback

：你可能会发现，配置文件里写着 "bind": "loopback"。这行小字的意思就是：“老子只跟容器内部的人玩，外面的别来沾边。”

：

1. 编辑配置文件 Z:Toolsdockeropenclawdataopenclaw.json
2. 找到 "bind": "loopback" 这一行
3. 把它改成：

"bind": "0.0.0.0"

或者直接删掉这一行，让它用默认值也行。

1. 保存文件，然后重启容器：

docker restart openclaw

问题2：启用了Token认证

：日志里明确告诉你，需要Token才能访问。

：

1. 从日志里找到完整的Token URL，它长这样：

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

1. 直接复制这个URL，在浏览器里打开就行。

问题3：需要密码登录

：访问时浏览器弹出一个密码输入框，仿佛在问：“天王盖地虎？”

：

如果你设置了环境变量密码，就输入：Perfect1@34

问题4：认证模式设置为必须验证

：所有访问都被无情拒绝，连个提示都没有。

：

1. 编辑配置文件 Z:Toolsdockeropenclawdataopenclaw.json
2. 添加或修改认证模式，把“必须验证”改成“不验证”：

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

1. 保存并重启容器。

：把认证关了，意味着凡是能摸到你电脑端口的人，都能直接操控OpenClaw。这可不是闹着玩的——只在个人电脑或完全可信的内网环境这么干。

五、完整配置文件示例

这里是一份经过验证的参考配置，直接拿去用吧：

{
  "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. 检查服务状态

最后，跑个日志确认服务已经就绪：

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

七、终极解决方案

如果以上方法都试过了，OpenClaw还是不给面子，那就别挣扎了——直接删掉容器，重新建一个，保留数据卷就行：

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

# 重新创建容器
docker run -d `
  --name openclaw `
  --restart always `
  -p 18789:18789 `
  --add-host=host.docker.internal:host-gateway `
  -v "Z:Toolsdockeropenclawdata:/home/node/.openclaw" `
  -v "Z:Toolsdockeropenclawconfig:/app/config" `
  -e OLLAMA_BASE_URL=http://host.docker.internal:11434 `
  -e DEFAULT_MODEL=deepseek-r1:latest `
  ghcr.io/openclaw/openclaw:latest

八、补充说明

为什么会出现bind设置为loopback？

配置向导里某个“安全提示”选项，在你不小心点下去的时候，可能就自动生成了 loopback 配置。在容器环境下，loopback 只允许容器内部访问，对外完全不可见——这就是问题所在。

Windows防火墙检查

如果重启后还是不行，检查一下Windows Defender防火墙，看看是不是它把Docker的网络访问给拦了。

端口冲突检查

18789端口也可能被其他程序占用了。查一下：

netstat -ano | Select-String "18789"

找到占用端口的进程，把它干掉，或者换个端口。

九、预防措施

1. 一劳永逸的配置方法
   ：用环境变量和 --add-host 参数创建容器，省得日后再折腾。

2. 定期备份配置文件
   ：把 Z:Toolsdockeropenclawdataopenclaw.json 备份一份，防患于未然。

3. 记录关键配置
   ：像Token、密码这些重要信息，记下来，别等用时找不到。

4. 使用固定版本镜像
   ：尽量别用 latest 版本，避免版本更新带来的配置不兼容问题。