iMessage Hermes on a Raspberry Pi

1) 必要なハードウェアとアカウントを入手する: Raspberry Pi 4または5（Pi 5推奨、4GB以上のRAM、8GBが快適）、信頼性の高い電源、できればイーサネットを使用します。また、(a) 64ビットOSイメージ（Raspberry Pi OS Lite 64ビット / Ubuntu Server arm64 / Debian arm64）、(b) LLMプロバイダーアカウント（Nous Portal、OpenRouter、Anthropicなど—モデルはリモートで実行され、Piがオーケストレーションします）、(c) 実際の電話番号を介したiMessage/SMS/RCSが必要な場合はClaw MessengerアカウントとAPIキーが必要です。

2) 64ビットのヘッドレスOSをSDカード（またはPi 5のNVMe）に書き込む: Raspberry Pi Imagerで、Piモデルを選択し、Raspberry Pi OS (other)の下にあるRaspberry Pi OS Lite (64-bit)を選択し、Imagerの詳細設定でSSHを有効にし、ホスト名/ユーザー/パスワードを設定します。64ビット（aarch64）は必須です。32ビット（armhf）は動作しません。

3) Piを起動し、IPアドレスを見つける: Piをイーサネットに接続し、電源を入れます。ルーターのDHCPクライアントリスト（設定したホスト名、例：「hermespi」を探す）またはLANのスキャン（例：nmap -sn 192.168.1.0/24）でIPアドレスを見つけます。

4) PiにSSH接続する: コンピューターから：ssh <user>@<pi-ip>（またはmDNSが機能する場合はssh <user>@hermespi.local）。再インストールしてホストキーの警告が表示された場合は、古いキーをクリアします：ssh-keygen -R hermespi.local および/または ssh-keygen -R <pi-ip>、その後再接続します。

5) (推奨) PiのIPを安定させる: ベストプラクティスは、ルーターでDHCP予約を行うことです（PiのMACを固定IPにピン留めする）。これにより、再起動後も常時稼働のエージェントにアクセスできるようになります。

6) PiにHermes Agentをインストールする（公式curlインストーラー）: ワンコマンドインストーラーを実行します（sudoは不要）：curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash。これにより、uv（Pythonマネージャー）を使用してHermesがセットアップされ、Python 3.11がインストールされ、Hermesがクローンされ、~/.hermes/の下にuv管理の仮想環境が作成されます。

7) Hermesを起動し、ベースエージェントがローカルで動作することを確認する: Hermes CLIを使用して、実行され、チャットできることを確認します。最小限のアプローチに従っている場合は、メッセージングゲートウェイを追加する前に、まずCLIチャットが機能することを確認してください。（正確なCLIコマンドはHermesのバージョンによって異なります。目標は、エージェントが実行され、プロンプトを送信でき、応答が返されることです。）

8) LLMプロバイダーを選択して設定する: Pi上のHermesは通常、ホスト型LLMプロバイダー（Nous Portal/OpenRouter/Anthropicなど）を使用します。Hermesの設定でプロバイダーを設定します（通常、Hermes設定コマンドを使用するか、セットアップに応じて~/.hermes/config.yamlおよび/または~/.hermes/.envを編集します）。選択したプロバイダーを使用してエージェントが応答できることを確認します。

9) iMessage統合プラグインをHermes venvにインストールする: uv管理のHermes仮想環境にHermes iMessageプラグインをインストールします（システムpipは使用しないでください）：uv pip install --python ~/.hermes/hermes-agent/venv hermes-imessage。これは最も一般的な失敗点です。間違ったPython環境にインストールすると、Hermesがプラグインをロードできません。

10) Hermes設定でiMessage/Claw Messengerプラットフォームを有効にする: ~/.hermes/config.yamlを編集して、Claw MessengerプラットフォームとiMessageプラグインを有効にします（既存の設定を上書きするのではなく、マージするようにしてください）。claw_messengerプラットフォームが有効になっており、そのプラグインリストにimessageが含まれていること、および必要に応じてプラットフォームツールセットのマッピングにClaw Messengerツールセットが含まれていることを確認してください。

