¿Qué es el Skill de OpenClaw?#
El skill de PocketHook para OpenClaw permite que tu agente OpenClaw active Atajos de iOS en tu dispositivo. Cuando le pides a OpenClaw crear una nota, hacer una playlist o ejecutar cualquier automatización, el agente incluye marcadores en su respuesta que PocketHook detecta y ejecuta.
Versión inicial. Este skill puede necesitar ajustes para tu configuración. Los atajos incluidos son ejemplos — tendrás que registrar los tuyos y adaptar el skill a cómo uses PocketHook.
Cómo Funciona#
- Envías un mensaje desde PocketHook, que lo reenvía a tu servidor OpenClaw
- OpenClaw lo procesa con su LLM y el skill de PocketHook
- La respuesta incluye marcadores inline como
[SHORTCUT:New Note]y[DATA:{...}] - PocketHook detecta los marcadores, los elimina del mensaje mostrado, y ejecuta los Atajos en tu dispositivo
PocketHook se comunica con OpenClaw usando el formato OpenAI Chat Completions con la cabecera x-openclaw-agent-id: main.
Configuración#
1. Instalar el skill#
git clone https://github.com/pockethook-app/openclaw-pockethook.git
cp -r openclaw-pockethook/ ~/.openclaw/workspace/skills/pockethook/
OpenClaw recarga los skills en caliente — no necesita reinicio.
2. Configurar PocketHook#
En PocketHook en tu dispositivo iOS, ve a Ajustes:
| Ajuste | Valor |
|---|---|
| URL del Servidor | URL de tu proxy HTTP de OpenClaw (HTTPS) |
| Token de Auth | Tu token de autenticación de OpenClaw |
| Modo OpenClaw | ON |
Para tareas en segundo plano (opcional):
| Ajuste | Valor |
|---|---|
| Tareas en Segundo Plano | ON |
| URL de Polling | Tu endpoint de polling |
| Mensaje de Consulta | fetchPendingTasks |
Toca Probar Conexión para verificar.
Marcadores Soportados#
| Marcador | Propósito |
|---|---|
[SHORTCUT:nombre] o [RUN:nombre] | Activar un Atajo de iOS |
[DATA:{...}] | Pasar datos JSON al atajo precedente |
[URL:https://...] | Abrir una URL en el navegador integrado |
Los marcadores se colocan al final de la respuesta y se pueden combinar:
Creando tu nota y abriendo la receta.
[URL:https://ejemplo.com/receta]
[SHORTCUT:New Note]
[DATA:{"title": "Receta de Pasta", "content": "Ingredientes: harina, huevos, sal"}]
Múltiples atajos se ejecutan en secuencia — PocketHook espera a que cada uno termine antes de ejecutar el siguiente.
Registrar Tus Atajos#
El skill viene con atajos de ejemplo (New Note, newPlayList). Para añadir los tuyos, edita SKILL.md en tres sitios:
1. El campo description#
Añade el trigger de tu atajo a la lista Use when: para que OpenClaw active el skill:
description: >
...
Use when: create a note, make a playlist, set a reminder, ...
2. La tabla “When to Use”#
Mapea la intención del usuario a la acción del atajo:
| User asks to set a reminder | `[SHORTCUT:Add Reminder]` with `title` and `date` |
3. La sección “User’s Shortcuts”#
Documenta el nombre del atajo y el formato de datos:
### Reminders
- `Add Reminder` — Create a reminder. Data: `{"title": "...", "date": "..."}`
Tareas en Segundo Plano#
PocketHook soporta polling para trabajo asíncrono:
- PocketHook envía un GET a la URL de Polling periódicamente
- Si la respuesta es
true, aparece una notificación - Cuando el usuario abre PocketHook, envía
fetchPendingTasks - OpenClaw responde con los resultados completados (incluyendo marcadores de atajos)
- Si no hay resultados pendientes, responde solo con
false
Esto permite que OpenClaw maneje tareas largas (investigación, creación de proyectos, análisis de datos) en segundo plano y entregue los resultados cuando estén listos.