Cos’è lo Skill OpenClaw?#
Lo skill PocketHook per OpenClaw permette al tuo agente OpenClaw di attivare le scorciatoie iOS sul tuo dispositivo. Quando chiedi a OpenClaw di creare una nota, fare una playlist o eseguire qualsiasi automazione, l’agente include dei marcatori nella sua risposta che PocketHook rileva ed esegue.
Versione iniziale. Questo skill potrebbe necessitare di ulteriori regolazioni per la tua configurazione. Le scorciatoie incluse sono esempi — dovrai registrare le tue e adattare lo skill al tuo utilizzo di PocketHook.
Come funziona#
- Invii un messaggio da PocketHook, che lo inoltra al tuo server OpenClaw
- OpenClaw lo elabora con il suo LLM e lo skill PocketHook
- La risposta include marcatori inline come
[SHORTCUT:New Note]e[DATA:{...}] - PocketHook rileva i marcatori, li rimuove dal messaggio visualizzato ed esegue le scorciatoie sul tuo dispositivo
PocketHook comunica con OpenClaw utilizzando il formato OpenAI Chat Completions con l’intestazione x-openclaw-agent-id: main.
Configurazione#
1. Installare lo skill#
git clone https://github.com/pockethook-app/openclaw-pockethook.git
cp -r openclaw-pockethook/ ~/.openclaw/workspace/skills/pockethook/
OpenClaw ricarica automaticamente gli skill — non è necessario riavviare.
2. Configurare PocketHook#
In PocketHook sul tuo dispositivo iOS, vai su Impostazioni:
| Impostazione | Valore |
|---|---|
| URL del Server | URL del proxy HTTP di OpenClaw (HTTPS) |
| Token di Auth | Il tuo token di autenticazione OpenClaw |
| Modalità OpenClaw | ON |
Per le attività in background (opzionale):
| Impostazione | Valore |
|---|---|
| Attività in Background | ON |
| URL di Polling | Il tuo endpoint di polling |
| Messaggio di Recupero | fetchPendingTasks |
Tocca Testa Connessione per verificare.
Marcatori Supportati#
| Marcatore | Scopo |
|---|---|
[SHORTCUT:name] o [RUN:name] | Attivare una scorciatoia iOS |
[DATA:{...}] | Passare dati JSON alla scorciatoia precedente |
[URL:https://...] | Aprire un URL nel browser integrato |
I marcatori sono posizionati alla fine della risposta e possono essere combinati:
Creating your note and opening the recipe.
[URL:https://example.com/recipe]
[SHORTCUT:New Note]
[DATA:{"title": "Pasta Recipe", "content": "Ingredients: flour, eggs, salt"}]
Le scorciatoie multiple vengono eseguite in sequenza — PocketHook attende il completamento di ciascuna prima di eseguire la successiva.
Registrare le Tue Scorciatoie#
Lo skill include scorciatoie di esempio (New Note, newPlayList). Per aggiungere le tue, modifica SKILL.md in tre punti:
1. Il campo description#
Aggiungi il trigger della tua scorciatoia alla lista Use when: affinché OpenClaw attivi lo skill:
description: >
...
Use when: create a note, make a playlist, set a reminder, ...
2. La tabella “When to Use”#
Mappa l’intenzione dell’utente all’azione della scorciatoia:
| User asks to set a reminder | `[SHORTCUT:Add Reminder]` with `title` and `date` |
3. La sezione “User’s Shortcuts”#
Documenta il nome della scorciatoia e il formato dei dati:
### Reminders
- `Add Reminder` — Create a reminder. Data: `{"title": "...", "date": "..."}`
Attività in Background#
PocketHook supporta il polling per il lavoro asincrono:
- PocketHook invia periodicamente un GET all’URL di Polling
- Se la risposta è
true, appare una notifica - Quando l’utente apre PocketHook, invia
fetchPendingTasks - OpenClaw risponde con i risultati completati (inclusi i marcatori delle scorciatoie)
- Se non ci sono risultati in sospeso, risponde solo con
false
Questo permette a OpenClaw di gestire attività lunghe (ricerca, creazione di progetti, analisi dei dati) in background e consegnare i risultati quando sono pronti.