Что такое навык OpenClaw?#
Навык PocketHook для OpenClaw позволяет вашему агенту OpenClaw запускать быстрые команды iOS на вашем устройстве. Когда вы просите OpenClaw создать заметку, сделать плейлист или выполнить любую автоматизацию, агент включает маркеры в свой ответ, которые PocketHook обнаруживает и выполняет.
Ранний выпуск. Этот навык может потребовать дополнительной настройки для вашей конфигурации. Включённые быстрые команды являются примерами — вам нужно зарегистрировать свои и адаптировать навык под ваше использование PocketHook.
Как это работает#
- Вы отправляете сообщение из PocketHook, которое пересылается на ваш сервер OpenClaw
- OpenClaw обрабатывает его с помощью LLM и навыка PocketHook
- Ответ включает встроенные маркеры, такие как
[SHORTCUT:New Note]и[DATA:{...}] - PocketHook обнаруживает маркеры, удаляет их из отображаемого сообщения и выполняет быстрые команды на вашем устройстве
PocketHook взаимодействует с OpenClaw, используя формат OpenAI Chat Completions с заголовком x-openclaw-agent-id: main.
Настройка#
1. Установите навык#
git clone https://github.com/pockethook-app/openclaw-pockethook.git
cp -r openclaw-pockethook/ ~/.openclaw/workspace/skills/pockethook/
OpenClaw автоматически перезагружает навыки — перезапуск не требуется.
2. Настройте PocketHook#
В PocketHook на вашем iOS-устройстве перейдите в Настройки:
| Настройка | Значение |
|---|---|
| URL сервера | URL HTTP-прокси OpenClaw (HTTPS) |
| Токен аутентификации | Ваш токен аутентификации OpenClaw |
| Режим OpenClaw | ON |
Для фоновых задач (необязательно):
| Настройка | Значение |
|---|---|
| Фоновые задачи | ON |
| URL опроса | Ваша конечная точка опроса |
| Сообщение выборки | fetchPendingTasks |
Нажмите Тестировать подключение для проверки.
Поддерживаемые маркеры#
| Маркер | Назначение |
|---|---|
[SHORTCUT:name] или [RUN:name] | Запустить быструю команду iOS |
[DATA:{...}] | Передать данные JSON предыдущей быстрой команде |
[URL:https://...] | Открыть URL во встроенном браузере |
Маркеры размещаются в конце ответа и могут комбинироваться:
Creating your note and opening the recipe.
[URL:https://example.com/recipe]
[SHORTCUT:New Note]
[DATA:{"title": "Pasta Recipe", "content": "Ingredients: flour, eggs, salt"}]
Несколько быстрых команд выполняются последовательно — PocketHook ждёт завершения каждой перед запуском следующей.
Регистрация ваших быстрых команд#
Навык поставляется с примерами быстрых команд (New Note, newPlayList). Чтобы добавить свои, отредактируйте SKILL.md в трёх местах:
1. Поле description#
Добавьте триггер вашей быстрой команды в список Use when:, чтобы OpenClaw активировал навык:
description: >
...
Use when: create a note, make a playlist, set a reminder, ...
2. Таблица “When to Use”#
Сопоставьте намерение пользователя с действием быстрой команды:
| User asks to set a reminder | `[SHORTCUT:Add Reminder]` with `title` and `date` |
3. Раздел “User’s Shortcuts”#
Задокументируйте название быстрой команды и формат данных:
### Reminders
- `Add Reminder` — Create a reminder. Data: `{"title": "...", "date": "..."}`
Фоновые задачи#
PocketHook поддерживает опрос для асинхронной работы:
- PocketHook периодически отправляет GET-запрос на URL опроса
- Если ответ —
true, появляется уведомление - Когда пользователь открывает PocketHook, отправляется
fetchPendingTasks - OpenClaw отвечает завершёнными результатами (включая маркеры быстрых команд)
- Если нет ожидающих результатов, отвечает просто
false
Это позволяет OpenClaw обрабатывать длительные задачи (исследование, создание проектов, анализ данных) в фоновом режиме и доставлять результаты, когда они готовы.