openclaw-weixin 是 OpenClaw 的微信渠道插件，通过扫码登录把 OpenClaw Gateway 接入微信，实现消息收发。很多用户装好插件后，只把它当成"发消息的管道"，却忽略了内置的两个斜杠命令：/echo可以一键测量消息通道耗时，/toggle-debug能随时开关调试模式、让每条 AI 回复附上全链路耗时报告。本文带你把这两个命令用明白，快速定位"机器人回复为什么变慢了"。

两个命令是什么？

openclaw-weixin 内置了斜杠指令处理模块，支持的指令只有两个：

这两个命令都不消耗 AI 调用，在微信聊天窗口直接发送即可，不需要额外配置，且命令名不区分大小写（/ECHO、/Toggle-Debug都有效）。

命令的完整实现在 slash-commands.ts，入口处handleSlashCommand会先判断消息是否以/开头，再分发到具体处理器（slash-commands.ts#L67-L107）。

/echo：一次发送，测出消息通道耗时

发送方式

在微信里对机器人发送：

/echo 你好

插件会做两件事：先原样回复"你好"，再回复一条耗时统计，大致长这样：

⏱ 通道耗时 ├ 事件时间: 2026-10-22T02:00:01.123Z ├ 平台→插件: 86ms └ 插件处理: 3ms

• 事件时间：微信侧消息创建的时间戳（create_time_ms），没有时显示N/A。
• 平台→插件：从平台产生事件到插件收到消息的延迟，主要反映长轮询链路和平台侧开销。
• 插件处理：插件内部处理这条消息的耗时，通常只有几毫秒。

如果只想看耗时、不需要回显内容，直接发/echo即可，插件只回复统计信息（slash-commands.ts#L40-L60）。

什么时候该用 /echo？

• 觉得机器人整体响应变慢，想先确认瓶颈在平台侧还是本地；
• 部署新 Gateway 后做一次链路"体检"；
• 排查网络抖动时连续发几次/echo，对比"平台→插件"的波动。

如果命令执行失败（例如消息发送接口报错），插件会回复❌ 指令执行失败: <错误摘要>，同时把完整错误写入日志，方便你进一步排查（slash-commands.ts#L98-L106）。

/toggle-debug：一条命令开关调试模式

发送方式

在微信里对机器人发送：

/toggle-debug

插件按账号维度切换状态并回复确认：

• 首次发送：Debug 模式已开启
• 再次发送：Debug 模式已关闭

开启后会发生什么？

debug 模式开启后，每条经过 AI 的回复送达后，插件都会额外追加一条"全链路"报告，包含四个部分：

⏱ Debug 全链路 ── 收消息 ── │ seq=… msgId=… from=… │ body="你好" (len=2) itemTypes=[2] ── 鉴权 & 路由 ── │ auth: cmdAuthorized=true senderAllowed=true │ route: agent=… session=… ── 回复 ── │ textLen=42 media=none │ deliver耗时: …ms ── 耗时 ── ├ 平台→插件: 86ms ├ 入站处理(auth+route+media): 25ms (mediaDownload: 0ms) ├ AI生成+回复: 1240ms ├ 总耗时: 1351ms └ eventTime: 2026-10-22T02:00:01.123Z

可以看到：鉴权与路由花了多久、媒体下载花了多久、AI 生成+回复花了多久、总耗时多少。报告组装逻辑在 process-message.ts#L545-L574。

状态会持久化

debug 开关不是内存变量，而是按账号写入磁盘文件<stateDir>/openclaw-weixin/debug-mode.json，格式为{"accounts": {"<accountId>": true}}。这意味着：

• Gateway 重启后状态不丢失，不用担心"重启完忘了关"；
• 多账号场景下互不影响：A 账号开启，B 账号不受牵连。

相关实现见 debug-mode.ts，核心是toggleDebugMode与isDebugMode两个函数（debug-mode.ts#L42-L57）。

/echo 和 /toggle-debug 怎么选？

进阶：看看指令是怎么被识别的

在消息处理主流程 process-message.ts#L90-L110 中，插件先取出消息里第一个文本项：

• 以/开头 → 交给handleSlashCommand，命中/echo或/toggle-debug则处理后直接跳过 AI 管道；
• 未以/开头，或是不认识的命令（如/foo）→ 照常走 AI 流程，不会误拦消息。

也就是说，你平时发的普通消息完全不受影响，斜杠命令只是"截胡"了那两条特定指令。想深入阅读行为细节，可以查看配套测试 slash-commands.test.ts（覆盖大小写、空参数、发送失败等边界）和 debug-mode.test.ts。

小结

• /echo：秒级体检，两条消息看懂"平台→插件→处理"各段耗时；
• /toggle-debug：按账号持久化的调试开关，AI 回复自动附带全链路耗时报告；
• 两者都不消耗 AI 调用、无需改配置，装好插件即可在微信里直接使用。

机器人回复慢了，先用/echo定个基调，再用/toggle-debug看明细，基本就能锁定问题出在链路、鉴权还是模型生成环节。