Slack

Slack アプリ統合により、DM とチャンネルで本番対応です。デフォルトモードは Socket Mode です。HTTP Request URLs もサポートされています。リレーモードは、信頼されたルーターが Slack の入口を所有するマネージドデプロイ向けです。

Socket Mode または HTTP Request URLs の選択

どちらのトランスポートも本番対応で、メッセージング、スラッシュコマンド、App Home、インタラクティビティについて機能は同等です。機能ではなくデプロイ形態で選択してください。

リレーモード

リレーモードは Slack の入口を OpenClaw gateway から分離します。信頼されたルーターが 単一の Slack Socket Mode 接続を所有し、宛先 gateway を選択して、型付き イベントを認証済み websocket 経由で転送します。gateway は引き続き、アウトバウンドの Slack Web API 呼び出しに bot token を使用します。

{  channels: {    slack: {      mode: "relay",      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      relay: {        url: "wss://router.example.com/gateway/ws",        authToken: { source: "env", provider: "default", id: "SLACK_RELAY_AUTH_TOKEN" },        gatewayId: "team-gateway",      },    },  },}

リレー URL は、localhost を対象にする場合を除き wss:// を使用する必要があります。bearer token と ルーターのルートテーブルは Slack 認可境界の一部として扱ってください。ルーティングされたイベントは、 認可済みアクティベーションとして通常の Slack メッセージハンドラーに入ります。websocket の hello フレーム内で ルーターが提供する slack_identity は、デフォルトのアウトバウンドユーザー名とアイコンを設定できます。ただし、呼び出し元が明示的に 指定した identity がある場合はそちらが優先されます。リレー接続は Socket Mode と同じ 上限付きバックオフタイミングで再接続し、切断されるたびにルーター提供の identity をクリアします。

インストール

チャンネルを設定する前に Slack をインストールします。

openclaw plugins install @openclaw/slack

plugins install は plugin を登録して有効化します。ただし、以下の Slack アプリとチャンネル設定を構成するまでは、plugin は何もしません。一般的な plugin の動作とインストール規則については Plugin を参照してください。

クイックセットアップ

{"display_information": {"name": "OpenClaw","description": "Slack connector for OpenClaw"},"features": {"bot_user": { "display_name": "OpenClaw", "always_online": true },"app_home": {"home_tab_enabled": true,"messages_tab_enabled": true,"messages_tab_read_only_enabled": false},"assistant_view": {"assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.","suggested_prompts": [{ "title": "What can you do?", "message": "What can you help me with?" },{"title": "Summarize this channel","message": "Summarize the recent activity in this channel."},{ "title": "Draft a reply", "message": "Help me draft a reply." }]},"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","usergroups:read","users:read"]}},"settings": {"socket_mode_enabled": true,"event_subscriptions": {"bot_events": ["app_home_opened","app_mention","assistant_thread_context_changed","assistant_thread_started","channel_rename","member_joined_channel","member_left_channel","message.channels","message.groups","message.im","message.mpim","pin_added","pin_removed","reaction_added","reaction_removed"]}}}

{"display_information": {"name": "OpenClaw","description": "Slack connector for OpenClaw"},"features": {"bot_user": { "display_name": "OpenClaw", "always_online": true },"app_home": {"home_tab_enabled": true,"messages_tab_enabled": true,"messages_tab_read_only_enabled": false},"assistant_view": {"assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.","suggested_prompts": [{ "title": "What can you do?", "message": "What can you help me with?" },{"title": "Summarize this channel","message": "Summarize the recent activity in this channel."},{ "title": "Draft a reply", "message": "Help me draft a reply." }]},"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","groups:history","groups:read","im:history","im:read","im:write","users:read"]}},"settings": {"socket_mode_enabled": true,"event_subscriptions": {"bot_events": ["app_home_opened","app_mention","assistant_thread_context_changed","assistant_thread_started","message.channels","message.groups","message.im"]}}}

export SLACK_APP_TOKEN=slack-app-token-exampleexport SLACK_BOT_TOKEN=slack-bot-token-examplecat > slack.socket.patch.json5 <<'JSON5'{channels: {slack: {enabled: true,mode: "socket",appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },},},}JSON5openclaw config patch --file ./slack.socket.patch.json5 --dry-runopenclaw config patch --file ./slack.socket.patch.json5

SLACK_APP_TOKEN=slack-app-token-exampleSLACK_BOT_TOKEN=slack-bot-token-example

openclaw gateway

