OpenClaw访问localhost:8080空白或拒绝连接，大概率因端口被占用；需用netstat或lsof查PID，再taskkill/kill终止进程，或修改config.yaml中port为未占端口（如8081）并重启服务。

OpenClaw启动后浏览器访问 localhost:8080 显示空白页或连接被拒绝，大概率是 8080 端口已被其他程序（如 Docker、Python Flask 服务、旧版 OpenClaw 进程）占用，必须释放端口才能正常加载 Web 界面。

确认 8080 端口是否被占用

打开终端（Windows 用 PowerShell，macOS/Linux 用 Terminal），执行命令查看监听 8080 的进程：

netstat -ano | findstr :8080（Windows）→ 或 lsof -i :8080（macOS/Linux）

如果返回结果含 PID（如 12345），说明端口正被占用；若无输出，则问题不在端口冲突，需排查其他原因。

强制终止占用 8080 的进程

方法一：根据上一步查到的 PID 终止进程

Windows 执行：taskkill /PID 12345 /F（把 12345 替换为实际 PID）

macOS/Linux 执行：kill -9 12345

方法二：一键杀掉所有监听 8080 的进程（慎用，可能误杀开发服务）

macOS/Linux：lsof -ti:8080 | xargs kill -9

Windows：netstat -ano | findstr :8080 | ForEach-Object { $_ -split 's+' | Select-Object -Index 4 } | ForEach-Object { taskkill /PID $_ /F }

【务必先确认 PID 对应的是非关键进程】比如 Chrome 浏览器不会监听 8080，但 Node.js、Docker Desktop、旧 OpenClaw 后台进程会。误杀系统服务可能导致本地开发环境异常。

修改 OpenClaw 默认端口并重启

第一步：定位 OpenClaw 配置文件

进入 OpenClaw 安装目录 → 找到 config.yaml 或 settings.json（具体名称依版本而定，常见路径：./resources/config/ 或 ./conf/）

第二步：编辑配置文件

用 VS Code 或记事本打开该文件，搜索 port 或 server.port 字段，将值从 8080 改为未被占用的端口，例如 8081、3000 或 8888

第三步：保存文件后重启 OpenClaw

关闭当前 OpenClaw 进程 → 双击启动器或运行 ./openclaw（Linux/macOS）/ openclaw.exe（Windows）→ 等待日志显示 Server started on http://localhost:8081 类似提示

第四步：浏览器访问新地址

打开 http://localhost:8081（端口号与配置一致即可）