google-messages – OpenClaw Skill

---

name: google-messages description: Send and receive SMS/RCS via Google Messages web interface (messages.google.com). Use when asked to "send a text", "check texts", "SMS", "text message", "Google Messages", or forward incoming texts to other channels. metadata: {"openclaw": {"emoji": "💬", "requires": {"tools": ["browser"], "bins": ["node"], "env": ["SMS_NOTIFICATION_TARGET", "SMS_NOTIFICATION_CHANNEL"]}}}

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

Action	Command
Open pairing page	browser action=open profile=openclaw targetUrl="https://messages.google.com/web/authentication"
Check session	browser action=snapshot profile=openclaw — look for conversation list vs QR code
Take screenshot	browser action=screenshot profile=openclaw

---

Initial Setup (QR Pairing)

First-time setup requires scanning a QR code:

1. Open Google Messages Web

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

2. Screenshot the QR code and share with user

   browser action=screenshot profile=openclaw
   

3. User scans with phone:

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

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

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

---

Sending Messages

1. Navigate to conversations

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

2. Take snapshot and find conversation

   browser action=snapshot profile=openclaw
   

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

3. Click conversation

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

4. Type message (find textarea ref from snapshot)

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

5. 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

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

Setup

1. Set environment variables:

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

2. Start webhook server:

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

3. 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

Problem	Solution
QR code shown	Session expired, re-pair
Elements not found	Google updated UI, check snapshot for new selectors
Send button disabled	Message input empty or phone disconnected
Observer not detecting	Check browser console for [SMS Observer] logs
Webhook not receiving	Verify server running: curl http://127.0.0.1:19888/health

---

Selectors Reference

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

Element	Selector
Conversation list	mws-conversations-list
Conversation item	mws-conversation-list-item
Message input	textarea[aria-label*="message"]
Send button	button[aria-label*="Send"]
QR code	mw-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

Google Messages Skill for OpenClaw

Send and receive SMS/RCS messages via Google Messages web interface using browser automation.

Features

• 📤 Send SMS — Compose and send text messages
• 📥 Receive notifications — Real-time alerts when new messages arrive
• 🔍 Read conversations — Query recent messages and conversation history
• 🔗 OpenClaw integration — Forward incoming SMS to Telegram, WhatsApp, or other channels

Requirements

• OpenClaw with browser automation
• Android phone with Google Messages app
• Node.js 18+

Quick Start

1. Install the skill

# Clone to your skills directory
git clone https://github.com/kesslerio/google-messages-openclaw-skill.git ~/.openclaw/skills/google-messages

2. Pair with your phone

Ask your OpenClaw agent:

"Open Google Messages and show me the QR code"

Or manually:

1. Go to https://messages.google.com/web
2. Open Google Messages on your phone
3. Tap ⋮ → Device pairing → QR code scanner
4. Scan the code

3. Enable notifications (optional)

Start the webhook server to receive incoming message alerts:

# Set your notification target
export SMS_NOTIFICATION_TARGET="telegram:YOUR_CHAT_ID"
export SMS_NOTIFICATION_CHANNEL="telegram"

# Start the server
node ~/.openclaw/skills/google-messages/sms-webhook-server.js

Then inject the observer into the browser tab. See references/observer-injection.md for details.

Usage

Sending messages

Ask your OpenClaw agent:

• "Text John that I'm running late"
• "Send an SMS to 555-1234 saying hello"
• "Message Mom on Google Messages"

Checking messages

• "Check my texts"
• "Any new SMS messages?"
• "What did John text me?"

Configuration

Environment Variables

Variable	Description	Default
SMS_WEBHOOK_PORT	Port for webhook server	19888
SMS_NOTIFICATION_TARGET	OpenClaw target (e.g., telegram:123456)	(none)
SMS_NOTIFICATION_CHANNEL	Channel type	telegram

Systemd Service

For persistent notifications, install as a user service:

cp systemd/google-messages-webhook.service ~/.config/systemd/user/
# Edit service file: uncomment and set Environment= lines
systemctl --user daemon-reload
systemctl --user enable --now google-messages-webhook

How It Works

1. Browser automation — Uses OpenClaw's browser tool to control messages.google.com
2. MutationObserver — Injects a script that watches the DOM for new messages
3. Webhook — When new messages arrive, POSTs to a local server
4. Forwarding — Webhook server uses openclaw message send to forward to your preferred channel

Files

google-messages-skill/
├── SKILL.md                    # OpenClaw skill definition
├── sms-webhook-server.js       # Webhook server for notifications
├── sms-observer.js             # Browser injection script (full version)
├── references/
│   ├── snippets.md             # JavaScript helper snippets
│   └── observer-injection.md   # How to inject the observer
├── scripts/
│   └── start-webhook.sh        # Helper to start webhook
└── systemd/
    └── google-messages-webhook.service

Limitations

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

Security

• Webhook server listens only on localhost
• No credentials stored (session in browser profile cookies)
• Observer script runs only on messages.google.com

License

Apache-2.0

Contributing

Issues and PRs welcome at https://github.com/kesslerio/google-messages-openclaw-skill