设置参考

同步

#

PocketHook 使用你的私人 iCloud 账户，在你的所有设备间同步对话记录和应用设置 — 无需 PocketHook 账户，不涉及任何第三方服务器。

在你的 iPhone、iPad 和 Mac 上登录同一个 iCloud 账户，一切都会自动出现 — 无需任何设置。你的数据保存在你自己的私人 iCloud 数据库中；PocketHook 的服务器永远不会看到它。

服务器配置

#

与你的 PocketHook 服务器连接的核心设置。

服务器 URL

#

PocketHook 发送聊天消息的 HTTPS 端点。仅接受 HTTPS URL——出于安全考虑，HTTP 会被拒绝。这是你的服务器监听的主端点。

认证令牌

#

随每个请求在 Authorization 标头中发送的 Bearer 令牌。你的服务器可以用它验证请求来自你的设备。安全地存储在 iOS Keychain 中——绝不以明文保存。

OpenClaw 兼容

#

如果你的服务器使用 OpenClaw 平台或任何兼容 OpenAI 的 Chat Completions API，请启用此项。启用后，PocketHook 以 OpenAI 聊天格式发送消息，并从响应中解析内联快捷指令标记（[SHORTCUT:name]、[DATA:{...}]、[URL:...]）。请求中会包含 x-openclaw-agent-id 标头。

测试连接

#

向已配置的服务器发送测试请求的按钮。显示：

• 以毫秒计的响应时间
• 健康检查结果（如已启用）
• 连接失败时的错误详情

修改服务器 URL 或认证令牌后，请用它来确认一切正常。

网络

#

针对不同类型的操作微调超时行为。

请求超时

#

PocketHook 等待服务器开始响应请求的时长。如果你的服务器要进行繁重处理（比如调用 AI 模型），请调大此值。对于简单的 Webhook 服务器，默认的 5 秒通常足够。

资源超时

#

整个响应（包括数据传输）完成的最长时间。此值应高于请求超时。如果你的服务器返回大负载或上传速度较慢，请调大。

健康检查

#

启用服务器健康监测。启用后，PocketHook 会在连接测试期间向健康检查 URL 发送 GET 请求，并显示服务器是否报告健康。

健康检查 URL

#

一个返回纯文本 true 或 false 的独立 HTTPS 端点。连接测试期间会访问此 URL，以确认你的服务器正常运行。当你的主 API 端点需要认证、但你只想做一个简单的状态检查时非常有用。

自动化

#

控制 PocketHook 如何执行由服务器响应触发的 iOS 快捷指令。

iOS 快捷指令

#

快捷指令执行的总开关。设为 OFF 时，PocketHook 仍会显示来自服务器的消息，但会忽略响应中的任何 shortcut 字段。适合调试或临时停用自动化。

快捷指令间延迟

#

当服务器在一次响应中返回多个自动化时，连续执行快捷指令之间的等待时间。如果你的快捷指令彼此依赖（例如第一个快捷指令创建的文件由第二个读取），请调大此值。

快捷指令超时

#

PocketHook 等待每个快捷指令完成的最长时间，超过即视为超时。长时间运行的快捷指令（比如处理媒体或进行多次 API 调用的）可能需要完整的 5 分钟。

个人界面

#

将自定义 Web 界面直接嵌入 PocketHook。

个人界面

#

显示一个带内嵌 Web 视图的专用标签页。启用后，主导航中会出现一个新标签页，用于显示你的自定义网页。页面会预加载以便即时显示，并支持下拉刷新。

个人界面 URL

#

在个人界面标签页中显示的 URL。HTTP 和 HTTPS 均可接受（推荐 HTTPS）。它可以是仪表盘、管理面板，或任何你想在聊天旁边快速访问的网页。

链接

#

配置 PocketHook 如何处理来自服务器响应的 URL。

链接标签页

#

显示或隐藏主导航中的链接标签页。启用后，从服务器响应收到的所有 URL 都会被保存，并显示在一个专用标签页中，带有丰富的链接预览、搜索和删除功能。

自动打开 URL

#

启用后，PocketHook 会自动在你的默认浏览器中打开来自服务器响应的 URL。停用后，URL 仍会保存到链接标签页（如已启用），但不会自动打开。

这项设置故意按设备单独设置：你可能希望链接在 iPhone 上自动打开，但在 Mac 上不自动打开。无论这项设置如何，点按消息下方的链接标签始终会打开它。

语言

#

自定义应用和听写语言。

应用语言

#

独立于设备语言来覆盖应用的显示语言。设为"系统默认"时，PocketHook 遵循你的 iOS 语言设置。

听写语言

#

聊天输入中语音听写（语音转文字）使用的语言。可用语言：

后台任务

#

即使应用在后台，也定期检查是否有待处理任务。

后台任务

#

启用后台轮询。启用后，PocketHook 会定期向轮询 URL 发送 GET 请求。如果响应为 true，则在应用打开时向主服务器发送获取消息。需要通知权限才能提醒你有待处理任务。

检查间隔

#

PocketHook 在后台检查轮询 URL 的频率。间隔越短，发现待处理任务越快，但耗电也越多。iOS 可能会根据设备使用模式调整实际频率。

轮询 URL

#

PocketHook 按配置的间隔轮询的 HTTPS 端点。必须返回纯文本 true（有待处理任务）或 false（无任务）。这是一次轻量检查——你的服务器应快速响应，无需繁重处理。

**Agent Server：**使用 https://your-host/jobs（按你的部署调整主机和端口）。

获取消息

#

当后台检查发现待处理任务且应用打开时，发送给主服务器的消息。服务器响应会像其他消息一样出现在聊天中。可自定义此项以触发特定的服务器端行为。

数据管理

#

监控并管理你存储的消息。

已存储消息

#

显示当前存储的消息数量。指示器以颜色区分：

• 绿色 — 低于 70% 容量
• 橙色 — 70–90% 容量
• 红色 — 超过 90% 容量

达到 500 条消息上限后，最旧的消息会被自动删除，为新消息腾出空间。

导出对话

#

通过 iOS 共享表单将所有已存储消息导出为 JSON 文件的按钮。你可以保存文件、用 AirDrop 传送，或分享给任何应用。适合备份对话或分析消息历史。

删除所有消息

#

永久移除所有已存储消息的破坏性按钮。执行前需要确认。此操作无法撤销。

关于

#

关于你的 PocketHook 安装的只读信息。