aionclaw不使用系统级通知权限,消息推送依赖绑定的通讯渠道(如飞书、qq、telegram)自身权限;需显式指定delivery.channel、payload.kind为"agentturn"、deliver:true,并严格校验to格式与时区。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

直接说结论:Aionclaw 本身不走系统级通知权限(如 macOS 的“通知中心”或 Windows 的“系统弹窗授权”),它的消息推送依赖你绑定的通讯渠道(比如飞书、QQ、Telegram)自身的权限体系,而不是客户端本地弹窗权限。很多人卡在“收不到提醒”,其实是没配对 delivery.channel 或没开对应平台的主动推送权。
确认你用的是哪个推送通道
Aionclaw 的定时任务或自动化流程发消息,必须显式指定 delivery.channel,比如 "feishu"、"qqbot"、"telegram"。它不会自动调用操作系统通知栏——这点和浏览器插件或传统桌面软件完全不同。
- 如果你设了
channel: "feishu",那权限检查点就在飞书机器人后台:是否开启「发送消息」权限?是否已加入目标群/已与用户发生过交互? - 如果用了
channel: "qqbot",QQ 侧必须在开放平台申请「主动消息」权限,否则只支持 1 小时内被动回复 -
telegram相对宽松,只要用户主动私聊过你的 bot,就能随时推送,无需额外审批
payload.kind 必须是 agentTurn,不是 systemEvent
这是最常踩的坑。很多用户复制旧配置,把 payload.kind 写成 "systemEvent",结果消息只在 Aionclaw 自己的对话窗口里“显示一行字”,根本不会推到飞书/微信/QQ 等外部渠道。
- 正确写法:
{"kind":"agentTurn","message":"会议提醒","deliver":true} -
deliver: true是开关,缺了它,哪怕其他都对,也等于没按发送键 -
agentTurn触发完整会话流程,才会走 delivery 配置;systemEvent只用于内部日志或调试标记
时区和时间格式必须显式声明
Aionclaw 默认按 UTC 解析时间,国内用户不加 --tz "Asia/Shanghai",所有定时任务都会晚 8 小时执行——你以为设了早上 9 点,实际是凌晨 1 点推送。
- 一次性任务示例:
--at "2026-09-22T09:00:00+08:00"(带时区偏移) - 周期任务必须配
--cron "0 0 9 * * *"+--tz "Asia/Shanghai"(注意 cron 是秒级格式,6 位) - 别信“本地系统时区会自动同步”——Aionclaw 启动时读取的是环境变量,不是 GUI 系统设置
测试推送前先验证 delivery.to 格式
to 字段格式错误会导致静默失败,连错误日志都不抛。不同平台要求严格:
- 飞书单人:
"user:ou_xxxxxx"(从飞书开发者后台「用户 ID」页复制,不是手机号或邮箱) - 飞书群聊:
"chat:oc_xxxxxx"(不是群名,也不是 chat_id,必须是 oc_ 开头的 ID) - QQ 私聊:
"user:123456789"(纯数字 QQ 号);群聊:"group:987654321" - Telegram:
"user:123456789"或"chat:-1001234567890"(群 ID 带负号)
最容易忽略的是:这些 ID 全部区分大小写,且不能有多余空格或引号嵌套。复制后建议粘贴到 JSON 校验器里过一遍。











