セットアップガイド

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アシスタントに変えます。レスポンスロジックを自分で書く代わりに、LLM（Claude、GPT、Geminiなど）を接続してメッセージを処理し、ツールを呼び出し、構造化されたPocketHookレスポンス（ショートカットトリガーを含む）を返します。

サーバーはあなた自身のマシンで動作します。データはあなたの手元にあります。

これは出発点です。 サーバーには基本的なツールセットが含まれており、あなたが拡張できるように設計されています。メール、カレンダー、ドキュメント、APIなど、独自のインテグレーションを追加して、あなたのものにしましょう。

機能
#

マルチプロバイダーLLM — Anthropic、OpenAI、GitHub Copilot、Google、Mistral、Groq、xAI、OpenRouter、Ollama（ローカル）、LM Studio（ローカル）
OAuth認証 — GitHub CopilotとOpenAI Codex（デバイスコード/ブラウザフロー経由）
エージェントツール — シェルコマンド、ファイル読み書き、ディレクトリ一覧、Web検索、Webスクレイピング、開発サーバー管理
フレームワーク/ユーザー分離 — フレームワークファイル（skills/、custom-tools/、config/）は読み取り専用のまま。あなたのカスタマイズはdata/user/配下（スキル、カスタムツール、インストラクション、型付きprefs）に配置。フレームワーク更新はあなたの作業を上書きせずにクリーンに適用
型付きユーザーprefs — お好みの地図アプリやトンネルドメインなどの値をdata/user/prefs.jsonに保存。スキル内で{{prefs.key}}として参照すると、サーバーが読み込み時に置換
プログラミングタスクを1回の呼び出しで — run_code_jobメタツールが prompt タイプのバックグラウンドジョブ（あなたが構成したLLMで実行）を作成し、ユーザーへの受領通知を1ステップで送信。エラーの起きやすい「respond + create-job」パターンを置き換え
型付きプロトコルツール — 6つの専用 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を正しいfrontmatter付きで構築。ローダーが常にパースでき、エージェントがこれらのファイルを手書きすることはありません
バックグラウンドジョブ — cron式またはシンプルな間隔による一回限りまたは繰り返しタスク
ダイナミックスキル — ショートカットや動作ルールを.mdファイルで定義。コンパクトなインデックスのみがプロンプトに読み込まれ、完全な内容はload_skillツールでオンデマンドに取得
自己管理スキル — エージェントがスキル定義を作成、編集、削除可能（書き込みは常にユーザーレイヤーに配置）
セマンティックメモリ — エンベディング（Ollama、LM Studio、またはOpenAI）によるベクトルベース検索。メモリはLLMによってwing/room/hall/statusの4次元に自動分類
知識グラフ — 自動無効化機能付きの時間的トリプルストア。複数値リレーションシップは共存し、単一値ファクトは自動置換
PARAメソッド（プロジェクト終了時のカスケード付き） — すべてのメモリにステータス（Project、Area、Resource、Archive）がタグ付け。プロジェクト終了時は1回のcomplete_project呼び出しで、そのベクトルをアーカイブし、そのスラッグに紐づく全ての計画トリプルを無効化し、完了を記録 — 3回ではなく1回の呼び出しで完結
ハイブリッドリコール — FTS5キーワード検索とベクトルセマンティック検索を相互ランク融合で組み合わせ
長期記憶 — セマンティックメモリが無効な場合のフォールバックとして、SQLite + FTS5全文検索
トンネル契約付き開発サーバー管理 — 開発サーバーの起動、停止、一覧表示。tunnel: trueが要求された場合、サーバーは起動前と起動後の両方でそれを強制 — 到達不能なlocalhostサーバーが静かに放置されることはありません
自動URLサニタイズ — エージェントが応答にlocalhost URLを残した場合、respond_*ツールが対応するトンネルURLに書き換えるため、お手持ちの電話は常に到達可能なリンクを受け取ります
カスタムツール — エージェントがCLIツールをインストールし、新しい機能として登録可能
バージョニング — ワークスペースファイルの自動gitバージョニング。スキルとパーミッションの設定バックアップ
Webダッシュボード — バックグラウンドジョブのライブ概要。ユーザーごとにカスタマイズ可能。/dashboard と /api/jobs は設計上認証なし — ネットワーク層でアクセスを制限してください（Tailscale ACL、ファイアウォール、basic auth付きリバースプロキシ）。不要な場合は 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スキルとは？
#

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と通信します。

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は、SiriおよびiOSショートカットアプリと連携する6つのApp Intentsを提供します。音声、時刻、場所、その他のiOSトリガーで起動する強力な自動化を構築できます。

メッセージを送信
#

Intent: SendMessageIntent

サーバーにメッセージを送信し、オプションで応答を待ちます。

パラメーター	型	説明
メッセージ	string	送信するメッセージ
応答を待つ	boolean	trueの場合、最大5分間待機

例: “Hey 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スキルとは？
#

仕組み
#

プロトコル概要
#

認証
#

メッセージを送信
#