ios-shortcuts

name	ios-shortcuts
description	Device control and iOS Shortcuts integration
metadata	{"openclaw":{"always":true,"emoji":"⚡"}}

iOS Device & Shortcuts Skill

Two tools for interacting with the device: device (native, no setup) and shortcut (runs iOS Shortcuts).

device tool — Native Capabilities

Works immediately, no setup required. Uses iOS APIs directly.

Clipboard

device(action: "get_clipboard")
device(action: "set_clipboard", text: "content to copy")

Send Message

Opens the Messages app with pre-filled recipient and body.

device(action: "send_message", to: "1234567890", body: "Hello!")

Create Reminder

Requires Reminders permission (requested on first use).

device(action: "create_reminder", title: "Buy groceries", date: "2026-03-25 09:00")

Create Calendar Event

Requires Calendar permission (requested on first use).

device(action: "create_calendar_event", title: "Meeting", start: "2026-03-25 14:00", end: "2026-03-25 15:00", location: "Office")

Get Location

Requires Location permission (requested on first use).

device(action: "get_location")

Returns: {"latitude": 39.9, "longitude": 116.4, "address": "...", "accuracy": 10}

Device Info

device(action: "device_info")

Returns: {"device_name": "...", "model": "iPhone", "os": "iOS 18.3", "battery": 85, "storage_free_gb": 30.5, "storage_total_gb": 128.0}

Show Notification

Requires Notification permission (requested on first use).

device(action: "show_notification", title: "Alert", body: "Task completed")

Speak Text

device(action: "speak_text", text: "Hello world")

shortcut tool — iOS Shortcuts

Run any Shortcut by name. Use for custom automations the user has created.

List available shortcuts

shortcut(action: "list")

Run a shortcut

shortcut(action: "run", name: "My Custom Shortcut", input: "some input text")

Open an app via URL scheme

shortcut(action: "open_app", url: "tel://1234567890")
shortcut(action: "open_app", url: "mailto:[e-mail]")

When to use which tool

• device: Use for the 9 built-in capabilities (clipboard, location, calendar, etc.). Fast, no app switching.
• shortcut: Use for custom automations the user has set up, or to open specific apps via URL schemes.

Important Notes

• Some device actions require permissions (Location, Calendar, Reminders, Notifications). They are requested automatically on first use.
• send_message opens the Messages app — the user must tap Send manually.
• shortcut execution switches to the Shortcuts app and back. Timeout is 60 seconds.
• Users can add custom shortcuts in the app config (openclaw.json) under tools.shortcuts.custom.