前提条件
- 管理者権限を持つSlackワークスペース
- LemonClawインスタンス:
- ホスト型: Clawインスタンスを作成する
- セルフホスト型: LemonClawをインストールする
セットアップガイド
Slackアプリを作成する
- Slack APIにアクセスし、Create New Appをクリックします
- From scratchを選択します
- アプリ名（例：「AI Assistant」）を入力し、ワークスペースを選択します
- Create Appをクリックします
Socket Modeを有効にする
- 左側のサイドバーでSocket Modeに移動します
- Enable Socket ModeをONに切り替えます
- トークンに名前（例：「claw-socket」）を付け、Generateをクリックします
- App-Level Token（
xapp-で始まるもの）をコピーします。これは後で必要になります
Botの権限を設定する
- サイドバーのOAuth & Permissionsに移動します
- Bot Token Scopesの下で、以下のスコープを追加します:
chat:write— メッセージの送信im:history— DM履歴の読み取りim:read— DMの表示im:write— DMの開始app_mentions:read— @メンションの検出
- 上部のInstall to ワークスペースをクリックします
- アプリを承認します
- Bot User OAuth Token（
xoxb-で始まるもの）をコピーします
イベントを有効にする
- サイドバーのEvent Subscriptionsに移動します
- Enable EventsをONに切り替えます
- Subscribe to bot eventsの下で、以下を追加します:
message.im— DMでのメッセージapp_mention— チャンネルでの@メンション
- Save Changesをクリックします
LemonClaw WebUIを開く
- ホスト型のClawを使用している場合は、Clawダッシュボードに移動し、Open WebUIをクリックします
- LemonClawをセルフホストしている場合は、自身のWebUI（例：
http://your-ip:18789）を開き、トークンでサインインします - WebUIで、Settings → Channelsに移動します
- Slackセクションを展開します
- App Token（
xapp-...）とBot Token（xoxb-...）を貼り付けます - Saveをクリックします
アクセス制御
グループ設定
LemonClaw WebUI の Channels 設定でチャンネルアクセスを設定します:| 設定 | オプション | 説明 |
|---|---|---|
| Group Policy | Open (デフォルト) / Allowlist / Disabled | Botが応答するチャンネルを制御します |
| Require @mention | On / Off | @メンションされた時のみBotが応答します |
| Group IDs | チャンネルIDのリスト | 特定のチャンネルに制限します（空の場合はすべてのチャンネル） |
| Group Allowed Users | ユーザーIDのリスト | これらのユーザーのみがBotを起動できます（allowlistモード） |
トラブルシューティング
BotがDMに反応しない
BotがDMに反応しない
- 両方のトークンが正しいことを確認してください（App Tokenは
xapp-で始まり、Bot Tokenはxoxb-で始まります） message.imイベントが購読されているか確認してください- アプリがワークスペースにインストールされていることを確認してください
Botが@メンションに反応しない
Botが@メンションに反応しない
app_mentions:readスコープとapp_mentionイベントが設定されているか確認してください- Botを先にチャンネルに招待する必要があります（
/invite @botnameと入力してください）
'not_allowed_token_type' エラー
'not_allowed_token_type' エラー
- App Tokenフィールドには、Bot TokenではなくApp-Level Token（
xapp-）を使用していることを確認してください - Bot Token（
xoxb-）はBot Tokenフィールドに入力します