OpenClaw访问localhost:8080空白或拒绝连接，大概率因端口被占用；需用netstat或lsof查PID，再taskkill/kill终止进程，或修改config.yaml中port为未占端口（如8081）并重启服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
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（端口号与配置一致即可）
