什么是 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 可以在后台处理长时间任务（研究、项目创建、数据分析）并在准备就绪时交付结果。