端口冲突表现为econnrefused、超时或网关启动失败，根本原因是openclaw网关（默认18789）或模型服务（如ollama默认11434）被占用或防火墙拦截；解决需查占用进程、改配置端口、开放防火墙规则。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw本地模型端口冲突表现为调用API时返回ECONNREFUSED、连接超时或网关启动失败，根本原因是OpenClaw网关（默认18789）或后端模型服务（如Ollama默认11434）被其他进程占用，或防火墙策略主动拦截通信路径。
查清谁占了模型服务端口
第一步：确认Ollama等模型服务是否真在监听11434端口。执行netstat -tuln | grep 11434（Linux/macOS）或netstat -ano | findstr :11434（Windows），有输出即表示该端口已被占用。
第二步：若发现PID，用lsof -i :11434（macOS/Linux）或tasklist /FI "PID eq [PID]"（Windows）查进程名。常见抢占者包括残留的Ollama服务、VS Code插件后台进程、甚至Chrome DevTools调试器。
第三步：强制释放端口。Linux/macOS执行kill -9 [PID]；Windows执行taskkill /F /PID [PID]。注意：【不要直接kill掉systemd或launchd主进程，否则可能引发系统级异常】。
改OpenClaw网关端口（永久生效）
方法一：修改配置文件
打开~/.openclaw/config.yaml（Windows为%USERPROFILE%\.openclaw\config.yaml），定位到gateway:区块下的port:字段，把18789改成30089、42100等未被占用的端口——务必确保数值在1024–65535之间且不与常用服务冲突（如3306 MySQL、6379 Redis）。
保存后执行openclaw restart，新端口立即生效。这一步必须做，否则下次重启OpenClaw仍会尝试绑定18789。
临时绕过端口冲突（调试专用）
方法一：命令行覆盖端口参数
本次更新实现飞书插件 npm 独立分发，新增 Ollama 本地模型配置及 openclaw 命令别名。引入 SQLite 持久化队列，支持断点续传。全面集成飞书、钉钉、企业微信及 QQ 官方渠道，优化阿里云百炼模型选择。修复多 Agent 路由、定时任务校验及配对授权等关键问题，提升系统稳定性与兼容性。
先停掉当前服务：openclaw stop。
再用指定端口启动网关：openclaw gateway --port 28089 --mode local。这会跳过config.yaml读取，直接绑定28089，适合快速验证模型连通性。
访问地址同步变为http://127.0.0.1:28089，前端或API客户端需同步更新baseUrl。
方法二：让Ollama换端口（治本）
Ollama本身支持自定义端口。编辑~/.ollama/config.json，添加"host": "127.0.0.1:11435"字段，然后重启Ollama：systemctl --user restart ollama（Linux）或重新运行ollama serve（macOS/Windows）。之后OpenClaw配置里的baseUrl也要同步改为http://127.0.0.1:11435。
开放系统防火墙入站规则
步骤一：Windows系统需手动放行新端口。打开“高级安全Windows Defender防火墙”→“入站规则”→“新建规则”→选择“端口”→TCP→特定本地端口（填你改后的网关端口，如30089）→允许连接→按向导完成。
步骤二：Linux用户执行sudo ufw allow 30089（Ubuntu）或sudo firewall-cmd --add-port=30089/tcp --permanent && sudo firewall-cmd --reload（CentOS/RHEL）。
步骤三：云服务器部署时，必须额外配置安全组——在阿里云/腾讯云控制台中，将新端口加入入方向规则，协议选TCP，源IP可设为0.0.0.0/0（生产环境建议限制为可信IP段）。
