OpenClaw启动失败报“Address already in use”或网关无响应，大概率是端口被其他进程占用，需通过日志定位具体端口和冲突来源：先用openclaw logs --follow实时查看CLI日志，识别EADDRINUSE类错误及绑定端口；若日志刷屏或中断，则查本地logs/error.log（或gateway.log）中含时间戳的ERROR记录，提取如127.0.0.1:3000等地址信息；云环境可通过控制台日志中心搜索EADDRINUSE或"listen" AND "EADDRINUSE"，并核对网络配置与VPC内端口占用情况。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw启动失败报“Address already in use”或网关无响应，大概率是端口被其他进程占用了，必须先看日志才能确认冲突来源和具体端口号。
用 CLI 实时查看 Application 日志定位端口问题
这一步操作起来很简单，直接在终端运行命令就能看到最新错误，不需要找文件路径。
执行：openclaw logs --follow
如果日志里出现类似 EADDRINUSE、listen EADDRINUSE 或 port XXXX is already in use 的报错行，说明端口冲突已发生——【此时不要按 Ctrl+C 退出，继续往下看】
观察报错前后的日志上下文：它会明确写出 OpenClaw 尝试绑定的端口（如 3000、8080），以及触发该错误的模块（通常是 gateway 或 http-server）。
查 error.log 文件确认端口占用细节
当 CLI 日志刷屏太快或已中断，就需打开本地 error.log 查原始记录。
第一步：进入项目根目录下的 logs/ 子目录
为 Arch 多智能体系统创建新的 OpenClaw 智能体。当请求创建、添加或设置新智能体，或操作 ~/.openclaw/ 下的系统时使用。涵盖完整生命周期：目录创建、工作区文件（SOUL.md、IDENTITY.md 等）、openclaw. 配置、Telegram 路由（绑定、群组及提及模式）、含提示词工程的定时任务创建及网关重启。亦适用于修改现有智能体配置、添加定时任务或调试路由问题。
第二步：用文本工具打开 error.log，搜索关键词 EADDRINUSE 或 bind
第三步：找到最近一条含时间戳的 ERROR 记录，重点看 message 字段末尾——它通常附带完整地址字符串，例如 127.0.0.1:3000，这就是被占的端口和监听地址。
注意：如果 error.log 为空或没有新内容，说明错误未达到 ERROR 级别，可能只记在 gateway.log 里，需同步检查该文件。
云部署环境下从日志中心提取端口冲突线索
方法一：登录云平台控制台 → 进入「OpenClaw 实例」→ 点击「监控与日志」→ 切换到「运行日志」标签页 → 在搜索框输入 EADDRINUSE
方法二：使用关键词组合过滤，例如输入 "listen" AND "EADDRINUSE"，避免误匹配正常日志中的单词 listen
方法三：若日志中只显示端口但没写明进程名，复制报错中的端口号（如 :8080），回到实例详情页查看「网络配置」→ 核对「监听端口」是否与配置冲突，再检查同VPC下是否有其他服务绑定了相同端口
