GroupMe

GroupMe Skill — OpenClaw × GroupMe Integration

Connect OpenClaw to any GroupMe group for automated messaging, announcements, and team communication workflows.

What This Skill Does

API Overview

Base URL: https://api.groupme.com/v3

Authentication: Token passed as query parameter ?token=ACCESS_TOKEN

Key Endpoints:

| Endpoint | Purpose | |----------|---------| | POST /bots/post | Send a message | | GET /groups | List your groups | | GET /groups/:id/messages | Get group messages |

Configuration

Before using this skill, you need:

1. GroupMe Access Token — get it at https://dev.groupme.com/bots (top of page) 2. Group ID — the ID of your GroupMe group (fetch via API) 3. Bot ID — create a bot at https://dev.groupme.com/bots/new

Save Your Tokens

Create a file at ~/.openclaw/secrets/groupme.env:

GROUPME_ACCESS_TOKEN="your_access_token_here"
GROUPME_BOT_ID="your_bot_id_here"
GROUPME_GROUP_ID="your_group_id_here"  # Optional — only needed to discover group IDs, not required for sending

Never commit this file to git.

Finding Your Group ID

Run this command (replace with your token):

curl -s "https://api.groupme.com/v3/groups?token=YOUR_TOKEN&per_page=10"

Look for your group in the response — the id field is your Group ID.

Quick Reference

Send a Message

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"bot_id": "YOUR_BOT_ID", "text": "Your message here"}' \
  "https://api.groupme.com/v3/bots/post?token=YOUR_ACCESS_TOKEN"

Send with Line Breaks

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"bot_id": "YOUR_BOT_ID", "text": "Line one\nLine two\nLine three"}' \
  "https://api.groupme.com/v3/bots/post?token=YOUR_ACCESS_TOKEN"

Usage Patterns

One-Time Messages

Tell OpenClaw to send a message:

> "Send a message to the group: Don't forget, team meeting at 3pm today"

> "Post this to the group: Great job everyone on a successful week!"

Scheduled Messages via Cron

Daily shift reminder (Mon-Fri at 8am):

{
  "schedule": {
    "kind": "cron",
    "expr": "0 8 * * 1-5",
    "tz": "America/New_York"
  },
  "payload": {
    "kind": "systemEvent",
    "text": "Send daily shift reminder to GroupMe"
  },
  "sessionTarget": "isolated"
}

Weekly team announcement (Monday at 9am):

{
  "schedule": {
    "kind": "cron",
    "expr": "0 9 * * 1",
    "tz": "America/New_York"
  },
  "payload": {
    "kind": "systemEvent",
    "text": "Send weekly team announcement to GroupMe"
  },
  "sessionTarget": "isolated"
}

Workflow Ideas

| Workflow | Description | |----------|-------------| | Shift Reminders | Fire 1hr before each shift | | Team Announcements | Weekly goals, meeting changes | | Emergency Alerts | One-command urgent broadcast | | Recognition Posts | Kudos for good work | | Coverage Requests | "Need someone to cover 3-5pm" | | Daily Briefs | Industry news, daily stats | | Polling | "Thumbs up if you can work Saturday" |

Message Types

Plain Text

{
  "bot_id": "BOT_ID",
  "text": "Your message here"
}

With Image

{
  "bot_id": "BOT_ID",
  "text": "Check out the new schedule!",
  "attachments": [{
    "type": "image",
    "url": "https://i.groupme.com/xxxxx.large"
  }]
}

With Location

{
  "bot_id": "BOT_ID",
  "text": "Heading to the location",
  "attachments": [{
    "type": "location",
    "lat": "40.738206",
    "lng": "-73.993285",
    "name": "Location Name"
  }]
}

Limitations

Files

~/.openclaw/skills/groupme/
├── SKILL.md              ← this file
├── scripts/
│   └── send-message.sh   ← optional shell helper

Setup Checklist

Skill Metadata

Before using this skill, you need:

1. GroupMe Access Token — get it at https://dev.groupme.com/bots (top of page) 2. Group ID — the ID of your GroupMe group (fetch via API) 3. Bot ID — create a bot at https://dev.groupme.com/bots/new

Save Your Tokens

Create a file at ~/.openclaw/secrets/groupme.env:

GROUPME_ACCESS_TOKEN="your_access_token_here"
GROUPME_BOT_ID="your_bot_id_here"
GROUPME_GROUP_ID="your_group_id_here"  # Optional — only needed to discover group IDs, not required for sending

Never commit this file to git.

Finding Your Group ID

Run this command (replace with your token):

curl -s "https://api.groupme.com/v3/groups?token=YOUR_TOKEN&per_page=10"

Look for your group in the response — the id field is your Group ID.