2 つのトークン

Socket Mode のアプリはトークンを 2 つ使います。くらちゃんには両方が必要です。

トークン	形式	用途
Bot トークン	xoxb-…	ボットの身分 — メッセージ投稿、ファイル読み取り、コマンド実行
App レベルトークン	xapp-…	Socket Mode の接続そのもの（スコープ connections:write）

この 2 つは Slack アプリ設定の別々の場所で生成します。アプリの作成の直後に行いましょう。

1 · App レベルトークン（xapp-…）を生成

1. アプリの Settings → Basic Information を開きます。
2. App-Level Tokens → Generate Token and Scopes までスクロールします。
3. 任意の名前（例: socket）を付け、connections:write スコープを追加して Generate します。
4. xapp-… の値をコピーします。一度しか表示されません。貼り付けるまでタブを閉じないでください。

2 · アプリをインストールして Bot トークン（xoxb-…）をコピー

1. Settings → Install App を開きます。
2. Install to ＜ワークスペース名＞ をクリックし、権限を承認します。
3. Bot User OAuth Token（xoxb-… で始まる値）をコピーします。

スコープ変更後は再インストール

あとからスコープを追加した場合（手動チェックリストなど）、アプリを再インストールして新しい xoxb-… をコピーするまで、Slack は古い Bot トークンを無効にします。

3 · 両方のトークンをくらちゃんに貼り付ける

ダッシュボードで チャンネル → Slack を開きます。

1. Bot トークンを xoxb-… の欄に貼り付けます。
2. App レベルトークンを xapp-… の欄に貼り付けます。
3. 接続 をクリックします。成功すると、ワークスペース名とボットのハンドルが表示されます。

ノート

どちらのトークンも秘密情報です — ボットとしてあらゆる操作を許してしまいます。git にコミットしたり共有したりしないでください。ダッシュボードで切断するとクリアされます。

接続できたら、動作確認とトラブルシューティング で実際に動くか確認しましょう。