名称： google-messages
描述： 通过 Google Messages 网页界面 (messages.google.com) 发送和接收短信/RCS 消息。当被要求“发送短信”、“查看短信”、“SMS”、“文本消息”、“Google Messages”或将收到的短信转发到其他频道时使用。
元数据： {"openclaw": {"emoji": "💬", "requires": {"tools": ["browser"], "bins": ["node"], "env": ["SMS_NOTIFICATION_TARGET", "SMS_NOTIFICATION_CHANNEL"]}}}

Google Messages 浏览器技能

使用 browser 工具，通过 messages.google.com 自动化短信/RCS 消息收发。

概述

Google Messages for Web 允许您通过浏览器从 Android 手机发送/接收短信。本技能旨在自动化该界面。

要求：
- 安装 Google Messages 应用的 Android 手机
- 手机和电脑处于同一网络（用于初始二维码配对）
- 具有持久会话的浏览器配置文件（使用 openclaw 或您偏好的配置文件）

注意： 如果使用不同的浏览器配置文件，请将示例中的 profile=openclaw 替换为您偏好的配置文件。

快速参考

初始设置（二维码配对）

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

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
   在对话列表中查找联系人，记下其 ref。

3. 点击对话
   browser action=act profile=openclaw request={"kind": "click", "ref": "<ref>"}

4. 输入消息（从快照中查找文本框的 ref）
   browser action=act profile=openclaw request={"kind": "type", "ref": "<input_ref>", "text": "您的消息"}

5. 点击发送（查找发送按钮的 ref）
   browser action=act profile=openclaw request={"kind": "click", "ref": "<send_ref>"}

接收消息（实时通知）

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

组件

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

设置

1. 设置环境变量：
   bash export SMS_NOTIFICATION_TARGET="telegram:YOUR_CHAT_ID" export SMS_NOTIFICATION_CHANNEL="telegram"

2. 启动 Webhook 服务器：
   bash node <skill>/sms-webhook-server.js

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

Systemd 服务（持久化）

cp <skill>/systemd/google-messages-webhook.service ~/.config/systemd/user/
# 编辑服务文件：在 Environment= 中设置 SMS_NOTIFICATION_TARGET
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 中）
• 二维码配对链接到您的手机 — 请将其视为敏感信息

许可证

Apache-2.0