什麼是 OpenClaw 技能？#
PocketHook 的 OpenClaw 技能讓您的 OpenClaw 代理可以在裝置上觸發 iOS 捷徑。當您要求 OpenClaw 建立筆記、製作播放清單或執行任何自動化時，代理會在回應中包含標記，PocketHook 會偵測並執行這些標記。
早期版本。 此技能可能需要針對您的設定進行額外調整。包含的捷徑是範例 — 您需要註冊自己的捷徑並調整技能以符合您使用 PocketHook 的方式。
運作方式#
- 您從 PocketHook 傳送訊息，PocketHook 會將其轉發至您的 OpenClaw 伺服器
- OpenClaw 使用其 LLM 和 PocketHook 技能處理訊息
- 回應包含內嵌標記，如
[SHORTCUT:New Note]和[DATA:{...}] - PocketHook 偵測標記，從顯示訊息中移除它們，並在您的裝置上執行捷徑
PocketHook 使用 OpenAI Chat Completions 格式搭配 x-openclaw-agent-id: main 標頭與 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：
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 可以在背景處理長時間工作（研究、專案建立、資料分析）並在準備就緒時交付結果。