AionClaw故障定位需三步隔离验证：第一步查客户端状态栏与进程存活；第二步用openclaw skill run --name="test-ping" --dry-run校验技能注册、权限、路径；第三步分模型调用（TaoToken测试页）与本地执行（离线模式+日志过滤）锁定异常模块。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在 AionClaw 中执行某项操作（比如点击“生成周报”按钮没反应、定时任务不触发、飞书消息收不到回复），无法判断是软件界面卡死、网络通道断开等客户端层面故障，还是技能本身缺失依赖、权限不足、路径写错等运行环境问题时，必须用可验证的隔离动作快速定位。不能靠重启或重装蒙对，要让每一步输出都指向明确责任层。
第一步：确认客户端是否处于可响应状态
打开 AionClaw 主界面，观察左下角状态栏——如果显示【安全保护中】且右侧有实时更新的 CPU/内存占用百分比（如“CPU 12%｜内存 842MB”），说明客户端进程正常存活；若状态栏空白、图标灰显、点击无任何反馈，或任务管理器中 openclaw.exe / AionClaw 进程 CPU 占用长期为 0%，则问题在客户端启动或守护进程层面，无需往下排查技能。
此时直接执行：killall -9 AionClaw（macOS/Linux）或在任务管理器结束所有 openclaw 相关进程 → 重新双击桌面图标启动。若仍无状态栏，说明安装损坏或系统权限未授予，需重装并勾选“允许后台运行”和“全盘访问”权限。
第二步：用内置诊断命令直连技能执行链路
打开终端（Windows 用 PowerShell，macOS/Linux 用 Terminal），输入：
openclaw skill run --name="test-ping" --dry-run
这条命令不真正执行逻辑，只校验技能注册表、依赖加载、沙盒路径解析三环节。如果返回 "skill test-ping not found"，说明技能未正确安装或名称拼写错误；若返回 "permission denied: /Users/Alice/.aionclaw/skills/test-ping"，则是系统级权限阻断，与客户端无关；若返回 "success: dry-run passed"，但你在界面上点同一技能却失败，那一定是客户端 UI 层未正确触发调用，而非技能环境问题。
注意：--dry-run 参数不可省略，漏掉会真实执行技能，可能误删文件或发错消息。
第三步：分离模型调用与本地操作，锁定异常模块
方法一：禁用模型，纯本地验证
在设置 → 模型服务中，将当前模型切换为“离线模式（仅本地工具）”，然后运行一个只读取本地 Excel 并打印行数的技能（如内置的 csv-stat）。如果成功输出行数，说明技能环境、文件路径、权限全部正常，问题出在模型 API 调用链（如 TaoToken Key 过期、Base URL 错误）；如果仍报“文件不存在”，立刻回到第二步检查配置中的绝对路径是否真实存在。
方法二：绕过技能，直连模型接口
打开浏览器，访问：https://taotoken.net/console/test → 粘贴你的 API Key → 输入任意 prompt（如“hi”）→ 点击 Send。若返回 JSON 格式响应且 content 字段有文本，证明模型层通畅；若返回 401 或超时，则问题在 TaoToken 配置或网络代理，与技能代码完全无关。
方法三：查看技能日志原始输出
在终端中执行：openclaw log --tail --filter=skill，然后在 UI 中触发一次失败技能。观察日志里最先出现的 ERROR 行：如果是 "exec: \"pandoc\": executable file not found in $PATH"，属于技能依赖缺失；如果是 "http: server closed idle connection"，属于客户端与技能进程间通信中断；如果是 "open /tmp/report.xlsx: no such file or directory"，说明技能内部硬编码了错误路径，需进 skill 目录改源码。
