openclaw需配置未被占用的固定端口(1024–65535)才能正常启动;须用ss命令检查端口空闲,修改config.yaml中server: port: 50022(大小写与缩进严格),重启服务后验证listen状态及/health响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw端口冲突时无法正常启动或连接设备,必须为其分配一个系统未占用的固定端口,否则服务会因绑定失败而退出。
确认目标端口是否空闲
先选一个1024–65535范围内的端口(如50022),用命令检查是否被占用:
【sudo ss -tuln | grep ':50022'】
无任何输出才表示可用;若有输出,说明该端口正被其他进程监听,必须换一个再试。别跳过这步——OpenClaw启动时若发现端口已被占,直接报错退出,不会自动降级或重试。
修改OpenClaw配置文件指定端口
打开OpenClaw主配置文件(路径通常为/etc/openclaw/config.yaml或~/.openclaw/config.yaml):
sudo nano /etc/openclaw/config.yaml
找到server:区块,在其下添加或修改port:字段:
本次更新实现飞书插件 npm 独立分发,新增 Ollama 本地模型配置及 openclaw 命令别名。引入 SQLite 持久化队列,支持断点续传。全面集成飞书、钉钉、企业微信及 QQ 官方渠道,优化阿里云百炼模型选择。修复多 Agent 路由、定时任务校验及配对授权等关键问题,提升系统稳定性与兼容性。
server:
port: 50022
注意:不要写成Port:或PORT:,YAML对大小写和缩进敏感;缩进必须用两个空格,不能用Tab。
重启OpenClaw服务并验证绑定
执行以下操作链:
sudo systemctl daemon-reload → sudo systemctl restart openclaw
等待3秒后立即验证:
sudo ss -tuln | grep ':50022'
若看到LISTEN状态且进程名为openclaw,说明端口已成功绑定。此时可尝试用curl或客户端连接http://localhost:50022/health确认服务响应。









