openclaw-backups/skills/apple-shortcuts/SKILL.md

name, description, metadata

name	description	metadata
apple-shortcuts	Generate Apple Shortcuts (.shortcut files) and create URL scheme integrations for iOS/macOS automation. Bridge Apple Shortcuts with OpenClaw, Home Assistant, Notion, n8n, and more.	version author requires 1.0.0 OpenClaw Community python3

Apple Shortcuts Generator

Generate custom Apple Shortcuts (.shortcut files) and create URL scheme integrations for seamless iOS/macOS automation.

Features

1. Generate .shortcut files - Download and install directly on iPhone/Mac
2. URL Scheme integrations - Shortcuts that communicate back to OpenClaw
3. Pre-built templates - Common automations ready to use
4. Custom shortcut builder - Describe what you want, get a working shortcut

Quick Start

Generate a Shortcut

python3 skills/apple-shortcuts/scripts/generate.py \
  --name "Quick Notion Note" \
  --type voice-to-notion \
  --output ~/Downloads/

Create URL Scheme Integration

python3 skills/apple-shortcuts/scripts/url-scheme.py \
  --action send-telegram \
  --message "Hello from Shortcuts!"

Pre-built Templates

1. Voice to Notion

Records audio → Transcribes → Adds to Notion inbox

python3 skills/apple-shortcuts/scripts/generate.py --template voice-to-notion

2. Quick Expense Logger

Amount + Category → Logs to Notion database

python3 skills/apple-shortcuts/scripts/generate.py --template expense-logger

3. Home Assistant Scene Trigger

One-tap scene activation

python3 skills/apple-shortcuts/scripts/generate.py --template ha-scene \
  --scene "Movie Night"

4. Morning Briefing Trigger

Manually trigger your Morning Intelligence Briefing

python3 skills/apple-shortcuts/scripts/generate.py --template morning-briefing

5. Send to OpenClaw

Send any text/data to OpenClaw via Telegram

python3 skills/apple-shortcuts/scripts/generate.py --template send-to-openclaw

URL Scheme Reference

Open Telegram

shortcuts://run-shortcut?name=Send%20to%20OpenClaw&input=text&text=Hello

Trigger n8n Webhook

https://n8n.kangaroo-eel.ts.net/webhook/trigger-morning-briefing

Call OpenClaw Directly

https://t.me/clawdbot?start=shortcut_<encoded_message>

Custom Shortcuts

Describe what you want, and I'll generate it:

Example:

"I want a shortcut that takes a photo of a receipt, extracts the total, and logs it to my Notion expenses database with today's date"

Result: Generated .shortcut file ready to install!

Installation

1. Generate the shortcut file
2. AirDrop or save to Files app
3. Tap the file → "Add Shortcut"
4. Done!

Advanced: Two-Way Communication

Shortcuts can send data TO OpenClaw and receive responses:

From Shortcut → OpenClaw

1. Shortcut collects data (text, photo, location, etc.)
2. Sends via Telegram bot API or webhook
3. OpenClaw processes and responds

From OpenClaw → Shortcut

1. OpenClaw generates a shortcut file
2. Sends download link via Telegram
3. User installs on device

Security Notes

• API keys are embedded in shortcuts (keep them private!)
• Use webhook endpoints that don't expose sensitive data
• Shortcuts run locally on your device

Troubleshooting

Shortcut won't install: Check iOS version (requires iOS 14+) Webhook fails: Verify URL is accessible from your network Notion auth fails: Check API key has correct permissions