
スマホから自分のJarvisに頼む|Hermes AgentとSlackをつなぐ
どうもTORAです。
前回のnoteでは、MacにHermes Desktopを入れて、AIのモデルをつなぎ、最初の会話をするところまで書きました(元になったブログ記事もあります)。ただ、あの状態だとJarvisと話せるのはMacの前に座っているときだけです。
今回は、SlackからJarvisに話しかけられるようにします。Slackにつながると、スマホのSlackアプリから文字で頼んで、返事もSlackで受け取れます。僕もいまはSlackを窓口にして、自分のJarvisを使っています。
前回と違って、今回はターミナルでコマンドを打つ場面がいくつかあります。上から順番に進められるように書いていきます。
どういう仕組みでつながるか
Hermes AgentはSlackとSocket Modeという方式でつながります。外のサービスから自宅のPCへ連絡を届けるには、普通はPCを外から見える状態にしたり、ルーターの設定を開けたりする必要があります。Socket Modeでは、Mac側からSlackへ接続しにいって、その接続を通してメッセージを受け取ります。なので、ルーターのポート開放や公開URLの用意はいりません(Slack公式のSocket Modeの説明)。
この接続を受け持つのが、HermesのGatewayという仕組みです。流れはこうなります。
スマホやPCのSlackで、Jarvisあてにメッセージを送る
自宅MacのGatewayがそれを受け取って、Hermesに渡す
Hermesが返事を作って、Slackに返す
つまり、Macの電源が入っていて、ネットにつながっていて、Gatewayが動いていることが前提です。Macがスリープしていたり電源が落ちていたりすると、メッセージを送ってもすぐには返事が来ません。
始める前に確認すること
ターミナルを開いて、次のコマンドを打ってみてください。
hermes --help
使い方の一覧が出れば準備はできています。command not found と出た場合は、ターミナルからhermesコマンドを使える状態になっていません。Desktop版を入れただけだと、この状態のこともあります。そのときは別の方法でインストールを重ねる前に、Hermes Agentの公式インストール案内を見て、今の環境でCLIを使えるようにする方法を確認してください。この記事は、hermesコマンドがターミナルで動く状態を前提にしています。CLIを新しく入れた場合は、公式案内に沿って hermes model または hermes setup でモデルの接続設定も済ませてから進んでください。
Slackのワークスペースは、自分ひとりで使う個人用のものを用意してください。会社や仕事で使っているワークスペースにはJarvisを入れないでください。仕事の会話が流れている場所に、自分のAIへの入口を置くことになってしまいます。
それから、この記事は新しくSlackアプリを作る人向けです。以前にHermes用のSlackアプリを作ったことがある人は、そのアプリの設定をこの手順で上書きしないでください。このあと出てくる「Agent view」という形式は、一度切り替えると元の形式に戻せません(Hermes公式のSlack手順)。
確認した範囲についても書いておきます。僕の環境ではすでにGatewayが動いていて、Slackから使えています。ただ、新しいアプリを作るところからこの記事の手順を通しでやり直したわけではありません。内容はHermesの公式ドキュメントと、現在のhermesコマンドのヘルプ表示に基づいています。Slackの画面の文言や配置は変わることがあるので、少し違って見えたら近い名前の項目を探してみてください。
1. Slackアプリの設計図を作る
Slackのアプリは、必要な権限や受け取るイベントをまとめた「マニフェスト」というファイルから作れます(Slackのマニフェストの説明)。Hermesにはこれを自動で作るコマンドがあるので、それを使います。
hermes slack manifest --agent-view --name "Jarvis" --write
--agent-view は、新しく作るSlackアプリ向けに公式で指定されている「Agent view」形式で作るためのオプションです。--name "Jarvis" はアプリの名前なので、好きな名前に変えてかまいません。この記事ではJarvisにしています。
実行すると、次の場所にファイルができます。
~/.hermes/slack-manifest.json
次のコマンドで、テキストエディットに中身を表示できます。
open -e ~/.hermes/slack-manifest.json
2. Slackでアプリを作る
ブラウザでSlackのアプリ管理ページを開いて、Create New App から From an app manifest を選びます。

