通过微信与 AI Agent 对话的常见问题与解决方法
现象：发消息后报错 Something went wrong while processing your request. Please try again or type /new to start a fresh session.
原因：Agent 上下文超过 200k token 上限。常见触发：发图、发文件、长对话。图片和文件占大量 token，容易撑爆会话。微信或 OpenClaw 对某些格式不兼容也可能引发。
解决：输入 /new 或 /reset 开启新会话。如果不管用，等 30 秒再试。
预防：图片一次发一张；对话长了自己主动 /new。
现象：发了消息 Agent 半天没反应
原因：
解决：等 30~60 秒。超过 2 分钟发「芝麻开门」或「盖亚start」。报 API rate limit 就等一会儿再试。
现象：明明刚说过，Agent 像失忆了
原因：上下文超限后自动丢弃旧消息；或刚执行过 /new；或模型切换了
解决：重复关键信息。重要内容让 Agent「记到记忆里」。先确认没切过会话。
原因：纯文本模型不支持看图；微信对某些图片格式不兼容；图片太大
解决：直接描述图片内容。找支持视觉模型的 Agent。推荐 PNG/JPG，避免 GIF/HEIC。微信直接发图报错就截图再发。
Agent 可以给你发文件：图片、HTML、Word、Excel、PDF 等都可以。如果 Agent 说「我没有发送能力」→ 告诉它去学习相关课程。
你发文件给 Agent：如果 Agent 读不了，可能是因为微信转码了。把关键内容复制粘贴发文字，或上传到 Hub 给链接。
微信最新版本支持直接发语音给 Agent，但部分版本可能不行。
推荐：点击输入法的语音按钮，语音自动转文字发送，效率很高。
原因：微信或 OpenClaw 版本更新期间可能有短时兼容问题。
解决：耐心等待，两边都会修复。必要时联系管理员了解维护进度。
先看微信界面：顶部 Agent 名字下显示 「BOT，暂时无法连接」 → 是正常冷却，不是故障。
为什么冷却：Agent 30 分钟无活跃自动冷却，节省 token。有任务进行中或定时巡检则不会冷却。
唤醒流程：
原因：Agent Token 权限不够，或功能需付费/特定角色。
解决：联系管理员申请权限，或找有该功能的 Agent。
原因：回复被过滤（敏感词/太长）；推送限速；Agent 崩了。
解决：等 2~3 分钟，发一条简短消息重新触发。频繁出现请找管理员查日志。
| 指令 | 作用 |
|---|---|
| /new 或 /reset | 开启新会话（推荐优先试） |
| /status | 查看当前状态 |
| 芝麻开门 / 盖亚start | 唤醒休眠冷却中的 Agent |
| 直接发消息 | 也能自动唤醒，需等 30~60 秒 |
| 帮我查一下你的能力 | 查看 Agent 支持哪些功能 |
| 记下来 / 记住 | 让 Agent 存入记忆 |