Slack

​

クイックセットアップ

{
  channels: {
    slack: {
      enabled: true,
      mode: "socket",
      appToken: "xapp-...",
      botToken: "xoxb-...",
    },
  },
}

SLACK_APP_TOKEN=xapp-...
SLACK_BOT_TOKEN=xoxb-...

openclaw gateway

{
  channels: {
    slack: {
      enabled: true,
      mode: "http",
      botToken: "xoxb-...",
      signingSecret: "your-signing-secret",
      webhookPath: "/slack/events",
    },
  },
}

​

トークンモデル

• ソケットモードには botToken と appToken が必要です。
• HTTP モードには botToken と signingSecret が必要です。
• 構成ファイル内のトークンは、環境変数の値を上書きします。
• SLACK_BOT_TOKEN / SLACK_APP_TOKEN 環境変数は、デフォルトアカウントにのみ適用されます。
• userToken (xoxp-...) は構成ファイルでのみ指定可能（環境変数なし）で、デフォルトは読み取り専用 (userTokenReadOnly: true) です。
• オプション: 送信メッセージにアクティブなエージェントのアイデンティティ（カスタム username とアイコン）を使用したい場合は、chat:write.customize 権限を追加してください。icon_emoji は :emoji_name: 形式を使用します。

​

アクセス制御とルーティング

​

コマンドとスラッシュコマンドの動作

• Slack ではネイティブコマンドの自動モードは オフ です (commands.native: "auto" では Slack のネイティブコマンドは有効になりません)。
• Slack ネイティブのコマンドハンドラーを有効にするには channels.slack.commands.native: true (またはグローバルな commands.native: true) を設定してください。
• ネイティブコマンドを有効にした場合は、Slack 側で対応するスラッシュコマンド (/<command> 名) を登録してください。ただし、以下の例外があります:
  • ステータスコマンドには /agentstatus を登録してください (Slack は /status を予約済みのため)。
• ネイティブコマンドが有効でない場合、channels.slack.slashCommand 経由で構成された単一のスラッシュコマンドを実行できます。
• ネイティブの引数メニューは、選択肢の数に応じてレンダリング戦略を自動調整します:
  • 5 つまで: ボタンブロック。
  • 6〜100 個: 静的セレクトメニュー。
  • 100 個超: インタラクティブオプションハンドラーが利用可能な場合、非同期フィルタリング付きの外部セレクト。
  • エンコードされたオプション値が Slack の制限を超える場合はボタンにフォールバックします。
• 長いオプションペイロードの場合、スラッシュコマンド引数メニューは値を送信する前に確認ダイアログを表示します。

• enabled: false
• name: "openclaw"
• sessionPrefix: "slack:slash"
• ephemeral: true

• agent:<agentId>:slack:slash:<userId>

​

スレッド、セッション、および返信タグ

• DM は direct、チャネルは channel、MPIM は group としてルーティングされます。
• デフォルトの session.dmScope=main 設定では、Slack の DM はエージェントのメインセッションに集約されます。
• チャネルセッション: agent:<agentId>:slack:channel:<channelId>。
• スレッドへの返信は、適用可能な場合にスレッドセッションサフィックス (:thread:<threadTs>) を作成します。
• channels.slack.thread.historyScope のデフォルトは thread です。thread.inheritParent のデフォルトは false です。
• channels.slack.thread.initialHistoryLimit は、新しいスレッドセッション開始時に取得する既存メッセージの数を制御します（デフォルト 20。0 で無効）。

• channels.slack.replyToMode: off|first|all (デフォルト off)
• channels.slack.replyToModeByChatType: direct|group|channel ごとに設定
• ダイレクトチャット用のレガシーフォールバック: channels.slack.dm.replyToMode

• [[reply_to_current]]
• [[reply_to:<id>]]

​

メディア、チャンク化、配信

​

アクションとゲート (Action Gating)

​

イベントと運用の動作

