OpenClawスキルとは？#
OpenClaw用のPocketHookスキルを使うと、OpenClawエージェントがデバイス上のiOSショートカットをトリガーできます。OpenClawにノートの作成、プレイリストの作成、または任意のオートメーションの実行を依頼すると、エージェントはレスポンスにマーカーを含め、PocketHookがそれを検出して実行します。
アーリーリリース。 このスキルはお使いの環境に合わせて追加の調整が必要な場合があります。含まれているショートカットはサンプルです — 独自のショートカットを登録し、PocketHookの使い方に合わせてスキルを調整する必要があります。
仕組み#
- PocketHookからメッセージを送信すると、OpenClawサーバーに転送されます
- OpenClawがLLMとPocketHookスキルで処理します
- レスポンスに
[SHORTCUT:New Note]や[DATA:{...}]などのインラインマーカーが含まれます - PocketHookがマーカーを検出し、表示メッセージから削除して、デバイス上でショートカットを実行します
PocketHookはx-openclaw-agent-id: mainヘッダーを含むOpenAI Chat Completionsフォーマットを使用してOpenClawと通信します。
セットアップ#
1. スキルのインストール#
git clone https://github.com/pockethook-app/openclaw-pockethook.git
cp -r openclaw-pockethook/ ~/.openclaw/workspace/skills/pockethook/
OpenClawはスキルをホットリロードします — 再起動は不要です。
2. PocketHookの設定#
iOSデバイスのPocketHookで設定に移動します：
| 設定 | 値 |
|---|---|
| サーバーURL | OpenClaw HTTPプロキシURL（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を3か所で編集します：
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はポーリングURLに定期的にGETリクエストを送信します
- レスポンスが
trueの場合、通知が表示されます - ユーザーがPocketHookを開くと、
fetchPendingTasksを送信します - OpenClawが完了した結果で応答します（ショートカットマーカーを含む）
- 保留中の結果がない場合は、
falseのみで応答します
これにより、OpenClawは長いタスク（調査、プロジェクト作成、データ分析）をバックグラウンドで処理し、準備ができたら結果を配信できます。