核心用法
glass2claw 是一套纯指令型(instruction-only)自动化工作流,设计用于将 WhatsApp 接收的生活图像(如酒标、茶饼、名片)经私有 Discord 服务器路由至对应的 Notion 数据库。
完整流程:
1. 接收:WhatsApp 会话通过 sessions_send 将图像 URL 转发至 Discord #hub 频道
2. 分类:Agent 读取 configs/vision_router.md 配置,基于视觉内容判定意图(Wine / Tea / Contacts)
3. 路由:再次调用 sessions_send 将任务分发至对应的专业频道会话
4. 存储:专业频道 Agent 使用 message 工具发布图像,并调用 Notion API 写入结构化条目
关键特性:
- 零二进制执行:无 curl、无 exec、无外部脚本,完全依赖 OpenClaw 原生工具
- 配置驱动路由:所有目标会话密钥硬编码于
configs/vision_router.md,Agent 无自由裁量权 - 数据不出私域:全部流转在用户自有的 Discord 服务器频道间完成
显著优点
| 维度 | 优势 |
|------|------|
| 安全性 | 纯指令架构消除代码注入风险;私有 Discord 隔离公网暴露 |
| 可控性 | 硬编码配置 + 最小权限 Notion Token,攻击面极窄 |
| 灵活性 | 基于 OpenClaw 平台工具,可扩展至更多分类场景 |
| 可审计 | 会话级日志天然留存于 Discord 频道历史 |
潜在缺点与局限性
- 配置复杂度:需手动维护
vision_router.md及三个 Discord 频道的会话密钥映射 - 单点依赖:高度依赖 OpenClaw 平台的
sessions_send工具可用性 - 无本地缓存:图像 URL 若过期将导致抓取失败,无重试机制说明
- 分类范围有限:当前仅预置 Wine/Tea/Contacts 三类,新增类别需人工扩展配置
适合人群
- 已部署 OpenClaw 平台且拥有私有 Discord 服务器的进阶用户
- 追求数据主权、不愿将生活图像上传至公有云相册/笔记服务的隐私敏感者
- 需要结构化归档特定垂直领域视觉信息(藏酒、茶品、人脉)的收藏管理者
常规风险
| 风险项 | 说明 | 缓解建议 |
|--------|------|----------|
| Notion Token 泄露 | 环境变量 `NOTION_API_KEY` 若被其他技能读取可能导致数据泄露 | 严格限定 Token 权限至仅三个目标数据库,定期轮换 |
| Discord 频道误配置 | 会话密钥指向错误频道可能导致信息泄露至非预期成员 | 使用私有服务器,定期审计频道成员权限 |
| URL 时效性 | WhatsApp 图像 URL 通常有有效期,延迟处理可能失效 | 建议设置即时触发机制,或补充 URL 预抓取逻辑 |
| 配置漂移 | `vision_router.md` 被意外修改将导致路由失败 | 纳入版本控制,变更前备份验证 |