设置指南

Mon, 09 Mar 2026 00:00:00 +0000

1. 安装 PocketHook
#

从 App Store 下载 PocketHook，并在 iPhone、iPad 或 Mac 上打开。

2. 配置您的服务器
#

PocketHook 需要一个 HTTPS 端点进行通信。您可以使用：

代理服务器

Wed, 11 Mar 2026 00:00:00 +0000

什么是 PocketHook Agent Server？
#

代理服务器将 PocketHook 变成一个完整的 AI 助手。无需自己编写响应逻辑，只需连接一个大语言模型（Claude、GPT、Gemini 等）来处理消息、调用工具并返回结构化的 PocketHook 响应——包括快捷指令触发。

服务器运行在您自己的机器上。您的数据由您掌控。

这是一个起点。 服务器附带一组核心工具，并被设计为可由您扩展。添加您自己的集成——邮件、日历、文档、API——让它成为您的。

功能
#

多提供商 LLM — Anthropic、OpenAI、GitHub Copilot、Google、Mistral、Groq、xAI、OpenRouter、Ollama（本地）、LM Studio（本地）
OAuth 认证 — GitHub Copilot 和 OpenAI Codex，通过设备码/浏览器流程
代理工具 — Shell 命令、文件读写、目录列表、网络搜索、网页抓取、开发服务器管理
框架/用户分离 — 框架文件（skills/、custom-tools/、config/）保持只读。您的自定义位于 data/user/（技能、自定义工具、说明、类型化偏好）。框架更新不会覆盖您的工作
类型化用户偏好 — 将偏好的地图应用或隧道域名等值存储在 data/user/prefs.json 中。在技能中通过 {{prefs.key}} 引用，服务器会在加载时进行替换
一次调用完成编程任务 — run_code_job 元工具创建一个 prompt 类型的后台任务（由您配置的 LLM 运行）并在一步内向用户发送确认，替代易出错的"respond + create-job"模式
类型化协议工具 — 六个专用 respond_* 工具（respond_text、respond_image、respond_buttons、respond_shortcut、respond_html、respond_sequence），加上类型化任务工具（create_once_job、create_cron_job）和类型化工作区工具（create_project、list_projects、delete_project）。在到达设备之前，模式会拒绝格式错误的 URL、按钮语法以及 type/schedule 组合
类型化定制写入器 — create_user_skill 和 create_custom_tool 使用正确的前置元数据构建用户层 markdown，因此加载器始终能解析它们，代理也无需手写这些文件
后台任务 — 使用 cron 表达式或简单间隔的一次性或重复任务
动态技能 — 将快捷指令和行为规则定义为 .md 文件。仅紧凑索引加载到提示中；完整内容通过 load_skill 工具按需获取
自我管理技能 — 代理可以创建、编辑和删除技能定义（写入始终落在用户层）
语义记忆 — 使用嵌入（Ollama、LM Studio 或 OpenAI）的向量搜索。记忆由 LLM 自动分类到 wing/room/hall/status 维度
知识图谱 — 带有自动失效的时间三元组存储。多值关系共存；单值事实自动替换
PARA 方法（含项目结束级联） — 每条记忆都标记了状态（Project、Area、Resource、Archive）。项目结束时，单次 complete_project 调用即可归档其向量、使与其 slug 关联的所有计划三元组失效并记录完成 — 一次调用而非三次
混合召回 — 使用倒数排名融合将 FTS5 关键词搜索与向量语义搜索相结合
长期记忆 — 当语义记忆禁用时，使用 SQLite + FTS5 全文搜索作为回退
带隧道契约的开发服务器管理 — 启动、停止和列出开发服务器。当请求 tunnel: true 时，服务器在启动前和启动后都会强制执行 — 不可达的 localhost 服务器绝不会被悄悄保留运行
自动 URL 清理 — 如果代理在响应中留下 localhost URL，respond_* 工具会将其重写为匹配的隧道 URL，以便您的手机始终能获得可达链接
自定义工具 — 代理可以安装 CLI 工具并将其注册为新功能
版本控制 — 工作区文件的自动 git 版本控制；技能和权限的配置备份
Web 仪表板 — 后台任务的实时概览，可按用户自定义。/dashboard 和 /api/jobs 在设计上是未认证的——请在网络层（Tailscale ACL、防火墙、带基本认证的反向代理）限制访问，或者在不需要时设置 DASHBOARD=false
HTTPS 隧道 — 内置 Tailscale、ngrok 和 Cloudflare Tunnel 支持
系统服务 — 在 macOS、Linux 或 Windows 上安装为持久服务
速率限制 — 可配置阈值的逐令牌请求限制

