AionClaw任务静默阻塞时，需依次排查：1.确认Gateway服务运行且绑定模式为lan；2.验证TaoToken通道的Base URL、API Key、Model ID连通性；3.通过日志、curl直调、禁用技能链定位卡点；4.清空任务队列缓存并重启服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在 AionClaw 中提交一个任务（比如生成周报、跑定时脚本、调用浏览器自动化），界面长时间卡在“思考中”或完全无日志输出，既不报错也不返回结果，说明任务已进入静默阻塞状态。这不是网络延迟问题，而是底层执行链某个环节被卡死或未触发。
第一步：确认 Gateway 服务是否真正运行
所有 AionClaw 任务都必须经过本地 Gateway 转发到模型服务，Gateway 不活，任务就根本发不出去。打开终端执行：openclaw gateway status。如果返回 inactive 或提示 Unit openclaw-gateway.service could not be found，说明服务没装好或被意外停掉。
这时不要直接重装，先尝试启动：openclaw gateway start。若提示 Failed to start openclaw-gateway.service: Unit openclaw-gateway.service not found，说明 systemd 单元未注册，需运行 openclaw gateway install 补全系统服务定义。
【关键前提】 Gateway 启动依赖端口 18789 空闲且绑定模式为 lan，否则即使显示“active”，外部请求仍无法抵达。执行 openclaw configget gateway.bind，结果必须是 "lan"；若为 "loopback"，立刻执行 openclaw configset gateway.bind "lan" 并重启服务。
第二步：检查模型通道是否连通
Gateway 活着 ≠ 模型能调用。AionClaw 默认使用 TaoToken 统一通道，但配置错误会导致请求发出后石沉大海。打开终端运行：openclaw doctor --model，它会自动探测 Base URL、API Key、Model ID 三者是否可连通。
若输出中出现 HTTP 401 Unauthorized，说明 API Key 无效或权限不足——【注意】 TaoToken 的 Key 有作用域限制，必须勾选 “AionClaw” 和对应 Model 的调用权限，仅复制 sk- 开头字符串不够。
若输出卡在 Testing model endpoint... 超过 15 秒无响应，大概率是 Base URL 填错。正确地址只有且仅有一个：https://taotoken.net/api。多一个斜杠、少一个字符、混入空格，都会导致 TLS 握手失败而静默超时。
第三步：定位具体任务卡在哪一环
方法一：查看实时任务日志
在终端中执行：journalctl --user -u openclaw-gateway -f（Linux）或 tail -f ~/Library/Logs/openclaw-gateway.log（macOS）。提交一个新任务，观察日志流中是否出现 Received task request → Forwarding to model → Response received 完整链条。如果只看到前两步就中断，说明模型返回异常或解析失败；如果连第一步都没打印，说明请求压根没进 Gateway，可能是前端未触发或 WebSocket 连接断开。
方法二：绕过前端直发测试请求
用 curl 模拟一次最简调用：curl -X POST https://taotoken.net/api/chat/completions -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" -d '{"model":"qwen3","messages":[{"role":"user","content":"hi"}]}'。把 sk-xxx 替换为你实际的 Key。如果返回 JSON 正常，证明通道本身可用，问题出在 AionClaw 任务调度层；如果返回空或超时，说明是 TaoToken 层配置或网络问题。
方法三：禁用技能链快速验证
在 AionClaw 客户端中新建一个纯文本任务，内容只写 say hello，不勾选任何技能、不指定 Agent、不启用 RAG。如果这个极简任务能秒回，说明问题出在你原任务所依赖的某个插件或本地工具（比如浏览器未授权、Excel 文件被其他程序锁定、代码执行沙箱权限不足）。
第四步：强制清理阻塞任务队列
步骤一：停止 Gateway 服务openclaw gateway stop
步骤二：清空待处理任务缓存
执行 rm -rf ~/.openclaw/tasks/queue/*（Linux/macOS）或 del /q "%USERPROFILE%\.openclaw\tasks\queue\*"（Windows）。这一步会丢弃所有未完成任务，但能解除因任务元数据损坏导致的永久阻塞。
步骤三：重启服务并验证openclaw gateway start → 等待提示 Started openclaw-gateway.service → 立即提交一个新任务观察响应。
