​

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",
    },
  },
}

​

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

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw",
      "always_online": true
    },
    "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": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

​

トークンモデル

• Socket Mode には botToken + appToken が必要です。
• HTTP モードには botToken + signingSecret が必要です。
• botToken、appToken、signingSecret、userToken はプレーンテキスト文字列または SecretRef オブジェクトを受け付けます。
• config のトークンは環境変数フォールバックより優先されます。
• 環境変数フォールバック SLACK_BOT_TOKEN / SLACK_APP_TOKEN はデフォルトアカウントにのみ適用されます。
• userToken（xoxp-...）は config 専用です（環境変数フォールバックなし）。デフォルトでは読み取り専用動作（userTokenReadOnly: true）です。
• オプション: 送信メッセージでアクティブなエージェントの identity（カスタム username と icon）を使いたい場合は chat:write.customize を追加してください。icon_emoji には :emoji_name: 形式を使います。

• Slack アカウント検査では、認証情報ごとの *Source と *Status フィールド（botToken、appToken、signingSecret、userToken）を追跡します。
• ステータスは available、configured_unavailable、missing です。
• configured_unavailable は、そのアカウントが SecretRef または別の非インラインなシークレットソースで設定されているが、現在のコマンド/ランタイム経路では実際の値を解決できなかったことを意味します。
• HTTP モードでは signingSecretStatus が含まれます。Socket Mode では必要な組み合わせは botTokenStatus + appTokenStatus です。

​

アクションとゲート

​

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

​

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

• 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>]]

​

確認リアクション

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• エージェント identity の絵文字フォールバック（agents.list[].identity.emoji、なければ "👀"）

• Slack では shortcode（例: "eyes"）が必要です。
• Slack アカウント単位またはグローバルでリアクションを無効化するには "" を使います。

​

テキストストリーミング

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

• Slack ネイティブのテキストストリーミングを表示するには返信スレッドが利用可能である必要があります。スレッド選択は引き続き replyToMode に従います。利用できない場合は通常のドラフトプレビューが使われます。
• メディアおよび非テキストのペイロードは通常配信にフォールバックします。
• ストリーミングが返信の途中で失敗した場合、OpenClaw は残りのペイロードを通常配信にフォールバックします。

{
  channels: {
    slack: {
      streaming: "partial",
      nativeStreaming: false,
    },
  },
}

• channels.slack.streamMode（replace | status_final | append）は自動的に channels.slack.streaming へ移行されます。
• 真偽値の channels.slack.streaming は自動的に channels.slack.nativeStreaming へ移行されます。

​

typing reaction フォールバック

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

• Slack では shortcode（例: "hourglass_flowing_sand"）が必要です。
• このリアクションはベストエフォートで、返信または失敗経路の完了後に自動クリーンアップが試行されます。

​

メディア、分割、配信

​

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

• Slack のネイティブコマンド自動モードは オフ です（commands.native: "auto" では Slack ネイティブコマンドは有効になりません）。
• Slack ネイティブコマンドハンドラーを有効にするには channels.slack.commands.native: true（またはグローバルの commands.native: true）を設定してください。
• ネイティブコマンドが有効な場合は、対応するスラッシュコマンドを Slack に登録してください（/<command> 名）。ただし 1 つ例外があります。
  • ステータスコマンドには /agentstatus を登録してください（Slack は /status を予約しています）
• ネイティブコマンドが有効でない場合は、channels.slack.slashCommand により 1 つの設定済みスラッシュコマンドを実行できます。
• ネイティブ引数メニューは、表示戦略を自動調整するようになりました。
  • 最大 5 個の選択肢: button block
  • 6〜100 個の選択肢: static select menu
  • 100 個超の選択肢: interactivity options handler が利用可能な場合は、非同期オプションフィルタ付き external select
  • エンコードされた選択肢の値が Slack 制限を超える場合、フローは button にフォールバックします
• 長い選択肢ペイロードでは、スラッシュコマンド引数メニューは選択値を送信する前に確認ダイアログを使います。

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

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

​

インタラクティブ返信

{
  channels: {
    slack: {
      capabilities: {
        interactiveReplies: true,
      },
    },
  },
}

{
  channels: {
    slack: {
      accounts: {
        ops: {
          capabilities: {
            interactiveReplies: true,
          },
        },
      },
    },
  },
}

• [[slack_buttons: Approve:approve, Reject:reject]]
• [[slack_select: Choose a target | Canary:canary, Production:production]]

• これは Slack 固有の UI です。他のチャネルでは Slack Block Kit ディレクティブを独自のボタンシステムに変換しません。
• インタラクティブコールバック値は、エージェントが生で記述した値ではなく、OpenClaw が生成した不透明トークンです。
• 生成されたインタラクティブ block が Slack Block Kit の制限を超える場合、OpenClaw は無効な block ペイロードを送信する代わりに元のテキスト返信へフォールバックします。

​

Slack での exec 承認

• exec 承認はネイティブ DM/チャネルルーティングに channels.slack.execApprovals.* を使います。
• plugin 承認も、リクエストがすでに Slack に届いていて承認 ID 種別が plugin: の場合、同じ Slack ネイティブのボタン UI で解決できます。
• 承認者の認可は引き続き強制されます。承認または拒否できるのは承認者として識別されたユーザーのみです。

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers（任意。可能な場合は commands.ownerAllowFrom にフォールバック）
• channels.slack.execApprovals.target（dm | channel | both、デフォルト: dm）
• agentFilter, sessionFilter

{
  commands: {
    ownerAllowFrom: ["slack:U12345678"],
  },
}

{
  channels: {
    slack: {
      execApprovals: {
        enabled: true,
        approvers: ["U12345678"],
        target: "both",
      },
    },
  },
}

​

イベントと運用動作

• メッセージ編集/削除/スレッドブロードキャストは system event にマップされます。
• reaction の追加/削除イベントは system event にマップされます。
• メンバー参加/離脱、チャネル作成/名称変更、pin 追加/削除イベントは system event にマップされます。
• channel_id_changed は、configWrites が有効な場合にチャネル config キーを移行できます。
• チャネルトピック/目的メタデータは信頼されないコンテキストとして扱われ、ルーティングコンテキストに注入できます。
• スレッド開始メッセージと初期スレッド履歴コンテキストのシーディングは、適用可能な場合、設定済み送信者 allowlist によってフィルタされます。
• Block action と modal interaction は、豊富なペイロードフィールドを持つ構造化された Slack interaction: ... system event を出力します。
  • block action: 選択値、ラベル、picker 値、workflow_* メタデータ
  • modal の view_submission および view_closed イベントと、ルーティングされたチャネルメタデータおよびフォーム入力

​

設定リファレンスへのポインタ

• Configuration reference - 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

​

トラブルシューティング

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

openclaw pairing list slack

​

関連

• Pairing
• Groups
• Security
• Channel routing
• Troubleshooting
• Configuration
• Slash commands