读取 macOS 通知中心,导出到 memory/computer_io/notification/ 目录。让 OpenClaw 了解你的工作动态。
---
name: macos-notification-reader
description: "读取 macOS 通知中心,导出到 memory/computer_io/notification/ 目录。让 OpenClaw 了解你的工作动态。"
---
# macOS Notification Reader
> 让 OpenClaw 读取你的 macOS 通知,自动生成每日工作摘要
> Read your macOS notifications and generate daily work summaries for OpenClaw
**这是一个为 OpenClaw 打造的技能(Skill),可以读取 macOS 通知中心的内容,帮助 AI 助手更好地了解你的工作动态。**
---
## 🎯 这是什么? / What is this?
这个工具会把你的 macOS 通知导出到 OpenClaw 的 memory 目录,让 OpenClaw 能够:
- 📬 知道谁在找你(Teams、Outlook、WeChat...)
- 📅 了解你的日程提醒
- ✅ 提取待办事项(会议、审批、deadline...)
- 🧠 记住你最近在忙什么
---
## 📁 输出文件结构 / Output File Structure
```
memory/YYYY-MM-DD/
└── computer_io/
└── notification/
├── YYYYMMDD-HHMMSS.md # 原始通知导出
└── work-summary-YYYYMMDD-HHMMSS.md # 工作摘要(推荐)
```
---
## 🚀 安装 / Installation
### 前置要求
- macOS 系统
- Python 3.8+ (`python3 --version` 检查)
- OpenClaw 已安装并运行
### 步骤 1:放入 OpenClaw Skills 目录
```bash
# 克隆项目
git clone https://github.com/gift-is-coding/macos-notification-reader.git
# 复制到 OpenClaw skills 目录
cp -r macos-notification-reader ~/.openclaw/workspace/skills/
# 给脚本执行权限
chmod +x ~/.openclaw/workspace/skills/macos-notification-reader/scripts/*.sh
```
### 步骤 2:首次运行授权
```bash
~/.openclaw/workspace/skills/macos-notification-reader/scripts/export-notification.sh
```
首次运行时,macOS 会弹窗请求「通知访问权限」,点击**允许**。
---
## ⚙️ 配置定时任务 / Configure Cron Job
### 方法一:通过 OpenClaw 配置(推荐)
编辑 `~/.openclaw/cron/jobs.json`,添加:
```json
{
"name": "Notification Reader",
"schedule": "*/30 * * * *",
"command": "~/.openclaw/workspace/skills/macos-notification-reader/scripts/export-notification.sh",
"timezone": "Asia/Shanghai"
}
```
这会让 OpenClaw **每 30 分钟**自动抓取一次通知。
### 方法二:手动添加 crontab
```bash
crontab -e
```
添加:
```cron
*/30 * * * * ~/.openclaw/workspace/skills/macos-notification-reader/scripts/export-notification.sh >> ~/.openclaw/logs/notification.log 2>&1
```
---
## 💼 使用方式 / Usage
### 导出所有通知
```bash
~/.openclaw/workspace/skills/macos-notification-reader/scripts/export-notification.sh
```
### 工作摘要模式(推荐)
只提取工作相关通知(Teams/Outlook/WeChat):
```bash
~/.openclaw/workspace/skills/macos-notification-reader/scripts/work-summary.sh
```
### 自定义时间范围
```bash
# 只看过去 1 小时的通知
NOTIF_LOOKBACK_MINUTES=60 ~/.openclaw/workspace/skills/macos-notification-reader/scripts/export-notification.sh
# 工作摘要只看过去 2 小时
WORK_LOOKBACK_MINUTES=120 ~/.openclaw/workspace/skills/macos-notification-reader/scripts/work-summary.sh
```
---
## 🔐 隐私 / Privacy
- ✅ 数据保存在本地(OpenClaw memory 目录),不上传任何服务器
- ✅ 只读取通知标题和内容,不读取附件
- ✅ 支持一键清理:`rm -rf ~/.openclaw/workspace/memory/*/computer_io/notification/`
---
## 🛠️ 故障排查 / Troubleshooting
### 显示 0 条通知?
1. 检查权限是否授权:
```bash
# 打开系统设置 / System Settings
open "x-apple.systempreferences:com.apple.preference.security?Privacy_Notifications"
```
2. 快速调试:
```bash
python3 ~/.openclaw/workspace/skills/macos-notification-reader/scripts/read_notifications.py --minutes 5 --output /tmp/debug.txt
cat /tmp/debug.txt
```
### 权限被拒绝?
```bash
chmod +x ~/.openclaw/workspace/skills/macos-notification-reader/scripts/*.sh
```
---
## 📞 支持 / Support
- 问题反馈:https://github.com/gift-is-coding/macos-notification-reader/issues
- 了解更多 OpenClaw:https://docs.openclaw.ai
---
**Made with ❤️ for OpenClaw**
don't have the plugin yet? install it then click "run inline in claude" again.