Google Messages 浏览器技能

通过使用浏览器工具，在 messages.google.com 上实现 SMS/RCS 消息的自动化。概述Google Messages for Web 允许您通过浏览器从您的 Android 手机发送/接收短信。此技能可自动化该界面。

要求：

装有 Google Messages 应用的 Android 手机

手机和电脑在同一网络（用于初始二维码配对）

• 具有持久会话的浏览器配置文件（使用 openclaw 或您偏好的配置文件）
• 注意：
• 如果不同，请将示例中的 profile=openclaw 替换为您偏好的浏览器配置文件。快速参考操作

命令打开配对页面browser action=open profile=openclaw targetUrl="https://messages.google.com/web/authentication"in examples with your preferred browser profile if different.

Quick Reference

初始设置（二维码配对）

首次设置需要扫描二维码：

1. 打开 Google Messages 网页版

   browser action=open profile=openclaw targetUrl="https://messages.google.com/web/authentication"
   

2. 截图二维码并与用户分享

   browser action=screenshot profile=openclaw
   

3. 用户用手机扫描：

   • 在 Android 上打开 Google Messages 应用
   • 点击 ⋮ 菜单 → "设备配对" → "二维码扫描器"
   • 扫描二维码

4. 验证连接— 截图应显示对话列表，而非二维码

重要提示：启用"记住此电脑"以保持会话。

发送消息

1. 导航至对话

   browser action=navigate profile=openclaw targetUrl="https://messages.google.com/web/conversations"
   

2. 截图并查找对话

   browser action=snapshot profile=openclaw
   

   在对话列表中查找联系人，注意引用。

3. 点击对话

   browser action=act profile=openclaw request={"kind": "click", "ref": "<ref>"}
   

4. 输入消息（从快照中查找文本区域的引用）

   browser action=act profile=openclaw request={"kind": "type", "ref": "<input_ref>", "text": "Your message"}
   

5. 点击发送（查找发送按钮的引用）

   browser action=act profile=openclaw request={"kind": "click", "ref": "<send_ref>"}
   

接收消息（实时通知）

此技能包含一个用于实时接收短信通知的webhook系统。

组件

1. sms-webhook-server.js——接收通知，并转发至OpenClaw频道
2. sms-observer.js——用于监控新消息的浏览器脚本

设置

1. 设置环境变量：

   export SMS_NOTIFICATION_TARGET="telegram:YOUR_CHAT_ID"
   export SMS_NOTIFICATION_CHANNEL="telegram"
   

2. 启动webhook服务器：

   node <skill>/sms-webhook-server.js
   

3. 将观察者注入浏览器（参见references/observer-injection.md）

Systemd 服务（持久化）

cp <skill>/systemd/google-messages-webhook.service ~/.config/systemd/user/
# Edit service file: set SMS_NOTIFICATION_TARGET in Environment=
systemctl --user daemon-reload
systemctl --user enable --now google-messages-webhook

读取消息

请参考references/snippets.md中的 JavaScript 代码片段，用于：

• 获取最近的对话
• 获取当前对话中的消息
• 检查会话状态

故障排除

选择器参考

Google Messages 使用 Angular 组件。这些组件可能会随更新而改变。

限制

• 手机必须在线（消息通过手机同步）
• 浏览器标签页必须保持打开以接收通知
• 会话在约14天无活动后过期
• 页面重新加载后观察器会丢失（需要重新注入）

安全性

• Webhook 仅监听本地主机（127.0.0.1）
• 未存储任何凭据（会话保存在浏览器 Cookie 中）
• QR 配对链接至您的手机——请谨慎对待

许可证

Apache-2.0