遇到aionclaw报错须先区分本地故障（安装包损坏/环境冲突）还是远程异常（网络不通/api失效）；第一步用openclaw status查进程是否启动；第二步用openclaw logs --tail 50看首条error定位根因；第三步用openclaw run --dry-run、--debug及手动curl逐层验证链路。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在启动或使用 AionClaw 时遇到报错，比如“无法连接服务”“初始化失败”“模型加载超时”“claw start 无响应”，必须立刻区分是安装包损坏/环境冲突导致的本地故障，还是网络不通、API 通道失效引发的远程异常——这两类问题的排查路径完全相反，混在一起查会浪费数小时。
第一步：看进程是否真正启动成功
打开终端，执行 openclaw status（Windows PowerShell 或 macOS/Linux Terminal）。如果返回 【command not found】 或提示“未找到命令”，说明 AionClaw 的二进制文件根本没注册进系统 PATH，属于安装失败的典型特征，直接跳到“安装错误”分支；如果返回类似 status: running, pid: 12345，但后续调用技能仍报错，则进入网络异常排查。
这一步操作起来很简单，直接敲命令就行，不需要打开图形界面。
第二步：检查日志里最靠前的 ERROR 行
运行 openclaw logs --tail 50，把最后 50 行日志贴出来看。重点盯第一行 ERROR：
- 如果是
failed to load config: open /xxx/openclaw.json: no such file or directory→ 配置文件缺失，安装未完成； - 如果是
failed to dial gateway: context deadline exceeded或connection refused→ 网络层连不上后端，属于网络异常； - 如果是
exec: "ollama": executable file not found in $PATH→ 依赖组件缺失，安装不完整。
注意：AionClaw 启动时会先尝试读配置、再拉模型、最后连网关。日志里最早出现的 ERROR 就是根因，别被后面一堆 warn 冲昏头。
第三步：用最小化命令绕过 GUI 验证核心链路
① 先验证本地运行能力：执行 openclaw run --dry-run "hello"。它不发请求、不联网，只做本地语法解析和流程编排。如果报错，说明安装损坏或环境变量污染（比如旧版 Node.js 冲突）。
② 再验证网络出口：执行 openclaw run --debug "ping taotoken.net"（需已配置 TaoToken Base URL）。若返回 timeout 或 dns lookup failed，说明 DNS 或代理未生效；若返回 200 OK 但后续模型调用失败，问题出在 Key 权限或模型 ID 错误。
③ 最后交叉验证：把上一步中 openclaw run --debug 输出的完整 curl 命令复制出来，在终端单独执行。如果 curl 成功但 openclaw 失败，基本可锁定为 AionClaw 进程自身的 HTTP 客户端配置异常（如证书校验失败、HTTP/2 不兼容）。
