133 lines
3.4 KiB
Markdown
133 lines
3.4 KiB
Markdown
---
|
|
name: apple-shortcuts
|
|
description: 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.
|
|
metadata: {"version": "1.0.0", "author": "OpenClaw Community", "requires": ["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
|
|
|
|
```bash
|
|
python3 skills/apple-shortcuts/scripts/generate.py \
|
|
--name "Quick Notion Note" \
|
|
--type voice-to-notion \
|
|
--output ~/Downloads/
|
|
```
|
|
|
|
### Create URL Scheme Integration
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
python3 skills/apple-shortcuts/scripts/generate.py --template voice-to-notion
|
|
```
|
|
|
|
### 2. Quick Expense Logger
|
|
Amount + Category → Logs to Notion database
|
|
|
|
```bash
|
|
python3 skills/apple-shortcuts/scripts/generate.py --template expense-logger
|
|
```
|
|
|
|
### 3. Home Assistant Scene Trigger
|
|
One-tap scene activation
|
|
|
|
```bash
|
|
python3 skills/apple-shortcuts/scripts/generate.py --template ha-scene \
|
|
--scene "Movie Night"
|
|
```
|
|
|
|
### 4. Morning Briefing Trigger
|
|
Manually trigger your Morning Intelligence Briefing
|
|
|
|
```bash
|
|
python3 skills/apple-shortcuts/scripts/generate.py --template morning-briefing
|
|
```
|
|
|
|
### 5. Send to OpenClaw
|
|
Send any text/data to OpenClaw via Telegram
|
|
|
|
```bash
|
|
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
|