要求
#

Bun 运行时
LLM 提供商的 API 密钥或 OAuth 凭证
（可选）Tailscale、ngrok 或 cloudflared（用于 HTTPS 隧道）

快速开始
#

git clone https://github.com/pockethook-app/pockethook-agent-server.git
cd pockethook-agent-server
bun install

# 交互式设置 — 选择提供商、模型、认证令牌、端口
bun run setup

# 启动服务器 + HTTPS 隧道
bun run dev:tunnel

设置向导将引导您选择 LLM 提供商、配置认证和设置工具权限。

设置参考

Mon, 09 Mar 2026 00:00:00 +0000

Server Configuration
#

The core connection settings for your PocketHook server.

Server URL
#


Type	Text field (URL)
Default	Empty
Stored in	iOS Keychain

The HTTPS endpoint where PocketHook sends your chat messages. Only HTTPS URLs are accepted — HTTP is rejected for security. This is the primary endpoint your server listens on.

OpenClaw 技能

Wed, 11 Mar 2026 00:00:00 +0000

什么是 OpenClaw 技能？
#

PocketHook 的 OpenClaw 技能让您的 OpenClaw 代理可以在设备上触发 iOS 快捷指令。当您要求 OpenClaw 创建笔记、制作播放列表或运行任何自动化时，代理会在响应中包含标记，PocketHook 会检测并执行这些标记。

早期版本。 此技能可能需要针对您的设置进行额外调整。包含的快捷指令是示例 — 您需要注册自己的快捷指令并调整技能以匹配您使用 PocketHook 的方式。

API 参考

Mon, 09 Mar 2026 00:00:00 +0000

协议概述
#

PocketHook 通过 HTTPS 使用简单的基于 JSON 的协议与您的服务器通信。应用发送 POST 请求并期望 JSON 响应。

认证
#

PocketHook 将配置的认证令牌作为 Bearer 令牌发送：

Siri 与 App Intents

Mon, 09 Mar 2026 00:00:00 +0000

PocketHook 提供六个 App Intents，与 Siri 和 iOS 快捷指令应用集成。您可以用它们构建由语音、时间、位置或其他 iOS 触发器激活的强大自动化。

发送消息
#

Intent：SendMessageIntent

向服务器发送消息，并可选择等待响应。

参数	类型	说明
消息	string	要发送的消息
等待响应	boolean	如果为 true，等待最多 5 分钟

示例：“嘿 Siri，用 PocketHook 发送’检查服务器'”

文档 on PocketHook

设置指南

1. 安装 PocketHook #

2. 配置您的服务器 #

代理服务器

什么是 PocketHook Agent Server？ #

功能 #

要求 #

快速开始 #

设置参考

Server Configuration #

Server URL #

OpenClaw 技能

什么是 OpenClaw 技能？ #

API 参考

协议概述 #

认证 #

Siri 与 App Intents

发送消息 #

1. 安装 PocketHook
#

2. 配置您的服务器
#

什么是 PocketHook Agent Server？
#

功能
#

要求
#

快速开始
#

Server Configuration
#

Server URL
#

什么是 OpenClaw 技能？
#

协议概述
#

认证
#

发送消息
#