mirror of
https://github.com/openclaw/openclaw.git
synced 2026-04-24 05:48:37 +00:00
9c4eab69cc
* feat: Make BlueBubbles the primary iMessage integration - Remove old imsg skill (skills/imsg/SKILL.md) - Create new BlueBubbles skill (skills/bluebubbles/SKILL.md) with message tool examples - Add keep-alive script documentation for VM/headless setups to docs/channels/bluebubbles.md - AppleScript that pokes Messages.app every 5 minutes - LaunchAgent configuration for automatic execution - Prevents Messages.app from going idle in VM environments - Update all documentation to prioritize BlueBubbles over legacy imsg: - Mark imsg channel as legacy throughout docs - Update README.md channel lists - Update wizard, hubs, pairing, and index docs - Update FAQ to recommend BlueBubbles for iMessage - Update RPC docs to note imsg as legacy pattern - Update Chinese documentation (zh-CN) - Replace imsg examples with generic macOS skill examples where appropriate BlueBubbles is now the recommended first-class iMessage integration, with the legacy imsg integration marked for potential future removal. * refactor: Update import paths and improve code formatting - Adjusted import paths in session-status-tool.ts, whatsapp-heartbeat.ts, and heartbeat-runner.ts for consistency. - Reformatted code for better readability by aligning and grouping related imports and function parameters. - Enhanced error messages and conditional checks for clarity in heartbeat-runner.ts. * skills: restore imsg skill and align bluebubbles skill * docs: update FAQ for clarity and formatting - Adjusted the formatting of the FAQ section to ensure consistent bullet point alignment. - No content changes were made, only formatting improvements for better readability. * style: oxfmt touched files * fix: preserve BlueBubbles developer reference (#8415) (thanks @tyler6204)
75 lines
1.5 KiB
Markdown
75 lines
1.5 KiB
Markdown
---
|
|
name: imsg
|
|
description: iMessage/SMS CLI for listing chats, history, watch, and sending.
|
|
homepage: https://imsg.to
|
|
metadata:
|
|
{
|
|
"openclaw":
|
|
{
|
|
"emoji": "📨",
|
|
"os": ["darwin"],
|
|
"requires": { "bins": ["imsg"] },
|
|
"install":
|
|
[
|
|
{
|
|
"id": "brew",
|
|
"kind": "brew",
|
|
"formula": "steipete/tap/imsg",
|
|
"bins": ["imsg"],
|
|
"label": "Install imsg (brew)",
|
|
},
|
|
],
|
|
},
|
|
}
|
|
---
|
|
|
|
# imsg Actions
|
|
|
|
## Overview
|
|
|
|
Use `imsg` to read and send Messages.app iMessage/SMS on macOS.
|
|
|
|
Requirements: Messages.app signed in, Full Disk Access for your terminal, and Automation permission to control Messages.app for sending.
|
|
|
|
## Inputs to collect
|
|
|
|
- Recipient handle (phone/email) for `send`
|
|
- `chatId` for history/watch (from `imsg chats --limit 10 --json`)
|
|
- `text` and optional `file` path for sends
|
|
|
|
## Actions
|
|
|
|
### List chats
|
|
|
|
```bash
|
|
imsg chats --limit 10 --json
|
|
```
|
|
|
|
### Fetch chat history
|
|
|
|
```bash
|
|
imsg history --chat-id 1 --limit 20 --attachments --json
|
|
```
|
|
|
|
### Watch a chat
|
|
|
|
```bash
|
|
imsg watch --chat-id 1 --attachments
|
|
```
|
|
|
|
### Send a message
|
|
|
|
```bash
|
|
imsg send --to "+14155551212" --text "hi" --file /path/pic.jpg
|
|
```
|
|
|
|
## Notes
|
|
|
|
- `--service imessage|sms|auto` controls delivery.
|
|
- Confirm recipient + message before sending.
|
|
|
|
## Ideas to try
|
|
|
|
- Use `imsg chats --limit 10 --json` to discover chat ids.
|
|
- Watch a high-signal chat to stream incoming messages.
|