O que é a Skill OpenClaw?#
A skill do PocketHook para o OpenClaw permite que o seu agente OpenClaw acione Shortcuts do iOS no seu dispositivo. Quando pede ao OpenClaw para criar uma nota, fazer uma playlist ou executar qualquer automação, o agente inclui marcadores na sua resposta que o PocketHook deteta e executa.
Lançamento inicial. Esta skill pode precisar de afinação adicional para a sua configuração. Os atalhos incluídos são exemplos — terá de registar os seus próprios e adaptar a skill à forma como usa o PocketHook.
Como Funciona#
- Envia uma mensagem a partir do PocketHook, que a encaminha para o seu servidor OpenClaw
- O OpenClaw processa-a com o seu LLM e a skill do PocketHook
- A resposta inclui marcadores inline como
[SHORTCUT:New Note]e[DATA:{...}] - O PocketHook deteta os marcadores, remove-os da mensagem apresentada e executa os Shortcuts no seu dispositivo
O PocketHook comunica com o OpenClaw usando o formato OpenAI Chat Completions com o cabeçalho x-openclaw-agent-id: main.
Configuração#
1. Instalar a skill#
git clone https://github.com/pockethook-app/openclaw-pockethook.git
cp -r openclaw-pockethook/ ~/.openclaw/workspace/skills/pockethook/
O OpenClaw recarrega skills a quente — sem necessidade de reiniciar.
2. Configurar o PocketHook#
No PocketHook, no seu dispositivo iOS, aceda a Definições:
| Definição | Valor |
|---|---|
| URL do Servidor | O URL do seu proxy HTTP do OpenClaw (HTTPS) |
| Token de Autenticação | O seu token de autenticação do OpenClaw |
| Modo OpenClaw | ATIVADO |
Para tarefas em segundo plano (opcional):
| Definição | Valor |
|---|---|
| Tarefas em Segundo Plano | ATIVADO |
| URL de Polling | O seu endpoint de polling |
| Mensagem de Obtenção | fetchPendingTasks |
Toque em Testar Ligação para verificar.
Marcadores Suportados#
| Marcador | Objetivo |
|---|---|
[SHORTCUT:name] ou [RUN:name] | Aciona um Shortcut do iOS |
[DATA:{...}] | Passa dados JSON ao atalho anterior |
[URL:https://...] | Abre um URL no navegador integrado na app |
Os marcadores são colocados no final da resposta e podem ser combinados:
Creating your note and opening the recipe.
[URL:https://example.com/recipe]
[SHORTCUT:New Note]
[DATA:{"title": "Pasta Recipe", "content": "Ingredients: flour, eggs, salt"}]
Vários Shortcuts são executados em sequência — o PocketHook aguarda que cada um termine antes de executar o seguinte.
Registar os Seus Shortcuts#
A skill vem com Shortcuts de exemplo (New Note, newPlayList). Para adicionar os seus próprios, edite o SKILL.md em três locais:
1. O campo description#
Adicione o gatilho do seu Shortcut à lista Use when: para que o OpenClaw ative a skill:
description: >
...
Use when: create a note, make a playlist, set a reminder, ...
2. A tabela “When to Use”#
Associe a intenção do utilizador à ação do Shortcut:
| User asks to set a reminder | `[SHORTCUT:Add Reminder]` with `title` and `date` |
3. A secção “User’s Shortcuts”#
Documente o nome do Shortcut e o formato dos dados:
### Reminders
- `Add Reminder` — Create a reminder. Data: `{"title": "...", "date": "..."}`
Tarefas em Segundo Plano#
O PocketHook suporta polling para trabalho assíncrono:
- O PocketHook envia um GET ao URL de Polling periodicamente
- Se a resposta for
true, aparece uma notificação - Quando o utilizador abre o PocketHook, este envia
fetchPendingTasks - O OpenClaw responde com os resultados concluídos (incluindo marcadores de Shortcuts)
- Se não houver resultados pendentes, responde apenas com
false
Isto permite ao OpenClaw tratar tarefas longas (investigação, criação de projetos, análise de dados) em segundo plano e entregar os resultados quando estiverem prontos.