①のCreate New Appを押すところから始めます。
アプリを入れるワークスペースを選ぶ(さっき用意した個人用のもの)
テキストエディットで開いたJSONの中身を全部コピーして貼り付ける
内容を確認して Next、続けて Create を押す
途中で、このアプリが求める権限の一覧が表示されます。チャンネルのメッセージを読む権限、DMを読む権限、ファイルを読み書きする権限などが並んでいるはずです。ここは読み飛ばさずに目を通してください。何をJarvisに許すかを決めるのは自分です。
マニフェストから作ると、Socket Modeもオンの状態でアプリができます。ただ、接続に使う鍵はこの時点ではまだないので、次で作ります。
3. 接続用の鍵を作る(xapp-)
アプリの設定画面で Basic Information を開いて、下のほうにある App-Level Tokens までスクロールします。

このあと開くBasic Information、Install App、App Homeの場所です。①〜③は画面内の場所を示す番号で、本文の見出しの番号とは別です。
トークンを作るボタン(Generate Token and Scopes)を押す
名前を付ける(hermes-socket など、何でもかまいません)
スコープに connections:write を追加する
Generate を押す
xapp- で始まる文字列が表示されます。これがSocket Modeで接続するためのApp-Level Tokenです。入力するのは、7のターミナル設定(hermes gateway setup)です。Hermes DesktopのJarvisとの会話欄には貼り付けません。
4. メッセージタブを確認する
App Home を開いて、Show Tabs のところを見ます。Messages Tab がオンになっていて、「Allow users to send Slash commands and messages from the messages tab」にチェックが入っているかを確認してください。マニフェストで設定されているはずですが、ここがオフだと、JarvisにDMを送ろうとしたときに送信できない旨の表示が出て、メッセージを送れません。
5. ワークスペースにインストールする(xoxb-)
Install App を開いて、Install to Workspace を押します。許可を求める画面が出るので、さっき目を通した権限と同じ内容かを確認してから Allow を押します。
インストールが終わると、xoxb- で始まる Bot User OAuth Token が表示されます。これも7のターミナル設定(hermes gateway setup)で入力します。