• メッセージの編集、削除、スレッド放送（Thread broadcast）はシステムイベントにマップされます。
• リアクションの追加および削除イベントはシステムイベントにマップされます。
• メンバーの参加・脱退、チャネルの作成・名前変更、およびピンの追加・削除イベントはシステムイベントにマップされます。
• アシスタントのスレッドステータス更新（スレッド内の「入力中…」インジケーター用）は assistant.threads.setStatus を使用し、ボットスコープ assistant:write を必要とします。
• configWrites が有効な場合、channel_id_changed イベントによってチャネル構成キーが移行されることがあります。
• チャネルのトピックや目的（Purpose）のメタデータは信頼できないコンテキストとして扱われ、ルーティングコンテキストに注入される場合があります。
• ブロックアクションやモーダル操作は、豊富なペイロードフィールドを持つ構造化された Slack interaction: ... システムイベントを発行します:
  • ブロックアクション: 選択された値、ラベル、ピッカーの値、および workflow_* メタデータ。
  • モーダルの view_submission および view_closed イベント: ルーティングされたチャネルメタデータとフォーム入力。

​

確認リアクション (Ack reactions)

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• エージェントのアイデンティティ絵文字 (agents.list[].identity.emoji, なければ ”👀”)

• Slack ではショートコード（例: "eyes") を指定してください。
• "" を設定すると、そのアカウントまたはグローバルでリアクションを無効にできます。

​

タイピングリアクションのフォールバック

• channels.slack.accounts.<accountId>.typingReaction
• channels.slack.typingReaction

• Slack ではショートコード（例: "hourglass_flowing_sand") を指定してください。
• このリアクションはベストエフォートであり、返信の完了時または失敗時に自動的に削除が試みられます。

​

マニフェストとスコープのチェックリスト

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw",
      "always_online": false
    },
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "chat:write",
        "channels:history",
        "channels:read",
        "groups:history",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "users:read",
        "app_mentions:read",
        "assistant:write",
        "reactions:read",
        "reactions:write",
        "pins:read",
        "pins:write",
        "emoji:read",
        "commands",
        "files:read",
        "files:write"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "reaction_added",
        "reaction_removed",
        "member_joined_channel",
        "member_left_channel",
        "channel_rename",
        "pin_added",
        "pin_removed"
      ]
    }
  }
}

​

トラブルシューティング

openclaw channels status --probe
openclaw logs --follow
openclaw doctor

openclaw pairing list slack

​

テキストストリーミング

• off: ライブプレビューのストリーミングを無効にします。
• partial (デフォルト): プレビューテキストを最新の部分出力で置き換えます。
• block: チャンク化されたプレビュー更新を追記します。
• progress: 生成中に進行状況ステータステキストを表示し、最後に最終テキストを送信します。

channels:
  slack:
    streaming: partial
    nativeStreaming: false

• channels.slack.streamMode (replace | status_final | append) は channels.slack.streaming に自動移行されます。
• ブール値の channels.slack.streaming は channels.slack.nativeStreaming に自動移行されます。

​

要件

1. Slack アプリ設定で Agents and AI Apps を有効にする。
2. アプリに assistant:write スコープが付与されていること。
3. そのメッセージに対して返信スレッドが利用可能であること（スレッドの選択は replyToMode に従います）。

​

動作

• 最初のテキストチャンクでストリームが開始されます (chat.startStream)。
• 以降のテキストチャンクは同じストリームに追加されます (chat.appendStream)。
• 返信の終了時にストリームが完了します (chat.stopStream)。
• メディアやテキスト以外のペイロードは、通常の配信方法にフォールバックします。
• 返信の途中でストリーミングが失敗した場合、残りのペイロードは通常の配信方法で送信されます。

​

構成リファレンスのポインタ

• 構成リファレンス - Slack 重要な Slack フィールド:
  • モード/認証: mode, botToken, appToken, signingSecret, webhookPath, accounts.*
  • DM アクセス: dm.enabled, dmPolicy, allowFrom (旧: dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
  • 互換性スイッチ: dangerouslyAllowNameMatching (非常時のみ。通常はオフ推奨)
  • チャネルアクセス: groupPolicy, channels.*, channels.*.users, channels.*.requireMention
  • スレッド/履歴: replyToMode, replyToModeByChatType, thread.*, historyLimit, dmHistoryLimit, dms.*.historyLimit
  • 配信: textChunkLimit, chunkMode, mediaMaxMb, streaming, nativeStreaming
  • 機能/運用: configWrites, commands.native, slashCommand.*, actions.*, userToken, userTokenReadOnly

​

関連ドキュメント

• ペアリング
• チャネルルーティング
• トラブルシューティング
• 構成
• スラッシュコマンド