Kiro CrewをSlackから使ってみました
自作のAIエージェント管理ツール Kiro Crew をSlackと連携させ、Slackのメッセージから定期実行ジョブ(cron)を登録・管理するところまでを一通りやってみました。
- Slack専用ワークスペースを用意
- Slackアプリ(Socket Modeボット)を作成
- トークンをKiro Crewに登録して接続
- Slackから
cron listなどのコマンドで定期実行を設定
「PCの前にいなくても、Slackからひとことで定期タスクを仕込める」状態がゴールです。
前提:Kiro Crew はローカルのマシン上で動いており、ダッシュボード(Web UI)にアクセスできる状態とします。
※ Kiro Crew のインストールや初期セットアップ手順については、以下の関連記事をご参照ください。
こんな感じでSlack上でKiro-CLIにお願いができます。
Kiro CrewをSlackから使う全体像
Kiro CrewにはSlack連携のためのメニューが用意されているので簡単に行えます。
やり方としては
- SlackでKiro Crewとの連携に必要な情報を設定
- Kiro Crewの設定画面で設定
- SlackからKiro Crewにコマンドを投げて確認
するだけでOKです。
結構簡単でシンプルです。
ちなみにKiro CrewとSlackを連携させるのに必要な情報は以下の3つ。
記事の後ろのほうで取得の仕方を共有します。
| 登録するもの | 形式 | 役割 |
|---|---|---|
| App-Level Token | xapp-... |
Socket Mode接続用 |
| Bot Token | xoxb-... |
ボットとしての発言・読み取り用 |
| Owner User ID | U... |
操作を許可する所有者(あなた)のID |
セキュリティ上の注意:Kiro CrewのSlack連携は 所有者(KIROCREW_OWNER_ID)専用です。他ユーザーの追加はセキュリティのため無効化されています(許可ユーザーは所有者の権限で動いてしまうため)。個人用途向けの設計です。
STEP 1. Slackワークスペースを用意
まずはSlackでの作業です。
最初にKiro Crewと連携する専用のSlackワークスペースを新規作成しました(既存のワークスペースでもOK)。
新規で作ったのはまっさらな状態で使いたかったからです。
以下の画面から新しいワークスペースを作りました。
メールアドレスがあれば作れます。
STEP 2. Slackアプリを作成する
次にSlackでKiro CLIを使うためのアプリを作ります。
ダッシュボードのワンクリック作成リンクを使う(推奨)
ありがたいのがKiro Crewには簡単に設定できる機能が付いていること。
Kiro Crewダッシュボードの Settings → Channels タブ → Slack(URL: /settings?tab=channels&channel=slack)を開きます。
そうすると必要な権限とイベント購読があらかじめ入った マニフェスト付きのワンクリック作成リンクがあります。
「Slack アプリを作成」をクリックします。
クリックするとSlackの「Create an app from a manifest」画面が開くので画面を下にスクロール。
選択する欄が出てくるので、Step1で作ったワークスペースを選択して「Next」をクリックします。
アプリのレビュー画面になるので確認して「Create」を押しましょう。
作成がうまくいくとSlack上の作ったアプリの基本情報が表示されます。
この後の設定で使うので画面は開いたままにしておきます。
STEP 3. App-Level Token(xapp-)を取得
Socket Mode で通信するための App-Level Token を発行します。
発行は以下の流れです。
- 作成したアプリの左メニュー Basic Information を開く
- 下部にある App-Level Tokens → Generate Token and Scopes をクリック
- 名前は任意(例:
kiro)、スコープにconnections:writeを追加 → Generate - 表示された
xapp-...をコピーして控える
App-Level Token(xapp-)は生成直後の画面でしか確認できません。閉じる前に必ず安全な場所にコピーしてください。
App-Level Tokens → Generate Token and Scopes をクリック
BasicInformationボタンを押して、 App-Level Tokens → Generate Token and Scopesをクリックします。
設定画面になるので、名前と権限を入れていきます。
名前は任意でOK。
スコープに connections:write を追加したら、 Generateを押します。
Tokenが表示されるのでコピーしておきます。
App-Level Token(xapp-)は生成直後の画面でしか確認できません。閉じる前に必ず安全な場所にコピーしてください。
STEP 4. アプリをインストールして Bot Token(xoxb-)を取得
アプリをワークスペースにインストールし、ボット動作用のトークンを取得します。
流れは以下な感じです。
SlackAPIの設定画面で
- 左メニュー Install App(または OAuth & Permissions)を開く
- Install to Workspace ボタンをクリックしてワークスペースにインストール
- インストール後に表示される Bot User OAuth Token(
xoxb-...) をコピーして控える
左メニュー Install App(または OAuth & Permissions)をクリック
Install to Workspace ボタンをクリックしてワークスペースにインストールしていきます。
許可画面が出るので、作ったWorkSpaceを選択して「許可する」をクリックします。
Bot Token(xoxb-)をコピーしておきます。
上のほうはコピーしなくて大丈夫です。
STEP 5. 自分のSlackユーザーIDを確認
最後に自分のSlackユーザIDを確認します。
Slack本体(api.slackではなく通常のSlackアプリ)で、自分のアイコン → プロフィール → 「⋯(その他)」 → メンバーIDをコピー。
U で始まる文字列が KIROCREW_OWNER_ID になります。
Slack画面の左下のアイコンをクリックして「プロフィール」を選択します。
三点リーダーをクリックして「メンバーIDをコピー」をクリックします。
U~でメンバーIDがペーストできれいればOkです。
STEP 6. Kiro Crew にトークンを登録
ここからはKiro Crewでの設定です。
ダッシュボードの Slack設定画面(/settings?tab=channels&channel=slack)のトークン入力欄に、集めた3つを入力して保存します。
-
SLACK_APP_TOKEN=xapp-... -
SLACK_BOT_TOKEN=xoxb-... -
KIROCREW_OWNER_ID=U...
保存時にSlackに対して即時検証(auth.test)が実行され、無効なトークンは弾かれます。
Kiro Crewの設定→チャネル→Slackを選択します。
Botトークンとアプリトークン、IDとアクセスの所有者SlackメンバーIDにユーザIDを入力します。
これで設定は完了です!
各種トークンを保存すると Kiro Crewの再起動が必要です(画面が案内してくれます)。これらは内部的に ~/.kiro/crew/.env に安全に保存されます。
STEP 7. 接続テスト
接続テストはSlackからやってみます。
再起動後、チャンネルにボットを招待してメンションするか、SlackでボットにDMを送ります。
チャンネルに「Kirobot」を招待します。
後は「@」をつけてメンション、Pingと打ったら「pong」と返ってきました。
また、チャンネルごとに反応モードを変えるのもOKでした。
| モード | 挙動 |
|---|---|
always |
すべてのメッセージに反応(DMの既定) |
mention |
@メンション時のみ反応(グループの既定) |
observe |
記録のみ、メンション時だけ反応 |
off |
無視 |
設定を変更する場合は、!channel always のように送信します。
STEP 8 かんたんなSlackの使い方(話しかけ方)
つながったら、あとは Slackで普通に日本語を送るだけです。
ここでは最初につまずきやすい「どこに・どう話しかけるか」をまとめます。
(1)DMで話しかける(いちばん簡単)
一番簡単な使い方はDMですね。
- Slack左の ダイレクトメッセージ の横の +、または検索窓に Bot名(アプリ名) を入力
- 候補に出る Botアプリ(アイコンに「App」表示)を選ぶ
- 開いたチャットに、普通のメッセージと同じように送る
DMに送るとDMでは すべてのメッセージに反応します(メンション不要)。
lKiro CLIでできることは何でもできます。
便利なのはファイルを渡すこと。
コマンドラインだとインプットファイルのパスを与える必要がありますが、Slack経由ならファイルをアップロードするだけでOKです。
逆にファイルをKiroに作ってもらって、Slack経由で送ってもらうこともできます。
作ったドキュメントをSlackにアップロードしてといったら
しっかりとSlackに挙げてくれました。
(2)チャンネルで話しかける
チャンネルでは @メンションした時だけ反応します。
- Botをチャンネルに招待(チャンネル名クリック → インテグレーション → アプリを追加、または
/invite @Bot名) - メッセージ欄で 半角
@を打ち、候補から Bot名を選んで話しかける(手打ちのテキストではメンション扱いになりません)
@つきでメンションすれば、反応してくれます。
@Bot名 stgのセキュリティグループを一覧化して。プロファイル default。
一度返信が来たら、同じスレッド内なら @なしで続けて会話できます。
(3)Kiro CrewとSlack|覚えておくと便利なコマンド
最後に覚えておくと便利なコマンドをいくつか紹介します。
! 付きはオーナー向けの操作コマンドです。
| 打つ内容 | できること |
|---|---|
ping |
疎通確認(pong 🦞 が返る) |
status |
稼働状況(セッション数・cron数など)を表示 |
cron list |
登録済みの定期実行ジョブ一覧 |
!channel always |
このチャンネルで全メッセージに反応させる |
!yolo on / !yolo off
|
ツール実行の自動承認を切替(AWS CLI実行の承認ボタンを省略) |
!dashboard |
ダッシュボードへのログインリンクをDMで受け取る |
!stop |
実行中の処理を緊急停止 |
(4)頼み方の例(そのまま送ってOK)
stgアカウントのセキュリティグループを一覧にして。プロファイル default、リージョン ap-northeast-1。
Lambda関数の一覧と、それぞれのランタイムを表にして。
S3バケットを一覧化して。名前とリージョンだけでいい。
AWSの調査を頼むと、Kiro Crew はあなたのPC上の認証情報でAWS CLIを実行します。実行前に Approve / Reject ボタンが出るので(120秒で自動却下)、押すと実行されます。毎回の承認が面倒なら、そのスレッドで !yolo on を送ると自動承認になります。
Slack経由で実行できるのは describe / list / get などの 読み取り専用コマンドです。削除・停止・変更系(delete / terminate / stop など)はブロックされます。
STEP 9. Slackからスケジュール実行(cron)を設定してみた
どうせならとSlackからスケジュール実行(cron)を設定してみました。
これもすこぶる簡単でびっくりしました!
Slackから 自然言語で 定期実行を頼めます。
Slack上で
毎朝9時にチケットの状況をまとめて教えて
30分ごとにパイプラインの健全性をチェックして
と頼めばOOKです。
Kiro Crew が内部で cron ジョブを登録してくれます。
しかも、登録済みジョブはSlackから直接管理できます。
スケジュール一覧の表示や停止とか再開も以下のコマンドで確が可能です。
cron list # 一覧
cron pause <id> # 一時停止
cron resume <id> # 再開
cron remove <id> # 削除
スケジュールの指定方法はCron式でもOKです
指定方法では自然言語でも行けますが、Cron式でもいけます。
以下の書式をチャットに投げればOK。
| 種類 | 例 | 意味 |
|---|---|---|
| 間隔 | every 300 |
300秒ごと(最小60秒) |
| 一回だけ | at 2026-03-24T09:00:00 |
指定時刻に1回 |
| cron式 | cron 0 9 * * 1-5 |
平日9時 |
Kiro CrewのCron動作の仕組み
- スケジュール時刻にタイマー発火
- Kiro Crew がジョブ用の新しいセッションを作成
- エージェントがプロンプトを実行(ツール利用可)
- 結果が SlackのDMとダッシュボードに投稿される
- セッションは片付けられる
各ジョブは独立して動き、5分のタイムアウトがあります。
大量ユーザーのジョブが同時発火しないよう、少しランダムな遅延(ジッター)が入ります。正確な時刻が必要なら strict_schedule で無効化できます。
つないでみた所感
Kiro CrewをSlackにつないで触ってみましたが、率直に便利でした。
設定もKiro Crewがワンクリックに近い形の仕組みを用意してくれていたので迷うこともなし。
- Slackアプリ作成の権限まわりは、ダッシュボードのワンクリック(マニフェスト)作成を使うと圧倒的にラク
- つないでしまえば、Slackにひとこと送るだけで定期タスクが仕込めるのが快適
- 実行結果もSlackに返ってくるので、PCの前にいなくても運用状況が追える
ので、「監視・定期通知系のタスクをSlack起点で回す」用途にちょうどよい構成でした。
まとめ
以上、Slackと連携して、チャットからKiro-cliを動かしてみた実録と連携方法の紹介でした!
使い方は、
- Slackアプリ(Socket Mode)を作る
-
xapp-/xoxb-/U...(自分のID)を集める - Kiro Crewに登録して再起動
- Slackから自然言語 or
cronコマンドで定期実行を設定
と本当にシンプル
それでいて誰でも知っている?SlackからKiroを誰でも使えるのは素晴らしなと思います。
ぜひKiroを使っている方は、Kiro CrewとSlack連携もやってみてください!
関連記事
-
Kiro CrewをAmazon WorkSpaces(Linux版)にインストールしてみた
- WorkSpaces(Ubuntu環境)へ Kiro Crew を導入・初期セットアップした際の手順をまとめています。前提となる環境構築から始めたい方はあわせてご覧ください。




























