Què és la Skill d’OpenClaw?#
La skill de PocketHook per a OpenClaw permet que el teu agent d’OpenClaw activi Dreceres d’iOS al teu dispositiu. Quan demanes a OpenClaw que creï una nota, faci una llista de reproducció o executi qualsevol automatització, l’agent inclou marcadors a la seva resposta que PocketHook detecta i executa.
Versió inicial. Aquesta skill pot necessitar ajustos addicionals per a la teva configuració. Les dreceres incloses són exemples — hauràs de registrar les teves pròpies i adaptar la skill a la manera com utilitzes PocketHook.
Com Funciona#
- Envies un missatge des de PocketHook, que el reenvia al teu servidor OpenClaw
- OpenClaw el processa amb el seu LLM i la skill de PocketHook
- La resposta inclou marcadors en línia com
[SHORTCUT:New Note]i[DATA:{...}] - PocketHook detecta els marcadors, els elimina del missatge mostrat i executa les Dreceres al teu dispositiu
PocketHook es comunica amb OpenClaw utilitzant el format Chat Completions d’OpenAI amb la capçalera x-openclaw-agent-id: main.
Configuració#
1. Instal·la la skill#
git clone https://github.com/pockethook-app/openclaw-pockethook.git
cp -r openclaw-pockethook/ ~/.openclaw/workspace/skills/pockethook/
OpenClaw recarrega les skills en calent — no cal reiniciar.
2. Configura PocketHook#
A PocketHook, al teu dispositiu iOS, ves a Configuració:
| Ajust | Valor |
|---|---|
| URL del Servidor | La URL del teu proxy HTTP d’OpenClaw (HTTPS) |
| Token d’Autenticació | El teu token d’autenticació d’OpenClaw |
| Mode OpenClaw | ON |
Per a tasques en segon pla (opcional):
| Ajust | Valor |
|---|---|
| Tasques en Segon Pla | ON |
| URL de Polling | El teu endpoint de polling |
| Missatge de Consulta | fetchPendingTasks |
Toca Provar Connexió per verificar.
Marcadors Suportats#
| Marcador | Propòsit |
|---|---|
[SHORTCUT:name] o [RUN:name] | Activa una Drecera d’iOS |
[DATA:{...}] | Passa dades JSON a la drecera precedent |
[URL:https://...] | Obre una URL al navegador integrat de l’app |
Els marcadors es col·loquen al final de la resposta i es poden combinar:
Creating your note and opening the recipe.
[URL:https://example.com/recipe]
[SHORTCUT:New Note]
[DATA:{"title": "Pasta Recipe", "content": "Ingredients: flour, eggs, salt"}]
Múltiples dreceres s’executen en seqüència — PocketHook espera que cadascuna acabi abans d’executar la següent.
Registrar les Teves Dreceres#
La skill inclou dreceres d’exemple (New Note, newPlayList). Per afegir les teves pròpies, edita SKILL.md en tres llocs:
1. El camp description#
Afegeix el disparador de la teva drecera a la llista Use when: perquè OpenClaw activi la skill:
description: >
...
Use when: create a note, make a playlist, set a reminder, ...
2. La taula “When to Use”#
Relaciona la intenció de l’usuari amb l’acció de la drecera:
| User asks to set a reminder | `[SHORTCUT:Add Reminder]` with `title` and `date` |
3. La secció “User’s Shortcuts”#
Documenta el nom de la drecera i el format de les dades:
### Reminders
- `Add Reminder` — Create a reminder. Data: `{"title": "...", "date": "..."}`
Tasques en Segon Pla#
PocketHook suporta polling per a treball asíncron:
- PocketHook envia periòdicament un GET a la URL de Polling
- Si la resposta és
true, apareix una notificació - Quan l’usuari obre PocketHook, envia
fetchPendingTasks - OpenClaw respon amb els resultats completats (incloent-hi marcadors de dreceres)
- Si no hi ha resultats pendents, respon simplement amb
false
Això permet que OpenClaw gestioni tasques llargues (recerca, creació de projectes, anàlisi de dades) en segon pla i lliuri els resultats quan estiguin llestos.