已读回执
通过设置 native.readPolicy 可精确控制会话被标记为已读的时机:
readPolicy 策略 | 触发已读的时机 |
|---|---|
on_inbound (默认) | 当 OpenClaw 完成该消息的处理之后:即消息顺利通过权限检查且智能体完成了回复,或由内置指令完成了应答 |
never | 绝不标记已读。手机端将始终保持红点未读状态。 |
on_model_dispatch | 仅在 OpenClaw 为该消息启动模型运行后标记已读。比 on_inbound 更严格(见下文)。 |
标记已读会覆盖 整个会话(直至最新的一条消息)。同时会通知微信服务端,以便你的手机和其他登录设备同步消除红点未读徽标。
"native": { "readPolicy": "on_inbound"}严格模式
on_model_dispatch 会一直等待,直到 OpenClaw 报告已为包含该消息的请求准备好模型运行。内置命令、被忽略的消息以及尚未就绪的媒体保持未读状态,通道状态中会显示 handoffUnconfirmed。
| OpenClaw 版本 | 消息确认依据 | 是否需要 allowConversationAccess |
|---|---|---|
| 2026.11.2 及更新版本 | 该消息的 OpenClaw 运行启动通知 | 否 |
| 较早版本 | 包含确切图片字节校验的模型请求本身 | 是 |
在较早版本上,按如下方式配置权限:
"plugins": { "entries": { "agent-wechat": { "hooks": { "allowConversationAccess": true } } }}对于常规聊天机器人,推荐使用 on_inbound。