使用手册 · 系统
通知
多通道通知系统，提供实时告警、审批提醒和运营事件推送。
/notifications概述#
ClawButler 通过四个通道发送通知：应用内（Server-Sent Events）、邮件（SMTP）、Web 推送（VAPID）和移动端推送（Expo / APNs / FCM）。你会及时收到待审批、Agent 健康变化、预算超额和自动化结果的告警。
每个用户可以按通道配置通知偏好，设置免打扰时段以在非工作时间抑制非关键告警，并调整冷却间隔以防止通知疲劳。
前置条件#
前置条件
- 一个 ClawButler 账户（应用内通知开箱即用）
- 可选：配置邮箱以接收邮件通知，或授予浏览器/移动端推送权限
使用反馈#
配置完成后，你将看到：
- -通知收件箱，侧边栏和顶部栏显示未读计数徽章
- -每条通知详情，包含事件类型、时间戳、关联的 Agent 或资源，以及指向来源的链接
- -偏好设置面板，可切换通道、设置免打扰时段和配置冷却间隔
Web 端操作#
从侧边栏「系统」分组导航到通知页面，或点击顶部栏的铃铛图标。
通知收件箱
收件箱按时间倒序列出所有通知。每条记录显示事件类型徽章、摘要消息、时间戳和关联资源的链接。未读通知以圆点指示器高亮显示。
标记已读
点击通知将其标记为已读，或使用顶部的「全部标记已读」按钮一次性清除所有未读指示器。已读状态跨设备同步。
偏好设置
打开偏好设置面板，切换通知通道（应用内、邮件、Web 推送）并选择哪些事件类型触发通知。每个通道可以独立启用或禁用。
免打扰时段
设置每日免打扰时段（如 22:00 - 08:00），期间非关键通知将被暂存，在时段结束时作为批量摘要发送。关键告警（紧急停机、预算突破）始终立即送达。
CLI 端操作#
列出最近的通知，可选仅显示未读
Terminal
$ ap notification list移动端操作#
在移动端，通知屏幕可从底部导航访问。功能包括：
- -通过 Expo / APNs / FCM 推送通知——点击可直接导航到关联资源
- -应用图标上的角标显示未读通知数量
- -下拉刷新和标记已读手势，实现快速收件箱管理
常见问题#
问：如何启用推送通知？
答：在 Web 端，点击偏好设置面板中的「启用推送」——浏览器会提示通知权限。在移动端，应用请求时授予通知权限即可。推送通知需要有效的 VAPID 配置（Web）或 Expo 推送令牌（移动端）。
问：哪些事件会触发通知？
答：默认情况下，待审批、Agent 健康状态变化（健康转为错误）、预算超额警告、紧急停机激活和自动化失败会触发通知。你可以在偏好设置面板中自定义哪些事件类型触发通知。
问：如何设置免打扰时段？
答：前往通知 > 偏好设置 > 免打扰时段。设置开始和结束时间（使用你的本地时区）。在免打扰时段内，非关键通知会排队等待，并在时段结束时作为摘要发送。关键告警始终绕过免打扰时段。