O que é o Skill OpenClaw?#
O skill do PocketHook para o OpenClaw permite que seu agente OpenClaw acione Atalhos do iOS no seu dispositivo. Quando você pede ao OpenClaw para criar uma nota, fazer uma playlist ou executar qualquer automação, o agente inclui marcadores na resposta que o PocketHook detecta e executa.
Versão inicial. Este skill pode precisar de ajustes adicionais para sua configuração. Os atalhos incluídos são exemplos — você precisará registrar os seus próprios e adaptar o skill à forma como usa o PocketHook.
Como funciona#
- Você envia uma mensagem pelo PocketHook, que a encaminha ao seu servidor OpenClaw
- O OpenClaw processa com seu LLM e o skill do PocketHook
- A resposta inclui marcadores inline como
[SHORTCUT:New Note]e[DATA:{...}] - O PocketHook detecta os marcadores, remove-os da mensagem exibida e executa os Atalhos no seu dispositivo
O PocketHook se comunica com o OpenClaw usando o formato OpenAI Chat Completions com o cabeçalho x-openclaw-agent-id: main.
Configuração#
1. Instalar o skill#
git clone https://github.com/pockethook-app/openclaw-pockethook.git
cp -r openclaw-pockethook/ ~/.openclaw/workspace/skills/pockethook/
O OpenClaw recarrega skills automaticamente — não é necessário reiniciar.
2. Configurar o PocketHook#
No PocketHook no seu dispositivo iOS, vá para Configurações:
| Configuração | Valor |
|---|---|
| URL do Servidor | URL do proxy HTTP do OpenClaw (HTTPS) |
| Token de Auth | Seu token de autenticação do OpenClaw |
| Modo OpenClaw | ON |
Para tarefas em segundo plano (opcional):
| Configuração | Valor |
|---|---|
| Tarefas em Segundo Plano | ON |
| URL de Polling | Seu endpoint de polling |
| Mensagem de Busca | fetchPendingTasks |
Toque em Testar Conexão para verificar.
Marcadores Suportados#
| Marcador | Finalidade |
|---|---|
[SHORTCUT:name] ou [RUN:name] | Acionar um Atalho do iOS |
[DATA:{...}] | Passar dados JSON para o atalho anterior |
[URL:https://...] | Abrir uma URL no navegador do 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"}]
Múltiplos atalhos são executados em sequência — o PocketHook aguarda a conclusão de cada um antes de executar o próximo.
Registrando Seus Atalhos#
O skill vem com atalhos de exemplo (New Note, newPlayList). Para adicionar os seus, edite SKILL.md em três lugares:
1. O campo description#
Adicione o gatilho do seu atalho à lista Use when: para que o OpenClaw ative o skill:
description: >
...
Use when: create a note, make a playlist, set a reminder, ...
2. A tabela “When to Use”#
Mapeie a intenção do usuário para a ação do atalho:
| User asks to set a reminder | `[SHORTCUT:Add Reminder]` with `title` and `date` |
3. A seção “User’s Shortcuts”#
Documente o nome do atalho 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 para a URL de Polling periodicamente
- Se a resposta for
true, uma notificação aparece - Quando o usuário abre o PocketHook, ele envia
fetchPendingTasks - O OpenClaw responde com os resultados concluídos (incluindo marcadores de atalhos)
- Se não houver resultados pendentes, responde apenas com
false
Isso permite que o OpenClaw lide com tarefas longas (pesquisa, criação de projetos, análise de dados) em segundo plano e entregue os resultados quando estiverem prontos.