AionClaw网关启动失败需排查服务状态、配置绑定、认证凭证三方面：先用openclaw gateway status确认进程运行，再检查config.yaml中bind_address是否为0.0.0.0，接着校验gateway-token一致性或重置，macOS用户还需修复LaunchAgent权限并重新加载服务，最后curl验证端口响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
刚安装完AionClaw双击启动，界面弹出“连接失败”或“Gateway: 未检测到”，浏览器打不开 http://127.0.0.1:18789，说明网关进程根本没起来，不是网络问题也不是浏览器问题，必须从服务状态、配置绑定、认证凭证三处硬性条件入手排查。
确认网关进程是否真实运行
别信桌面图标点击后的“正在启动”动画——它可能只是UI假响应。打开终端，执行：
openclaw gateway status
若返回 offline、no such command 或直接报错，证明服务未注册或进程已僵死。立即强制终止残留：
macOS/Linux：ps aux | grep openclaw-gateway | awk '{print $2}' | xargs kill -9
Windows：任务管理器 → 搜索 openclaw-gateway → 全部结束任务
【不清理残留进程直接重试，90%概率复现连接失败】
检查并修正 config.yaml 中的监听地址
打开配置文件 ~/.openclaw/config.yaml，定位到 gateway 区块。
确认存在 bind_address 字段，且值为 0.0.0.0；若为 127.0.0.1 或字段缺失，手动添加或修改为：
bind_address: 0.0.0.0
注意缩进必须与同级字段（如 port、auth）对齐，多一个空格或少一个空格都会导致配置加载失败，服务静默退出。
验证 gateway-token 是否有效且已注入
方法一：用命令快速生成带 token 的仪表盘链接
在终端执行 clawdbot dashboard，浏览器将自动打开含完整 token 的 URL（形如 http://127.0.0.1:18789/?token=abc123...），该链接可直接访问。
方法二：手动校验 token 一致性
打开 ~/.openclaw/openclaw.json，比对 gateway.auth.token 与 gateway.remote.token 两个字段值是否完全一致；不一致会导致认证链路中断，网关拒绝启动。
方法三：重置 token 并重启服务
执行 openclaw gateway reset-token → openclaw restart，强制刷新凭证并重载配置。
macOS 用户必须修复 LaunchAgent 权限
Apple Silicon 设备（M1/M2/M3/M5）重装后，~/.openclaw、~/Library/LaunchAgents 等目录常被 root 占用，导致 launchd 拒绝加载 gateway.plist。
第一步：修复归属权限
sudo chown -R $(whoami):staff ~/.openclaw
sudo chown -R $(whoami):staff ~/Library/LaunchAgents
第二步：卸载并重载服务配置
launchctl bootout gui/$UID ~/Library/LaunchAgents/ai.openclaw.gateway.plist
launchctl bootstrap gui/$UID ~/Library/LaunchAgents/ai.openclaw.gateway.plist
第三步：验证服务状态
openclaw gateway status —— 必须返回 active(running) 才算真正就绪。
最后一步：curl 验证端口可达性
在终端执行：
curl -v http://localhost:18789/health
看到 HTTP/1.1 200 OK 且 body 含 {"status":"ok"}，说明网关已监听并响应；若超时、Connection refused 或返回 404，说明前四步中某处未生效，需回溯检查。
