需依次排查gateway进程存活、模型endpoint与api key有效性、会话上下文缓存阻塞三方面问题：先用ps aux检查gateway进程是否存在，再验证base url和api key是否正确且权限匹配，最后通过dashboard重置超长上下文以恢复响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你已经成功完成 AionClaw 与飞书/微信/Telegram 等聊天工具的配对连接，界面显示“已在线”“会话已建立”，但用户发消息后智能体始终无响应，日志里既没有模型调用记录，也没有错误堆栈，这种“静默失联”是本地智能体部署中最隐蔽也最常被误判的问题。
确认 Gateway 进程是否真实存活
连接成功 ≠ Gateway 正在工作。AionClaw 的通信链路由两段组成：聊天平台 → AionClaw 客户端（含内置 Gateway）→ 大模型服务。第一段连上了，第二段可能早已中断。【Gateway 进程崩溃后 UI 不会自动报错，状态栏仍显示绿色在线】
打开终端，执行：ps aux | grep gateway → 查看输出中是否存在 openclaw-gateway 或 aionclaw-server 进程；若无，说明 Gateway 已退出，需手动重启客户端或运行 aionclaw --restart-gateway。
这一步操作起来很简单，直接把文件拖进去就行。
检查模型 endpoint 和 API Key 是否生效
Gateway 存活，但模型请求发不出去，表现就是“收得到消息，回不了内容”。AionClaw 默认不会校验模型配置是否可用，直到第一次调用才暴露问题。
方法一：打开 AionClaw 设置 →「模型服务」→ 确认 Base URL 填写的是 https://taotoken.net/api（注意结尾无斜杠、不带 utm 参数），API Key 是 TaoToken 控制台生成的、状态为 Active 的密钥。
方法二：在终端中手动触发一次模型探测：curl -X POST https://taotoken.net/api/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model":"glm-4","messages":[{"role":"user","content":"hi"}]}' → 若返回 401 或 403，说明 Key 无效或过期；若返回 429，说明余额耗尽；只有返回 200 才代表通道通了。
【不要复用其他项目的 Key，TaoToken 的 Key 权限按项目隔离，aionclaw-local-prod 和 aionclaw-test 必须分开创建】
验证会话上下文是否触发了缓存阻塞
第一步：打开 AionClaw Dashboard → 进入「智能体管理」→ 选中出问题的助手（如“小猿潘”）→ 点击「会话详情」。
第二步：查看最近 3 次会话的「Input Token 数」和「Cache Read/Write」标记。若 Input Token 持续超过 28000，且 Cache Write 频繁出现但 Cache Read 为 0，说明上下文已超出 GLM 等主流模型单次处理上限，Gateway 主动丢弃请求，不发往模型，也不报错。
第三步：点击该会话右侧的「重置上下文」按钮 → 系统将清除当前会话全部历史缓存并重建轻量会话。此操作不可逆，但能立即恢复基础回复能力。
这一步做完后，用飞书向该助手发送“你好”，观察是否收到“收到”类基础应答。