インストール済みのアプリでは、Install App のこの欄でボットトークンを確認できます。トークン値は伏せています。
xapp- はSocket Modeの接続用、xoxb- はボットがメッセージを送るなどの操作をするための鍵です(Slack公式のトークンの説明)。Hermes DesktopのJarvisとの会話欄を含め、AIチャット、noteやSNS、スクリーンショット、Gitのリポジトリには貼らないでください。メモや自分宛てのチャットへ控えず、設定を入力するときにSlackのアプリ管理画面からコピーします。漏らしてしまった場合は、そのトークンの使用を止め、失効と再発行の対応が必要です。App-Level Tokenの管理場所は Basic Information → App-Level Tokens です。ボットトークンの失効・再発行の詳しい操作は、この記事では扱いません。新しいトークンを用意した後はHermes側にも設定し直し、Gatewayを再起動します。
6. 自分のMember IDを調べる
Jarvisに話しかけていい人を、自分だけに絞るための準備です。HermesはSlackの表示名ではなく、Member IDという識別番号で相手を見分けます。
Slackで自分の名前かアイコンをクリックして、プロフィール全体を表示(View full profile)を開きます。⋮(その他)のメニューから、メンバーIDをコピー(Copy member ID)を選ぶと、U から始まる英数字の文字列がコピーされます。
7. Hermesに設定する
ターミナルに戻って、対話式の設定を始めます。
hermes gateway setup
使うサービスを聞かれたらSlackを選んで、聞かれた項目にBot Token(xoxb-)、App Token(xapp-)、自分のMember IDを入力していきます。
許可するユーザーには、自分のMember IDだけを入れてください。誰でも許可する設定にすると、そのワークスペースにいる人なら誰でも、あなたのMacで動いているJarvisに指示を出せてしまいます。
対話式の設定ではなく、ファイルに直接書く方法もあります。保存先は次のファイルです。
~/.hermes/.env
既存の行は消さず、以下の3項目だけを追加します。同じキーがすでにある場合は、その行の値を更新してください。サンプルの = の右側を、コピーしたトークン全体か自分のMember IDに置き換えます。
SLACK_BOT_TOKEN=ここをボットトークン全体に置き換える
SLACK_APP_TOKEN=ここをアプリレベルトークン全体に置き換える
SLACK_ALLOWED_USERS=ここを自分のMember IDに置き換える
トークンは .env か対話式の設定に入れて、config.yaml には書かないでください。また、この記事はHermesの標準の設定(default)で使っている前提です。profileを切り替えて使っている人は、保存先が変わります。
8. Gatewayを起動する
先に、Gatewayがすでに動いていないかを確認します。
hermes gateway status
ユーザーサービスとしてすでに動いている場合は、設定を読み直すために再起動して、状態を確認します。進行中の会話があれば、応答が終わってから行ってください。
hermes gateway restart
hermes gateway status
その場合、次の run は実行しません。別のターミナルで前面起動している場合は、そちらを Control + C で止めてから起動し直します。Gatewayを二重に動かさないようにしてください。
動いていなければ、まずはターミナルの前面で起動します。
hermes gateway run
このターミナルを開いている間だけGatewayが動きます。止めたいときは Control + C を押すか、ターミナルを閉じます。最初はこの形で試して、つながることを確かめてから、あとで書く常駐の設定に進むのが分かりやすいと思います。
9. 最初に話しかけてみる
話しかけ方はDMとチャンネルの2通りあります。
DMで話す場合は、Slackのサイドバーのアプリ欄からJarvisを開いて、メッセージタブに書き込みます。DMでは、メンションを付けなくても全部のメッセージに返事をします。
チャンネルで話す場合は、まずJarvisをそのチャンネルに招待します。ボットは自分からチャンネルに入らないので、使いたいチャンネルごとに招待が必要です。@ の後ろは、実際にSlackに表示されているボットの名前にしてください。
/invite @Jarvis
チャンネルでは、メンションを付けたメッセージにだけ反応します。
例えば、最初はこういう害のない頼みごとがいいと思います。
@Jarvis 日本語で短く自己紹介してください
返事は、そのメッセージにつながるスレッドに返ってきます。続けて、同じスレッドの中でこう頼んでみます。
さっきの自己紹介を1文に縮めてください
スレッドの中で一度会話が始まると、そのスレッドではメンションなしで返事が来るようになります。スレッドの外に書いたメンションなしのメッセージは無視されます。
ここで話した内容が、別のチャンネルや別のスレッドにそのまま引き継がれるわけではありません。前の話の続きを頼みたいときは、同じスレッドで続けるのが基本です。
最初の試しでは、何かを止める、権限を変える、ファイルを消す、どこかに投稿する、といった操作は頼まないでください。まずは、メッセージと返事が往復することだけを確認します。
ここまでできたら、スマホのSlackアプリで同じワークスペースを開いて、同じようにJarvisに送ってみてください。Mac側でGatewayが動いていれば、Macの前にいなくても返事が来ます。
ターミナルを閉じても動かしておきたいとき
hermes gateway run はターミナルを閉じると止まります。いつでもスマホから頼めるようにしたいなら、Gatewayをユーザーサービスとして登録して、裏で動かしておけます。
hermes gateway install
hermes gateway start
hermes gateway status
install でユーザーサービスとして登録して、start で起動、status で動いているかを確認します。前面で起動したGatewayがまだ残っているなら、先に Control + C で止めてから進めてください。
常駐させていても、Macがスリープしたり電源が切れたりすれば返事は来ません。外出先から使いたいなら、Macがスリープしない設定になっているかも見ておいてください。
つないだあとに気をつけること
Slackに書いた内容はSlackに残ります。JarvisがクラウドのAIモデルを使っているなら、頼んだ内容はそのAIの提供元にも送られます。仕事の資料や顧客の情報のような、外に出してはいけないものはここに書かないほうがいいです。
お金の面では、Slack経由にしたからといってAIを無制限に使えるようになるわけではありません。AIの利用は、これまでどおり自分が契約しているモデルの料金や上限の範囲で動きます。Slack側のプランの条件は、使っているワークスペースで確認してください。
つながらないときに見るところ
DMでは返事が来るのにチャンネルでは反応しない場合は、まずJarvisをそのチャンネルに招待したか、メンションを付けたかを確認してください。それでも駄目なら、アプリ設定の Event Subscriptions に message.channels(公開チャンネル用)や message.groups(非公開チャンネル用)が入っているかを見ます。
DMを送ろうとして送信できない旨の表示が出る場合は、4で見た App Home の Messages Tab の設定を確認します。権限やイベントの設定をあとから変えたときは、Install App からアプリを入れ直さないと変更が反映されません。
何を送っても反応がないときは、ターミナルでGatewayが動いているか、hermes gateway status で見てみてください。Macがスリープしていないかも確認しておくといいです。
#生成AI #AIエージェント #Slack #HermesAgent #Jarvis #AI活用