openclaw端口冲突会导致服务无法启动或远程连接失败，常见于默认端口被iis、apache、wsl ssh、windows openssh等占用；需先用netstat和tasklist定位占用进程，再通过修改config.yaml中server→port字段（如改为8091）并重启服务解决，或调整冲突服务端口。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw端口冲突会导致服务无法启动或远程连接失败，常见于默认端口被IIS、Apache、WSL SSH、Windows OpenSSH等占用时。必须明确端口归属并重新分配，不能强行终止其他关键服务。
确认当前端口占用进程
以管理员身份运行 PowerShell，执行：
netstat -ano | findstr :8080（将8080替换为OpenClaw实际使用的端口）
若返回结果中 PID 列有数字，记下该 PID；再执行：
tasklist /fi "pid eq 【PID数字】" /fo list | findstr "Image Name"
这一步能准确定位是哪个程序占用了端口。如果返回“INFO: No tasks are running which match the specified criteria”，说明该端口当前空闲——此时问题不在端口冲突，需排查配置文件或服务状态。
修改OpenClaw监听端口
打开 OpenClaw 安装目录下的 config.yaml 或 application.yml（具体取决于版本），找到 server → port 或 http → port 字段。
本次更新实现飞书插件 npm 独立分发，新增 Ollama 本地模型配置及 openclaw 命令别名。引入 SQLite 持久化队列，支持断点续传。全面集成飞书、钉钉、企业微信及 QQ 官方渠道，优化阿里云百炼模型选择。修复多 Agent 路由、定时任务校验及配对授权等关键问题，提升系统稳定性与兼容性。
将原值（如 8080）改为一个未被占用的高位端口，例如 8091、9005 或 10241～65535 范围内任一空闲端口。
【必须重启OpenClaw服务才能使新端口生效】，仅改配置不重启无效。Windows 下常用命令：
net stop OpenClaw → net start OpenClaw；Linux 下用 systemctl restart openclaw。
让其他服务让出端口（备选方案）
方法一：停用非必要服务
若占用端口的是 IIS Express、Apache Test Server 等开发测试服务，可直接在任务管理器中结束对应进程，或执行：
taskkill /f /pid 【PID数字】
方法二：迁移 Windows OpenSSH 默认端口
若冲突来自 Windows 自带的 OpenSSH 服务（监听 22 端口），不要停它——而是修改其配置：
编辑 C:\ProgramData\ssh\sshd_config，取消注释 Port 行，改为 Port 2222；然后管理员运行：
Restart-Service sshd
方法三：调整 WSL SSH 端口转发规则
若 WSL 中的 SSH 正在监听 2222 并已映射到 Windows 的 2222，而 OpenClaw 也想用 2222，则需修改 WSL 的 sshd_config 中 Port 为 2223，并同步更新 Windows 端口转发命令中的 connectport=2223。