{"display_information": {"name": "OpenClaw","description": "Slack connector for OpenClaw"},"features": {"bot_user": { "display_name": "OpenClaw", "always_online": true },"app_home": {"home_tab_enabled": true,"messages_tab_enabled": true,"messages_tab_read_only_enabled": false},"assistant_view": {"assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.","suggested_prompts": [{ "title": "What can you do?", "message": "What can you help me with?" },{"title": "Summarize this channel","message": "Summarize the recent activity in this channel."},{ "title": "Draft a reply", "message": "Help me draft a reply." }]},"slash_commands": [{"command": "/openclaw","description": "Send a message to OpenClaw","should_escape": false,"url": "https://gateway-host.example.com/slack/events"}]},"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","usergroups:read","users:read"]}},"settings": {"event_subscriptions": {"request_url": "https://gateway-host.example.com/slack/events","bot_events": ["app_home_opened","app_mention","assistant_thread_context_changed","assistant_thread_started","channel_rename","member_joined_channel","member_left_channel","message.channels","message.groups","message.im","message.mpim","pin_added","pin_removed","reaction_added","reaction_removed"]},"interactivity": {"is_enabled": true,"request_url": "https://gateway-host.example.com/slack/events","message_menu_options_url": "https://gateway-host.example.com/slack/events"}}}

{"display_information": {"name": "OpenClaw","description": "Slack connector for OpenClaw"},"features": {"bot_user": { "display_name": "OpenClaw", "always_online": true },"app_home": {"home_tab_enabled": true,"messages_tab_enabled": true,"messages_tab_read_only_enabled": false},"assistant_view": {"assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.","suggested_prompts": [{ "title": "What can you do?", "message": "What can you help me with?" },{"title": "Summarize this channel","message": "Summarize the recent activity in this channel."},{ "title": "Draft a reply", "message": "Help me draft a reply." }]},"slash_commands": [{"command": "/openclaw","description": "Send a message to OpenClaw","should_escape": false,"url": "https://gateway-host.example.com/slack/events"}]},"oauth_config": {"scopes": {"bot": ["app_mentions:read","assistant:write","channels:history","channels:read","chat:write","commands","groups:history","groups:read","im:history","im:read","im:write","users:read"]}},"settings": {"event_subscriptions": {"request_url": "https://gateway-host.example.com/slack/events","bot_events": ["app_home_opened","app_mention","assistant_thread_context_changed","assistant_thread_started","message.channels","message.groups","message.im"]},"interactivity": {"is_enabled": true,"request_url": "https://gateway-host.example.com/slack/events","message_menu_options_url": "https://gateway-host.example.com/slack/events"}}}

export SLACK_BOT_TOKEN=slack-bot-token-exampleexport SLACK_SIGNING_SECRET=...cat > slack.http.patch.json5 <<'JSON5'{channels: {slack: {enabled: true,mode: "http",botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },signingSecret: { source: "env", provider: "default", id: "SLACK_SIGNING_SECRET" },webhookPath: "/slack/events",},},}JSON5openclaw config patch --file ./slack.http.patch.json5 --dry-runopenclaw config patch --file ./slack.http.patch.json5

openclaw gateway

Socket Mode トランスポート調整

OpenClaw は、Socket Mode の Slack SDK クライアント pong タイムアウトをデフォルトで 15 秒に設定します。ワークスペースまたはホスト固有の調整が必要な場合にのみ、トランスポート設定を上書きしてください。

{  channels: {    slack: {      mode: "socket",      socketMode: {        clientPingTimeout: 20000,        serverPingTimeout: 30000,        pingPongLoggingEnabled: false,      },    },  },}

これは、Slack websocket pong/server-ping タイムアウトをログに記録する Socket Mode ワークスペース、または既知のイベントループ枯渇があるホストで実行している場合にのみ使用してください。clientPingTimeout は SDK がクライアント ping を送信した後の pong 待機時間です。serverPingTimeout は Slack サーバー ping の待機時間です。アプリメッセージとイベントはアプリケーション状態のままであり、トランスポートの生存性シグナルではありません。

注:

• socketMode は HTTP Request URL モードでは無視されます。
• ベースの channels.slack.socketMode 設定は、上書きされない限りすべての Slack アカウントに適用されます。アカウントごとの上書きには channels.slack.accounts.<accountId>.socketMode を使用します。これはオブジェクト上書きであるため、そのアカウントで必要なすべてのソケット調整フィールドを含めてください。
• OpenClaw のデフォルトがあるのは clientPingTimeout（15000）だけです。serverPingTimeout と pingPongLoggingEnabled は、設定されている場合にのみ Slack SDK に渡されます。
• Socket Mode の再起動バックオフは約 2 秒から始まり、約 30 秒で上限に達します。回復可能な開始、開始待機、切断の失敗は、チャンネルが停止するまで再試行されます。無効な認証、取り消されたトークン、スコープ不足などの永続的なアカウントおよび認証情報エラーは、永久に再試行せずに即座に失敗します。

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

ベースの Slack アプリマニフェストは、Socket Mode と HTTP Request URLs で同じです。異なるのは settings ブロック（およびスラッシュコマンドの url）だけです。

ベースマニフェスト（Socket Mode デフォルト）:

{  "display_information": {    "name": "OpenClaw",    "description": "Slack connector for OpenClaw"  },  "features": {    "bot_user": { "display_name": "OpenClaw", "always_online": true },    "app_home": {      "home_tab_enabled": true,      "messages_tab_enabled": true,      "messages_tab_read_only_enabled": false    },    "assistant_view": {      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",      "suggested_prompts": [        { "title": "What can you do?", "message": "What can you help me with?" },        {          "title": "Summarize this channel",          "message": "Summarize the recent activity in this channel."        },        { "title": "Draft a reply", "message": "Help me draft a reply." }      ]    },    "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",        "usergroups:read",        "users:read"      ]    }  },  "settings": {    "socket_mode_enabled": true,    "event_subscriptions": {      "bot_events": [        "app_home_opened",        "app_mention",        "assistant_thread_context_changed",        "assistant_thread_started",        "channel_rename",        "member_joined_channel",        "member_left_channel",        "message.channels",        "message.groups",        "message.im",        "message.mpim",        "pin_added",        "pin_removed",        "reaction_added",        "reaction_removed"      ]    }  }}

HTTP Request URLs モードでは、settings を HTTP バリアントに置き換え、各スラッシュコマンドに url を追加します。公開 URL が必要です。

{  "features": {    "slash_commands": [      {        "command": "/openclaw",        "description": "Send a message to OpenClaw",        "should_escape": false,        "url": "https://gateway-host.example.com/slack/events"      }    ]  },  "settings": {    "event_subscriptions": {      "request_url": "https://gateway-host.example.com/slack/events",      "bot_events": [        "app_home_opened",        "app_mention",        "assistant_thread_context_changed",        "assistant_thread_started",        "channel_rename",        "member_joined_channel",        "member_left_channel",        "message.channels",        "message.groups",        "message.im",        "message.mpim",        "pin_added",        "pin_removed",        "reaction_added",        "reaction_removed"      ]    },    "interactivity": {      "is_enabled": true,      "request_url": "https://gateway-host.example.com/slack/events",      "message_menu_options_url": "https://gateway-host.example.com/slack/events"    }  }}

追加のマニフェスト設定

上記のデフォルトを拡張するさまざまな機能を公開します。

デフォルトのマニフェストでは、Slack App Home の Home タブが有効になり、app_home_opened をサブスクライブします。ワークスペースメンバーが Home タブを開くと、OpenClaw は views.publish で安全なデフォルトの Home ビューを公開します。会話ペイロードや非公開設定は含まれません。Slack DM 用には Messages タブが引き続き有効です。マニフェストでは、features.assistant_view、assistant:write、assistant_thread_started、assistant_thread_context_changed による Slack アシスタントスレッドも有効になります。アシスタントスレッドは専用の OpenClaw スレッドセッションにルーティングされ、Slack から提供されるスレッドコンテキストをエージェントで利用できる状態に保ちます。

{"slash_commands": [{"command": "/new","description": "Start a new session","usage_hint": "[model]"},{"command": "/reset","description": "Reset the current session"},{"command": "/compact","description": "Compact the session context","usage_hint": "[instructions]"},{"command": "/stop","description": "Stop the current run"},{"command": "/session","description": "Manage thread-binding expiry","usage_hint": "idle <duration|off> or max-age <duration|off>"},{"command": "/think","description": "Set the thinking level","usage_hint": "<level>"},{"command": "/verbose","description": "Toggle verbose output","usage_hint": "on|off|full"},{"command": "/fast","description": "Show or set fast mode","usage_hint": "[status|on|off]"},{"command": "/reasoning","description": "Toggle reasoning visibility","usage_hint": "[on|off|stream]"},{"command": "/elevated","description": "Toggle elevated mode","usage_hint": "[on|off|ask|full]"},{"command": "/exec","description": "Show or set exec defaults","usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"},{"command": "/approve","description": "Approve or deny pending approval requests","usage_hint": "<id> <decision>"},{"command": "/model","description": "Show or set the model","usage_hint": "[name|#|status]"},{"command": "/models","description": "List providers/models","usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"},{"command": "/help","description": "Show the short help summary"},{"command": "/commands","description": "Show the generated command catalog"},{"command": "/tools","description": "Show what the current agent can use right now","usage_hint": "[compact|verbose]"},{"command": "/agentstatus","description": "Show runtime status, including provider usage/quota when available"},{"command": "/tasks","description": "List active/recent background tasks for the current session"},{"command": "/context","description": "Explain how context is assembled","usage_hint": "[list|detail|json]"},{"command": "/whoami","description": "Show your sender identity"},{"command": "/skill","description": "Run a skill by name","usage_hint": "<name> [input]"},{"command": "/btw","description": "Ask a side question without changing session context","usage_hint": "<question>"},{"command": "/side","description": "Ask a side question without changing session context","usage_hint": "<question>"},{"command": "/usage","description": "Control the usage footer or show cost summary","usage_hint": "off|tokens|full|cost"}]}

{"slash_commands": [{"command": "/new","description": "Start a new session","usage_hint": "[model]","url": "https://gateway-host.example.com/slack/events"},{"command": "/help","description": "Show the short help summary","url": "https://gateway-host.example.com/slack/events"}]}

トークンモデル

• Socket Mode には botToken + appToken が必要です。
• HTTP モードには botToken + signingSecret が必要です。
• リレーモードには botToken に加えて relay.url、relay.authToken、relay.gatewayId が必要です。アプリトークンや署名シークレットは使用しません。
• botToken、appToken、signingSecret、relay.authToken、userToken は、プレーンテキスト文字列または SecretRef オブジェクトを受け付けます。
• 設定内のトークンは env フォールバックを上書きします。
• SLACK_BOT_TOKEN / SLACK_APP_TOKEN env フォールバックはデフォルトアカウントにのみ適用されます。
• userToken は設定専用（env フォールバックなし）で、デフォルトでは読み取り専用動作（userTokenReadOnly: true）になります。

ステータススナップショットの動作:

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

アクションとゲート

Slack アクションは channels.slack.actions.* で制御されます。

現在の Slack ツールで利用可能なアクショングループ:

現在の Slack メッセージアクションには、send、upload-file、download-file、read、edit、delete、pin、unpin、list-pins、member-info、emoji-list が含まれます。download-file は、受信ファイルプレースホルダーに表示される Slack ファイル ID を受け付け、画像の場合は画像プレビューを返し、その他のファイル種別の場合はローカルファイルメタデータを返します。

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

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

• DM は direct として、チャンネルは channel として、MPIM は group としてルーティングされます。
• Slack ルートバインディングは、生のピア ID に加えて、channel:C12345678、user:U12345678、<@U12345678> などの Slack ターゲット形式を受け入れます。
• デフォルトの session.dmScope=main では、Slack DM はエージェントのメインセッションに集約されます。
• チャンネルセッション: agent:<agentId>:slack:channel:<channelId>。
• 通常のトップレベルのチャンネルメッセージは、replyToMode が off 以外でも、チャンネルごとのセッションに留まります。
• Slack スレッド返信では、送信返信スレッド化が replyToMode="off" で無効化されている場合でも、セッション接尾辞（:thread:<threadTs>）に親 Slack thread_ts を使います。
• OpenClaw は、対象のトップレベルチャンネルルートが表示される Slack スレッドを開始すると見込まれる場合、そのルートを agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> にシードします。これにより、ルートと後続のスレッド返信が 1 つの OpenClaw セッションを共有します。これは app_mention イベント、明示的な bot または設定済みのメンションパターン一致、非 off の replyToMode を持つ requireMention: false チャンネルに適用されます。
• channels.slack.thread.historyScope のデフォルトは thread です。thread.inheritParent のデフォルトは false です。
• channels.slack.thread.initialHistoryLimit は、新しいスレッドセッションが開始するときに取得する既存スレッドメッセージ数を制御します（デフォルトは 20、無効化するには 0 を設定）。
• channels.slack.thread.requireExplicitMention（デフォルトは false）: true の場合、暗黙的なスレッドメンションを抑制し、bot がすでにスレッドに参加している場合でも、スレッド内の明示的な @bot メンションにのみ bot が応答します。これがない場合、bot が参加済みのスレッド内の返信は requireMention ゲートをバイパスします。

返信スレッド化の制御:

• channels.slack.replyToMode: off|first|all|batched（デフォルトは off）
• channels.slack.replyToModeByChatType: direct|group|channel ごと
• ダイレクトチャット用のレガシーフォールバック: channels.slack.dm.replyToMode

手動返信タグがサポートされています:

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

message ツールから明示的な Slack スレッド返信を行う場合、Slack にスレッド返信を親チャンネルにもブロードキャストするよう求めるには、action: "send" と threadId または replyTo とともに replyBroadcast: true を設定します。これは Slack の chat.postMessage の reply_broadcast フラグに対応し、テキストまたは Block Kit 送信でのみサポートされます。メディアアップロードではサポートされません。

message ツール呼び出しが Slack スレッド内で実行され、同じチャンネルを対象にする場合、OpenClaw は通常 replyToMode に従って現在の Slack スレッドを継承します。代わりに新しい親チャンネルメッセージを強制するには、action: "send" または action: "upload-file" に topLevel: true を設定します。threadId: null も同じトップレベルのオプトアウトとして受け入れられます。

確認リアクション

ackReaction は、OpenClaw が受信メッセージを処理している間に確認用絵文字を送信します。ackReactionScope は、その絵文字が実際に送信される タイミング を決定します。

絵文字（ackReaction）

解決順序:

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

注記:

• Slack はショートコード（例: "eyes"）を想定します。
• Slack アカウントまたはグローバルでリアクションを無効にするには "" を使います。

スコープ（messages.ackReactionScope）

Slack プロバイダーは messages.ackReactionScope（デフォルトは "group-mentions"）からスコープを読み取ります。現時点では Slack アカウントまたは Slack チャンネルレベルの上書きはありません。この値は Gateway 全体にグローバルです。

値:

• "all": DM とグループでリアクションします。
• "direct": DM のみでリアクションします。
• "group-all": すべてのグループメッセージでリアクションします（DM なし）。
• "group-mentions"（デフォルト）: グループでリアクションしますが、bot がメンションされた場合（またはオプトインしたグループメンション可能対象内）のみです。DM は除外されます。
• "off" / "none": リアクションしません。

{  messages: {    ackReaction: "eyes",    ackReactionScope: "all", // react in DMs and groups  },}

テキストストリーミング

channels.slack.streaming はライブプレビューの動作を制御します:

• off: ライブプレビューストリーミングを無効にします。
• partial（デフォルト）: プレビューテキストを最新の部分出力に置き換えます。
• block: 分割されたプレビュー更新を追加します。
• progress: 生成中は進行状況テキストを表示し、その後最終テキストを送信します。
• streaming.preview.toolProgress: 下書きプレビューが有効な場合、ツール/進行状況の更新を同じ編集済みプレビューメッセージにルーティングします（デフォルト: true）。個別のツール/進行状況メッセージを維持するには false を設定します。
• streaming.preview.commandText / streaming.progress.commandText: 生のコマンド/exec テキストを隠しながら、コンパクトなツール進行状況行を維持するには status に設定します（デフォルト: raw）。

コンパクトな進行状況行を維持しながら、生のコマンド/exec テキストを隠します:

{  "channels": {    "slack": {      "streaming": {        "mode": "progress",        "progress": {          "toolProgress": true,          "commandText": "status"        }      }    }  }}

channels.slack.streaming.nativeTransport は、channels.slack.streaming.mode が partial の場合の Slack ネイティブテキストストリーミングを制御します（デフォルト: true）。

Slack ネイティブ進行状況タスクカードは、進行状況モードでオプトインです。作業の実行中に Slack ネイティブの計画/タスクカードを送信し、完了時に同じタスクカードを更新するには、channels.slack.streaming.mode="progress" とともに channels.slack.streaming.progress.nativeTaskCards を true に設定します。このフラグがない場合、進行状況モードはポータブルな下書きプレビュー動作を維持します。

• ネイティブテキストストリーミングと Slack アシスタントスレッドステータスを表示するには、返信スレッドが利用可能である必要があります。スレッド選択は引き続き replyToMode に従います。
• ネイティブストリーミングが利用できない場合、または返信スレッドが存在しない場合でも、チャンネル、グループチャット、トップレベル DM ルートは通常の下書きプレビューを使用できます。
• トップレベルの Slack DM はデフォルトでスレッド外のままなので、Slack のスレッド形式のネイティブストリーム/ステータスプレビューは表示されません。代わりに OpenClaw は DM 内で下書きプレビューを投稿して編集します。
• メディアと非テキストペイロードは通常配信にフォールバックします。
• メディア/エラー最終応答は保留中のプレビュー編集をキャンセルします。対象のテキスト/block 最終応答は、プレビューをその場で編集できる場合にのみフラッシュされます。
• ストリーミングが返信途中で失敗した場合、OpenClaw は残りのペイロードを通常配信にフォールバックします。

Slack ネイティブテキストストリーミングの代わりに下書きプレビューを使います:

{  channels: {    slack: {      streaming: {        mode: "partial",        nativeTransport: false,      },    },  },}

Slack ネイティブ進行状況タスクカードにオプトインします:

{  channels: {    slack: {      streaming: {        mode: "progress",        progress: {          nativeTaskCards: true,          render: "rich",        },      },    },  },}

レガシーキー:

• channels.slack.streamMode（replace | status_final | append）は channels.slack.streaming.mode のレガシーランタイムエイリアスです。
• ブール値の channels.slack.streaming は channels.slack.streaming.mode と channels.slack.streaming.nativeTransport のレガシーランタイムエイリアスです。
• レガシー channels.slack.nativeStreaming は channels.slack.streaming.nativeTransport のランタイムエイリアスです。
• 永続化された Slack ストリーミング設定を正規キーに書き換えるには、openclaw doctor --fix を実行します。

入力中リアクションフォールバック

typingReaction は、OpenClaw が返信を処理している間に受信 Slack メッセージへ一時的なリアクションを追加し、実行が完了すると削除します。これは、デフォルトの「is typing...」ステータスインジケーターを使うスレッド返信以外で最も便利です。

解決順序:

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

注記:

• Slack はショートコード（例: "hourglass_flowing_sand"）を想定します。
• リアクションはベストエフォートであり、返信または失敗パスの完了後にクリーンアップが自動的に試行されます。

メディア、分割、配信

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

スラッシュコマンドは、単一の設定済みコマンドまたは複数のネイティブコマンドとして Slack に表示されます。コマンドのデフォルトを変更するには channels.slack.slashCommand を設定します:

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

/openclaw /help

ネイティブコマンドには Slack アプリで 追加のマニフェスト設定 が必要であり、代わりにグローバル設定の channels.slack.commands.native: true または commands.native: true で有効化します。

• Slack ではネイティブコマンド自動モードが off であるため、commands.native: "auto" は Slack ネイティブコマンドを有効化しません。

/help

ネイティブ引数メニューは、選択されたオプション値をディスパッチする前に確認モーダルを表示する適応レンダリング戦略を使います:

• 最大 5 オプション: ボタンブロック
• 6〜100 オプション: 静的選択メニュー
• 100 を超えるオプション: インタラクティビティオプションハンドラーが利用可能な場合、非同期オプションフィルタリング付きの外部選択
• Slack 制限超過: エンコードされたオプション値はボタンにフォールバックします。

/think

スラッシュセッションは agent:<agentId>:slack:slash:<userId> のような分離されたキーを使用し、コマンド実行は引き続き CommandTargetSessionKey を使って対象の会話セッションへルーティングされます。

インタラクティブ返信

Slack はエージェントが作成したインタラクティブ返信コントロールを表示できますが、この機能はデフォルトでは無効です。 新しいエージェント、CLI、Plugin の出力では、共有の presentation ボタンまたは select ブロックを優先してください。これらは同じ Slack インタラクション パスを使用しつつ、他のチャネルでも劣化表示されます。

グローバルに有効化します。

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

または、1つの Slack アカウントだけで有効化します。

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

有効化されている場合でも、エージェントは非推奨の Slack 専用返信ディレクティブを出力できます。

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

これらのディレクティブは Slack Block Kit にコンパイルされ、クリックや選択は 既存の Slack インタラクションイベントパスを通じて戻されます。古い プロンプトや Slack 固有の退避手段として残し、新しい 移植可能なコントロールには共有 presentation を使用してください。

ディレクティブコンパイラ API も、新しい producer コードでは非推奨です。

• compileSlackInteractiveReplies(...)
• parseSlackOptionsLine(...)
• isSlackInteractiveRepliesEnabled(...)
• buildSlackInteractiveBlocks(...)

新しい Slack 表示コントロールには presentation ペイロードと buildSlackPresentationBlocks(...) を使用してください。

注:

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

Plugin 所有のモーダル送信

インタラクティブハンドラを登録する Slack Plugin は、OpenClaw がペイロードを エージェントに見えるシステムイベントへ圧縮する前に、モーダルの view_submission および view_closed ライフサイクルイベントも受け取れます。Slack モーダルを開くときは、次のルーティング パターンのいずれかを使用してください。

• callback_id を openclaw:<namespace>:<payload> に設定します。
• または、既存の callback_id を維持し、モーダルの private_metadata に pluginInteractiveData: "<namespace>:<payload>" を入れます。

ハンドラは ctx.interaction.kind を view_submission または view_closed として受け取り、正規化された inputs と、Slack からの完全な生の stateValues オブジェクトを受け取ります。 callback-id のみのルーティングで Plugin ハンドラを呼び出すには十分です。 モーダルがエージェントに見えるシステムイベントも生成する必要がある場合は、既存のモーダル private_metadata のユーザー/セッションルーティングフィールドを含めてください。エージェントは コンパクトで編集済みの Slack interaction: ... システムイベントを受け取ります。ハンドラが systemEvent.summary、systemEvent.reference、または systemEvent.data を返す場合、それらの フィールドはそのコンパクトイベントに含まれるため、エージェントは完全なフォームペイロードを見ずに Plugin 所有のストレージを参照できます。

Slack のネイティブ承認

Slack は Web UI やターミナルへフォールバックする代わりに、インタラクティブボタンとインタラクションを備えたネイティブ承認クライアントとして機能できます。

• exec 承認と Plugin 承認は、Slack ネイティブの Block Kit プロンプトとして表示できます。
• channels.slack.execApprovals.* は、ネイティブ exec 承認クライアントの有効化と DM/チャネルルーティング設定のままです。
• exec 承認 DM は channels.slack.execApprovals.approvers または commands.ownerAllowFrom を使用します。
• Plugin 承認は、発信元セッションのネイティブ承認クライアントとして Slack が有効化されている場合、または approvals.plugin が発信元 Slack セッションか Slack ターゲットへルーティングされる場合に、Slack ネイティブボタンを使用します。
• Plugin 承認 DM は、channels.slack.allowFrom、名前付きアカウントの allowFrom、またはアカウントのデフォルトルートから Slack Plugin approver を使用します。
• approver の認可は引き続き強制されます。exec 専用 approver は、Plugin approver でもない限り Plugin リクエストを承認できません。

これは他のチャネルと同じ共有承認ボタン面を使用します。Slack アプリ設定で interactivity が有効化されている場合、承認プロンプトは会話内に直接 Block Kit ボタンとして表示されます。 これらのボタンが存在する場合、それらが主要な承認 UX です。OpenClaw は、ツール結果がチャット 承認を利用できない、または手動承認が唯一のパスであると示す場合にのみ、手動の /approve コマンドを含めるべきです。

設定パス:

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

enabled が未設定または "auto" で、少なくとも1つの exec approver が解決される場合、Slack はネイティブ exec 承認を自動有効化します。Slack は、Slack Plugin approver が解決され、リクエストがネイティブクライアントフィルタに一致する場合、このネイティブクライアント パスを通じてネイティブ Plugin 承認も処理できます。Slack をネイティブ承認クライアントとして明示的に無効化するには enabled: false を設定します。approver が解決される場合にネイティブ承認を強制的に有効にするには enabled: true を設定します。Slack exec 承認を無効化しても、 approvals.plugin を通じて有効化されたネイティブ Slack Plugin 承認配信は無効化されません。Plugin 承認 配信は代わりに Slack Plugin approver を使用します。

明示的な Slack exec 承認設定がない場合のデフォルト動作:

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

明示的な Slack ネイティブ設定が必要なのは、approver を上書きする、フィルタを追加する、または 発信元チャット配信へオプトインする場合だけです。

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

共有 approvals.exec 転送は別物です。exec 承認プロンプトを他のチャットや明示的な帯域外ターゲットにも ルーティングする必要がある場合にのみ使用してください。共有 approvals.plugin 転送も 別物です。Slack ネイティブ配信は、Slack が Plugin 承認リクエストをネイティブに処理できる場合にのみ、そのフォールバックを抑制します。

同じチャット内の /approve も、すでにコマンドをサポートする Slack チャネルと DM で機能します。承認転送モデル全体については、exec 承認を参照してください。

イベントと運用動作

• メッセージの編集/削除はシステムイベントへマップされます。
• スレッドブロードキャスト (「Also send to channel」のスレッド返信) は通常のユーザーメッセージとして処理されます。
• リアクションの追加/削除イベントはシステムイベントへマップされます。
• メンバーの参加/退出、チャネルの作成/名前変更、ピンの追加/削除イベントはシステムイベントへマップされます。
• configWrites が有効な場合、channel_id_changed はチャネル設定キーを移行できます。
• チャネルの topic/purpose メタデータは信頼できないコンテキストとして扱われ、ルーティングコンテキストへ注入される可能性があります。
• スレッド開始メッセージと初期スレッド履歴コンテキストのシードは、該当する場合、設定された送信者 allowlist によってフィルタされます。
• ブロックアクション、ショートカット、モーダルインタラクションは、豊富なペイロードフィールドを持つ構造化された Slack interaction: ... システムイベントを出力します。
  • ブロックアクション: 選択された値、ラベル、ピッカー値、workflow_* メタデータ
  • グローバルショートカット: コールバックとアクターメタデータ。アクターの直接セッションへルーティング
  • メッセージショートカット: コールバック、アクター、チャネル、スレッド、選択されたメッセージのコンテキスト
  • ルーティングされたチャネルメタデータとフォーム入力を含むモーダル view_submission および view_closed イベント

Slack アプリ設定でグローバルショートカットまたはメッセージショートカットを定義し、空でない任意の callback ID を使用してください。OpenClaw は一致するショートカットペイロードを確認応答し、他の Slack インタラクションと同じ DM/チャネル送信者ポリシーを適用し、サニタイズされたイベントをルーティング済みエージェントセッションへキューイングします。トリガー ID とレスポンス URL はエージェントコンテキストから編集されます。

設定リファレンス

主要リファレンス: 設定リファレンス - Slack。

トラブルシューティング

{messages: {groupChat: {  visibleReplies: "automatic",},},}

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

添付ファイル vision リファレンス

Slack ファイルのダウンロードが成功し、サイズ制限で許可される場合、Slack はダウンロードしたメディアを agent turn に添付できます。画像ファイルは media understanding パス経由で渡すことも、vision 対応の返信モデルへ直接渡すこともできます。他のファイルは、画像入力として扱われるのではなく、ダウンロード可能なファイルコンテキストとして保持されます。

サポートされるメディアタイプ

インバウンドパイプライン

ファイル添付を含む Slack メッセージが到着すると、次の処理が行われます。

1. OpenClaw は bot トークンを使用して Slack の private URL からファイルをダウンロードします。
2. 成功すると、ファイルはメディアストアに書き込まれます。
3. ダウンロードされたメディアパスとコンテンツタイプがインバウンドコンテキストに追加されます。
4. 画像対応のモデル/ツールパスは、そのコンテキスト内の画像添付を使用できます。
5. 画像以外のファイルは、それを扱えるツール向けのファイルメタデータまたはメディア参照として引き続き利用できます。

スレッドルート添付の継承

メッセージがスレッド内に到着した場合（thread_ts 親を持つ場合）:

• 返信自体に直接のメディアがなく、含まれるルートメッセージにファイルがある場合、Slack はルートファイルをスレッド開始コンテキストとして補完できます。
• 直接の返信添付は、ルートメッセージ添付より優先されます。
• ファイルだけでテキストがないルートメッセージは、fallback がそのファイルを引き続き含められるように、添付ファイルプレースホルダーで表されます。

複数添付の処理

単一の Slack メッセージに複数のファイル添付が含まれる場合:

• 各添付はメディアパイプラインを通じて個別に処理されます。
• ダウンロードされたメディア参照はメッセージコンテキストに集約されます。
• 処理順序は、イベントペイロード内の Slack のファイル順に従います。
• 1 つの添付のダウンロードに失敗しても、他の添付はブロックされません。

サイズ、ダウンロード、モデルの制限

• サイズ上限: デフォルトはファイルごとに 20 MB。channels.slack.mediaMaxMb で構成できます。
• ダウンロード失敗: Slack が配信できないファイル、期限切れ URL、アクセスできないファイル、サイズ超過ファイル、Slack 認証/ログイン HTML レスポンスは、未対応形式として報告されるのではなくスキップされます。
• Vision モデル: 画像解析は、vision をサポートする場合はアクティブな返信モデルを使用し、それ以外の場合は agents.defaults.imageModel で構成された画像モデルを使用します。

既知の制限

関連ドキュメント

• Media understanding パイプライン
• PDF ツール
• Epic: #51349 — Slack 添付ファイル vision の有効化
• 回帰テスト: #51353
• ライブ検証: #51354

関連