11) Claw Messenger APIキーをHermes環境に追加する: Claw MessengerダッシュボードからAPIキーを取得し、Hermesのenvファイルに追加します：echo 'CLAW_MESSENGER_API_KEY=cm_live_…' >> ~/.hermes/.env。env/configを変更した後、Hermesを再起動してプラグインと資格情報を再ロードします。

12) HermesでClaw Messengerツールセットを有効にする（必要に応じてグループを作成できるようにするため）: Claw MessengerツールをHermesに公開するツールセットを有効にします：hermes tools enable hermes-claw-messenger。次に、設定がそのツールセットをclaw_messengerプラットフォームにマッピングしていることを確認します（platform_toolsets: claw_messenger: - hermes-claw-messenger）。

13) Hermesゲートウェイを起動し、メッセージングチャネルを接続する: Hermesのゲートウェイセットアップ/ランナーを実行して、設定されたプラットフォームを通じてメッセージを受信および送信できるようにします。Hermes UI（またはゲートウェイセットアップフロー）で、Claw Messengerチャネルを接続/有効にし、UIがサポートしている場合は許可されたユーザーを制限します（推奨）。

14) Hermesが使用すべきiMessage/SMSスレッドを作成または特定する: 新しいグループのchat_idを取得するには、2つ以上のE.164電話番号を含む新しいiMessage/RCS/SMSグループを作成し、最初のメッセージを送信します。統合は、その後の送信のためにchat_idを返します。アウトバウンドDMおよび既存のグループへの返信の場合、Hermesは通常、グループ作成ツールを必要とせずに通常のメッセージングフローを通じてルーティングできます。

15) 自分の電話番号からテストメッセージを送信し、Hermesが返信することを確認する: エージェントに簡単なメッセージ（例：「ping」または「今日のカレンダーに何がある？」）を送信します。(a) 受信メッセージがHermesに届くこと、(b) Hermesが応答を生成すること、(c) 応答が同じiMessage/SMSスレッドに配信されることを確認します。

16) 常時稼働で再起動に安全にする: Hermesをバックグラウンドサービス/デーモンとして実行します（またはDockerルートを選択した場合は--restart unless-stopped付きのDockerを使用します）。再起動後も動作し、ゲートウェイが自動的に起動することを確認します。

17) (オプション) キッチン/冷蔵庫にダッシュボード画面を追加する: Piを常時稼働のエージェントとして使用し、別の常時稼働の画面/タブレットを取り付けて「ライフダッシュボード」（カレンダー、天気、食事計画、ダイジェスト）を表示します。その後、Hermesにテキストメッセージを送信して更新します（「金曜日の7時にキム家と夕食」、「発表会はいつ？」）と、エージェントがダッシュボードを最新の状態に保ちます。

18) (オプション) cronで日次ワークフローを自動化する: 定期的なタスク（例：毎朝のダイジェスト）のためにHermes cronジョブを設定します。hermes cron runがゲートウェイとは別に実行される場合、iMessageプラグインはワンショットのWebSocket接続を開いてアウトバウンドメッセージを配信し、その後閉じることができます。

19) 一般的なiMessageプラグインの問題をトラブルシューティングする: iMessageが機能しない場合：(a) hermes-imessageがHermes venvにインストールされていることを確認します：uv pip list --python ~/.hermes/hermes-agent/venv | grep hermes-imessage；(b) ~/.hermes/config.yamlに正しいプラグインの有効化とplatform_toolsetsマッピングが含まれていることを確認します；(c) ~/.hermes/.envに有効なCLAW_MESSENGER_API_KEYが含まれていることを確認します；(d) 変更後にHermes/ゲートウェイを再起動します；(e) 必要に応じて、正確な失敗コマンド、最初のエラーブロック、uv pip list出力、および関連する（編集済みの）設定セクション（plugins、platform_toolsets、gateway.platforms.claw_messenger.plugins）を提供してサポートを依頼します。

20) カスタムスキルとコミュニティの例でエージェントを拡張する: 基盤を構築します：家族カレンダー管理、食事計画+買い物リスト、承認ループ付きのAirbnbゲストメッセージング、結婚式計画ダッシュボードなど。公式のハウツーページにリンクされているコミュニティDiscordで他の人と共有し、学びましょう。