openclaw启动失败提示“address already in use”说明端口被占，需释放8080端口或修改配置为未占用端口（如8081），并以管理员/root权限操作；linux/macos用lsof或netstat查pid后sudo kill -9，windows用netstat查pid后taskkill /f /pid，再重启服务验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw启动失败并提示“Address already in use”或日志中显示端口绑定失败，说明目标端口正被其他进程占用，必须释放该端口或更换配置才能正常运行。
确认被占用的端口
打开终端（Windows用CMD/PowerShell，macOS/Linux用Terminal），执行命令查看8080端口（OpenClaw默认HTTP端口）是否被占用：
【Linux/macOS】：netstat -tulpn | grep :8080 或 lsof -i :8080
【Windows】：netstat -ano | findstr :8080
若返回结果中出现PID（进程ID）和对应程序名（如node.exe、python.exe、java.exe等），说明该端口确已被占。注意：Windows下需用管理员权限运行命令才可能看到全部进程。
终止占用端口的进程
方法一：根据上一步查到的PID，直接强制结束进程
【Linux/macOS】：sudo kill -9 PID
【Windows】：taskkill /PID PID /F
本次更新实现飞书插件 npm 独立分发，新增 Ollama 本地模型配置及 openclaw 命令别名。引入 SQLite 持久化队列，支持断点续传。全面集成飞书、钉钉、企业微信及 QQ 官方渠道，优化阿里云百炼模型选择。修复多 Agent 路由、定时任务校验及配对授权等关键问题，提升系统稳定性与兼容性。
方法二：若不确定PID归属或想一次性清理所有监听8080的进程（谨慎使用）
Linux/macOS执行：sudo lsof -ti:8080 | xargs kill -9；Windows不推荐类似批量操作，容易误杀系统服务。
【关键前提】：确保被终止的进程不是数据库、代理服务或开发服务器等关键后台程序，否则可能导致其他应用异常。
修改OpenClaw监听端口
第一步：定位OpenClaw配置文件。通常在安装目录下的 config.yaml 或 settings.json 中（具体路径参考官方文档或启动日志中的“Loading config from…”提示）
第二步：用文本编辑器打开该文件，查找 port、http_port 或 server.port 字段
第三步：将原值（如 8080）改为未被占用的端口，例如 8081、3000 或 8888；建议避开1024以下特权端口（需root/admin权限）
第四步：保存文件，重启OpenClaw服务。验证新端口是否生效：浏览器访问 http://localhost:8081（以你设置的新端口为准）
