# Send Google Messages to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "google-messages-openclaw-skill",
    "name": "Google Messages",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/kesslerio/google-messages-openclaw-skill",
    "canonicalUrl": "https://clawhub.ai/kesslerio/google-messages-openclaw-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/google-messages-openclaw-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-messages-openclaw-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "package.json",
      "references/observer-injection.md",
      "references/snippets.md",
      "scripts/start-webhook.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/google-messages-openclaw-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/google-messages-openclaw-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/google-messages-openclaw-skill",
    "agentUrl": "https://openagent3.xyz/skills/google-messages-openclaw-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/google-messages-openclaw-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/google-messages-openclaw-skill/agent.md"
  }
}
```
## Documentation

### Google Messages Browser Skill

Automate SMS/RCS messaging via messages.google.com using the browser tool.

### Overview

Google Messages for Web allows you to send/receive texts from your Android phone via browser. This skill automates that interface.

Requirements:

Android phone with Google Messages app
Phone and computer on same network (for initial QR pairing)
Browser profile with persistent session (use openclaw or your preferred profile)

Note: Replace profile=openclaw in examples with your preferred browser profile if different.

### Quick Reference

ActionCommandOpen pairing pagebrowser action=open profile=openclaw targetUrl="https://messages.google.com/web/authentication"Check sessionbrowser action=snapshot profile=openclaw — look for conversation list vs QR codeTake screenshotbrowser action=screenshot profile=openclaw

### Initial Setup (QR Pairing)

First-time setup requires scanning a QR code:

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



Screenshot the QR code and share with user
browser action=screenshot profile=openclaw



User scans with phone:

Open Google Messages app on Android
Tap ⋮ menu → "Device pairing" → "QR code scanner"
Scan the QR code



Verify connection — snapshot should show conversation list, not QR code

Important: Enable "Remember this computer" to persist the session.

### Sending Messages

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



Take snapshot and find conversation
browser action=snapshot profile=openclaw

Look for the contact in the conversation list, note the ref.


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



Type message (find textarea ref from snapshot)
browser action=act profile=openclaw request={"kind": "type", "ref": "<input_ref>", "text": "Your message"}



Click send (find send button ref)
browser action=act profile=openclaw request={"kind": "click", "ref": "<send_ref>"}

### Receiving Messages (Real-time Notifications)

This skill includes a webhook system for real-time incoming SMS notifications.

### Components

sms-webhook-server.js — receives notifications, forwards to OpenClaw channels
sms-observer.js — browser script that watches for new messages

### Setup

Set environment variables:
export SMS_NOTIFICATION_TARGET="telegram:YOUR_CHAT_ID"
export SMS_NOTIFICATION_CHANNEL="telegram"



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



Inject observer into browser (see references/observer-injection.md)

### Systemd Service (Persistent)

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

### Reading Messages

See references/snippets.md for JavaScript snippets to:

Get recent conversations
Get messages in current conversation
Check session status

### Troubleshooting

ProblemSolutionQR code shownSession expired, re-pairElements not foundGoogle updated UI, check snapshot for new selectorsSend button disabledMessage input empty or phone disconnectedObserver not detectingCheck browser console for [SMS Observer] logsWebhook not receivingVerify server running: curl http://127.0.0.1:19888/health

### Selectors Reference

Google Messages uses Angular components. These may change with updates.

ElementSelectorConversation listmws-conversations-listConversation itemmws-conversation-list-itemMessage inputtextarea[aria-label*="message"]Send buttonbutton[aria-label*="Send"]QR codemw-qr-code

### Limitations

Phone must be online (messages sync through phone)
Browser tab must stay open for notifications
Session expires after ~14 days of inactivity
Observer lost on page reload (re-inject needed)

### Security

Webhook listens on localhost only (127.0.0.1)
No credentials stored (session in browser cookies)
QR pairing links to your phone — treat as sensitive

### License

Apache-2.0
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: kesslerio
- Version: 0.1.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/google-messages-openclaw-skill)
- [Send to Agent page](https://openagent3.xyz/skills/google-messages-openclaw-skill/agent)
- [JSON manifest](https://openagent3.xyz/skills/google-messages-openclaw-skill/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/google-messages-openclaw-skill/agent.md)
- [Download page](https://openagent3.xyz/downloads/google-messages-openclaw-skill)