Slack

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 は、デフォルトの送信ユーザー名とアイコンを設定できます。ただし、呼び出し元から明示的に指定された ID が引き続き優先されます。リレー接続は Socket Mode と同じ上限付きバックオフタイミングで再接続し、切断するたびにルーターから提供された ID を消去します。

Enterprise Grid の組織全体インストール

1 つの Slack アカウントで、Enterprise Grid の組織全体インストールの対象となるすべてのワークスペースからメッセージを受信できます。直接接続の Socket Mode または HTTP Request URLs を選択してください。エンタープライズアカウントではリレーモードはサポートされていません。以下の 2 つの最小権限マニフェストは、V1 の message と app_mention のイベントパス、即時返信、リスナーが管理するステータスリアクションのみを有効にします。

Socket Mode

{  "display_information": {    "name": "OpenClaw",    "description": "OpenClaw 用 Slack コネクター"  },  "features": {    "bot_user": { "display_name": "OpenClaw", "always_online": true }  },  "oauth_config": {    "scopes": {      "bot": [        "app_mentions:read",        "channels:history",        "channels:read",        "chat:write",        "files:read",        "files:write",        "groups:history",        "groups:read",        "im:history",        "im:read",        "mpim:history",        "mpim:read",        "reactions:write",        "users:read"      ]    }  },  "settings": {    "org_deploy_enabled": true,    "socket_mode_enabled": true,    "event_subscriptions": {      "bot_events": [        "app_mention",        "message.channels",        "message.groups",        "message.im",        "message.mpim"      ]    }  }}

Enterprise Grid Org Admin または Org Owner にアプリを承認してもらい、組織レベルでインストールして、そのインストールの対象となるワークスペースを選択してください。OpenClaw を起動する前に、対象とするすべてのワークスペースでアプリが利用可能であることを確認してください。Socket Mode 用に connections:write を持つ App-Level Token を生成し、組織インストールから Bot token をコピーします。組織にインストールされた Bot token を使用するアカウントを設定します。

{  channels: {    slack: {      enabled: true,      mode: "socket",      enterpriseOrgInstall: true,      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      dmPolicy: "open",      allowFrom: ["*"],      groupPolicy: "allowlist",      channels: {        C0123456789: { requireMention: true },      },    },  },}

HTTP Request URLs

Gateway に公開 HTTPS エンドポイントがあり、Socket Mode 接続を開かない場合は、HTTP モードを使用します。サンプル URL を Gateway の公開 webhookPath URL（デフォルト /slack/events）に置き換えてください。

{  "display_information": {    "name": "OpenClaw",    "description": "OpenClaw 用 Slack コネクター"  },  "features": {    "bot_user": { "display_name": "OpenClaw", "always_online": true }  },  "oauth_config": {    "scopes": {      "bot": [        "app_mentions:read",        "channels:history",        "channels:read",        "chat:write",        "files:read",        "files:write",        "groups:history",        "groups:read",        "im:history",        "im:read",        "mpim:history",        "mpim:read",        "reactions:write",        "users:read"      ]    }  },  "settings": {    "org_deploy_enabled": true,    "event_subscriptions": {      "request_url": "https://gateway-host.example.com/slack/events",      "bot_events": [        "app_mention",        "message.channels",        "message.groups",        "message.im",        "message.mpim"      ]    }  }}

Enterprise Grid Org Admin または Org Owner にアプリを承認してもらい、組織レベルでインストールして、そのインストールの対象となるワークスペースを選択してください。Slack が Request URL を検証した後、組織インストールの Bot token とアプリの Basic Information -> App Credentials -> Signing Secret をコピーします。同じ Request URL パスを使用してエンタープライズアカウントを設定します。

{  channels: {    slack: {      enabled: true,      mode: "http",      enterpriseOrgInstall: true,      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      signingSecret: {        source: "env",        provider: "default",        id: "SLACK_SIGNING_SECRET",      },      webhookPath: "/slack/events",      dmPolicy: "open",      allowFrom: ["*"],      groupPolicy: "allowlist",      channels: {        C0123456789: { requireMention: true },      },    },  },}

起動時に、OpenClaw は Slack の auth.test を使用して enterpriseOrgInstall を検証します。フラグのない組織インストール済みトークン、またはフラグのあるワークスペーストークンでは、起動に失敗します。どのワークスペースがインストールを許可したかについては、引き続き Slack が信頼できる情報源です。その後、OpenClaw は配信された各イベントに、設定済みのチャンネル、ユーザー、DM、メンションのポリシーを適用します。Enterprise V1 は、allowBots に関係なく、Bot が生成したすべての message および app_mention イベントをディスパッチ前に拒否します。これは、組織インストールではループ防止に使用できる安定したワークスペース修飾済み Bot ID が提供されないためです。

Enterprise サポートは、直接接続の Socket Mode または HTTP の message および app_mention イベントと、それらへの即時返信に意図的に限定されています。エンタープライズアカウントでは、リレーモード、スラッシュコマンド、インタラクション、App Home、リアクションイベントリスナー、ピン、Slack アクションツール、Slack ネイティブ承認、バインディング、キューまたはスケジュールされた配信、プロアクティブ送信は利用できません。送信確認、入力中、ステータスのリアクションは、リスナーが管理する Slack クライアントを介してサポートされ、reactions:write が必要です。受信リアクション通知とリアクションアクションツールは引き続き利用できません。

即時返信では、チャンク、メディア、メタデータ、アイデンティティのフォールバック、アンファール、受領確認について、標準の Slack 配信動作を再利用します。ただし、検証済みのリスナー所有クライアントがアクティブなイベントターン内にある間に限ります。メモリ内の送信キューとスレッド参加記録は、そのイベントのワークスペースごとに分割されます。クライアント自体がシリアル化または永続化されることはありません。

チャンネルポリシーキーと dm.groupChannels エントリには、未加工の安定した Slack チャンネル ID または channel:<id> 形式を使用する必要があります。OpenClaw は、どちらの形式もランタイム照合用の未加工チャンネル ID に正規化します。 slack:、group:、mpim: のプレフィックスを使用すると起動に失敗します。 ユーザーポリシーエントリには、安定した Slack ユーザー ID を使用する必要があります。名前、スラッグ、表示名、 メールアドレスを使用すると起動に失敗します。ID には、Slack の標準的な大文字の プレフィックスと本体（例: C0123456789 または U0123456789）を使用する必要があります。小文字や 短い類似形式を使用すると起動に失敗します。Enterprise アカウントでは dangerouslyAllowNameMatching を有効にできません。Enterprise アカウントではグローバルな mentionPatterns.mode を設定できますが、mentionPatterns.allowIn と mentionPatterns.denyIn を設定すると起動に失敗します。これは、単独の Slack チャンネル ID は ワークスペースで修飾されておらず、複数のワークスペースで再利用される可能性があるためです。ワークスペースインストールでは、 既存のスコープ付きメンションパターン動作が維持されます。受け入れられた各ワークスペースには、 Slack ID が重複している場合でも、個別のルーティング、セッション、トランスクリプト、重複排除、履歴、キャッシュのアイデンティティが 割り当てられます。message ストリーム内では、通常のユーザーメッセージと ユーザーが作成した file_share イベントがサポートされます。それ以外のメッセージサブタイプは、 認可またはシステムイベント処理の前に拒否されます。

Enterprise DM は無効にする（dm.enabled=false または dmPolicy="disabled"）か、dmPolicy="open" を指定し、 リテラル "*" を含む有効なアカウント allowFrom によって明示的に開放する必要があります。空の 許可リスト、または "*" を含まないユーザー固有 ID を指定すると起動に失敗します。ペアリングと ユーザーごとの DM 許可リストは拒否されます。これは、それらの認可ストアでは Slack ユーザー ID が ワークスペースで修飾されていないためです。チャンネルメッセージには引き続きチャンネルポリシーと送信者ポリシーが 適用されます。

インストール

openclaw plugins install @openclaw/slack

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

クイックセットアップ

このセクションのマニフェストでは、ワークスペーススコープのインストールを作成します。 Enterprise Grid の組織インストールでは、代わりに専用の 組織全体のマニフェストとワークフローを使用してください。

{"display_information": {"name": "OpenClaw","description": "OpenClaw 用 Slack コネクター"},"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 は Slack のアシスタントスレッドを OpenClaw エージェントに接続します。","suggested_prompts": [{ "title": "何ができますか？", "message": "どのようなことを手伝えますか？" },{"title": "このチャンネルを要約","message": "このチャンネルの最近のアクティビティを要約してください。"},{ "title": "返信の下書きを作成", "message": "返信の下書き作成を手伝ってください。" }]},"slash_commands": [{"command": "/openclaw","description": "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": "OpenClaw 用 Slack コネクター"},"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 は Slack のアシスタントスレッドを OpenClaw エージェントに接続します。","suggested_prompts": [{ "title": "何ができますか？", "message": "どのようなことを手伝えますか？" },{"title": "このチャンネルを要約","message": "このチャンネルの最近のアクティビティを要約してください。"},{ "title": "返信の下書きを作成", "message": "返信の下書き作成を手伝ってください。" }]},"slash_commands": [{"command": "/openclaw","description": "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": "OpenClaw 用 Slack コネクター"},"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 は Slack のアシスタントスレッドを OpenClaw エージェントに接続します。","suggested_prompts": [{ "title": "何ができますか？", "message": "どのようなことを手伝えますか？" },{"title": "このチャンネルを要約","message": "このチャンネルの最近のアクティビティを要約してください。"},{ "title": "返信の下書きを作成", "message": "返信の下書き作成を手伝ってください。" }]},"slash_commands": [{"command": "/openclaw","description": "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": "OpenClaw 用 Slack コネクター"},"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 は Slack のアシスタントスレッドを OpenClaw エージェントに接続します。","suggested_prompts": [{ "title": "何ができますか？", "message": "何を手伝ってもらえますか？" },{"title": "このチャンネルを要約","message": "このチャンネルの最近のアクティビティを要約してください。"},{ "title": "返信を作成", "message": "返信の作成を手伝ってください。" }]},"slash_commands": [{"command": "/openclaw","description": "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 またはサーバー ping のタイムアウトが記録される Socket Mode ワークスペースや、イベントループの枯渇が既知のホストでのみ使用してください。clientPingTimeout は SDK がクライアント ping を送信した後に pong を待つ時間で、serverPingTimeout は Slack サーバーの ping を待つ時間です。アプリのメッセージとイベントはアプリケーションの状態であり、トランスポートの生存確認シグナルではありません。

注意事項：

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

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

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

基本マニフェスト（Socket Mode がデフォルト）：

{  "display_information": {    "name": "OpenClaw",    "description": "OpenClaw 用 Slack コネクター"  },  "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 は Slack のアシスタントスレッドを OpenClaw エージェントに接続します。",      "suggested_prompts": [        { "title": "何ができますか？", "message": "何を手伝ってもらえますか？" },        {          "title": "このチャンネルを要約",          "message": "このチャンネルの最近のアクティビティを要約してください。"        },        { "title": "返信を作成", "message": "返信の作成を手伝ってください。" }      ]    },    "slash_commands": [      {        "command": "/openclaw",        "description": "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 URL モードでは、settings を HTTP 用のバリアントに置き換え、各スラッシュコマンドに url を追加します。公開 URL が必要です。

{  "features": {    "slash_commands": [      {        "command": "/openclaw",        "description": "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 ビューを公開します。会話のペイロードや非公開の設定は含まれません。単一スラッシュコマンドモードが有効な場合、コマンドのヒントには channels.slack.slashCommand.name が使用されます。ネイティブコマンドを使用するインストールや、スラッシュコマンドを使用しないインストールでは、このヒントは省略されます。Slack DM 用の Messages タブは引き続き有効です。また、マニフェストは features.assistant_view、assistant:write、assistant_thread_started、および assistant_thread_context_changed を使用して Slack のアシスタントスレッドを有効にします。アシスタントスレッドはそれぞれ専用の OpenClaw スレッドセッションにルーティングされ、Slack が提供するスレッドコンテキストをエージェントが利用できる状態に保ちます。

{"slash_commands": [{"command": "/new","description": "新しいセッションを開始","usage_hint": "[model]"},{"command": "/reset","description": "現在のセッションをリセット"},{"command": "/compact","description": "セッションコンテキストを圧縮","usage_hint": "[instructions]"},{"command": "/stop","description": "現在の実行を停止"},{"command": "/session","description": "スレッド紐付けの有効期限を管理","usage_hint": "アイドル <duration|off> または最大経過時間 <duration|off>"},{"command": "/think","description": "思考レベルを設定","usage_hint": "<level>"},{"command": "/verbose","description": "詳細出力を切り替え","usage_hint": "on|off|full"},{"command": "/fast","description": "高速モードを表示または設定","usage_hint": "[status|on|off]"},{"command": "/reasoning","description": "推論の表示を切り替え","usage_hint": "[on|off|stream]"},{"command": "/elevated","description": "昇格モードを切り替え","usage_hint": "[on|off|ask|full]"},{"command": "/exec","description": "exec のデフォルトを表示または設定","usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"},{"command": "/approve","description": "保留中の承認リクエストを承認または拒否","usage_hint": "<id> <decision>"},{"command": "/model","description": "モデルを表示または設定","usage_hint": "[name|#|status]"},{"command": "/models","description": "プロバイダー／モデルを一覧表示","usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"},{"command": "/help","description": "短いヘルプの概要を表示"},{"command": "/commands","description": "生成されたコマンドカタログを表示"},{"command": "/tools","description": "現在のエージェントが今すぐ使用できるものを表示","usage_hint": "[compact|verbose]"},{"command": "/agentstatus","description": "利用可能な場合はプロバイダーの使用量／クォータを含むランタイム状態を表示"},{"command": "/tasks","description": "現在のセッションの実行中／最近のバックグラウンドタスクを一覧表示"},{"command": "/context","description": "コンテキストがどのように構成されるかを説明","usage_hint": "[list|detail|json]"},{"command": "/whoami","description": "送信者IDを表示"},{"command": "/skill","description": "名前を指定してスキルを実行","usage_hint": "<name> [input]"},{"command": "/btw","description": "セッションコンテキストを変更せずに補足質問をする","usage_hint": "<question>"},{"command": "/side","description": "セッションコンテキストを変更せずに補足質問をする","usage_hint": "<question>"},{"command": "/usage","description": "使用量フッターを制御するか、コスト概要を表示","usage_hint": "off|tokens|full|cost"}]}

{"slash_commands": [{"command": "/new","description": "新しいセッションを開始","usage_hint": "[model]","url": "https://gateway-host.example.com/slack/events"},{"command": "/help","description": "短いヘルプの概要を表示","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オブジェクトを使用できます。
• 設定のトークンは環境変数のフォールバックより優先されます。
• SLACK_BOT_TOKEN、SLACK_APP_TOKEN、SLACK_USER_TOKENの環境変数フォールバックは、それぞれデフォルトアカウントにのみ適用されます。
• userTokenのデフォルトは読み取り専用の動作（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 を使用します。
• トップレベルのチャンネルルートから表示可能な Slack スレッドが開始されると予想される場合、OpenClaw は対象となるルートを agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> にシードし、ルートと後続のスレッド返信が同じ OpenClaw セッションを共有するようにします。これは、app_mention イベント、明示的なボットメンションまたは設定済みのメンションパターンとの一致、および非 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 メンションされた場合にのみ応答するようにします。これを設定しない場合、ボットが参加しているスレッド内の返信は requireMention のゲートを迂回します。

返信のスレッド化の制御:

• channels.slack.channels.<id>.replyToMode: Slack のチャンネル／プライベートチャンネルメッセージに対するチャンネルごとの上書き
• 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 スレッドへ返信する場合、action: "send" と threadId または replyTo とともに replyBroadcast: true を設定すると、Slack にスレッド返信を親チャンネルにもブロードキャストするよう要求できます。これは Slack の chat.postMessage reply_broadcast フラグに対応し、テキストまたは Block Kit の送信でのみサポートされ、メディアのアップロードではサポートされません。

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

確認リアクション

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

デフォルトでは、Slack のネイティブなアシスタントスレッドステータスが切り替わる読み込みメッセージで進行状況を表示している間、確認リアクションは固定されたままです。代わりにキュー待ち／思考中／ツール／完了／エラーのリアクションライフサイクルを有効にするには、messages.statusReactions.enabled: true を設定します。

絵文字（ackReaction）

解決順序:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• エージェントアイデンティティの絵文字フォールバック（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"（デフォルト）: グループ内で、ボットがメンションされた場合（またはオプトインしたグループメンション可能対象に含まれる場合）にのみリアクションします。DM は対象外です。
• "off" / "none": リアクションしません。

{  messages: {    ackReaction: "eyes",    ackReactionScope: "all", // DM とグループでリアクション  },}

テキストストリーミング

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

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

簡潔な進行状況行を維持しながら、生のコマンド／実行テキストを非表示にする:

{  "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 に下書きプレビューを投稿して編集します。
• メディアおよびテキスト以外のペイロードは通常の配信にフォールバックします。
• メディア／エラーの最終結果は保留中のプレビュー編集をキャンセルします。対象となるテキスト／ブロックの最終結果は、その場でプレビューを編集できる場合にのみフラッシュされます。
• 返信の途中でストリーミングに失敗した場合、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.chunkMode と channels.slack.nativeStreaming は、channels.slack.streaming.chunkMode と channels.slack.streaming.nativeTransport のレガシーエイリアスです。
• レガシーエイリアスは実行時に読み取られません。永続化された Slack ストリーミング設定を正規キーに書き換えるには、openclaw doctor --fix を実行します。

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

typingReaction は、OpenClaw が返信を処理している間、受信した Slack メッセージに一時的なリアクションを追加し、実行の完了時に削除します。これは、デフォルトの「入力中...」ステータスインジケーターを使用するスレッド返信以外で特に役立ちます。

解決順序:

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

注意:

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

音声入力

現在 Slack で OpenClaw に話しかけるには、OpenClaw アプリに Slack のオーディオクリップを送信します。Slackbot のディクテーション用マイクは Slack が所有する別機能であり、アプリ API ではありません。

• **Slackbot 音声ディクテーション**は、ユーザーの非公開 Slackbot 会話内で動作します。Slack は録音を Slackbot プロンプトに変換しますが、Events API を介してサードパーティの Slack アプリに音声ファイル、ディクテーションイベント、プロンプト、入力ソースマーカーを送信しません。OpenClaw Slack plugin では、これを有効化したり受信したりできません。
• **Slack オーディオクリップ**は、OpenClaw の DM、チャンネル、またはスレッドに投稿できる、Slack に保存されたファイルです。OpenClaw はアクセス可能なクリップをボットトークンでダウンロードし、Slack のクリップ MIME メタデータを正規化して、共有の音声文字起こしパイプラインに送信します。推奨アプリマニフェストには、必要な files:read スコープが含まれています。

オーディオクリップと Slackbot ディクテーションでは、プライバシー上の意味が異なります。クリップには Slack のファイル保持ポリシーが適用され、OpenClaw が文字起こしのためにダウンロードします。一方、Slack によると、ディクテーション音声は保存されません。

requireMention: true が設定されたチャンネルでは、キャプションのないオーディオクリップでも、設定済みのメンションパターン（agents.list[].groupChat.mentionPatterns、フォールバックは messages.groupChat.mentionPatterns）を発話することでゲートを満たせます。OpenClaw はクリップをダウンロードまたは文字起こしする前に送信者を認可し、その後、文字起こしが一致した場合にのみ受け入れます。失敗した、または一致しなかった推測的な文字起こしは、ダウンロードしたクリップとともに破棄され、チャンネル履歴には保持されません。ネイティブ Slack の @bot ID は音声から推測できないため、発話名パターンを設定するか、入力したメンションを含めてください。文字起こしのエコーが有効な場合、エコーは受け入れ後にのみ送信されます。

メディア、チャンク分割、配信

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

スラッシュコマンドは、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 ではネイティブコマンドの自動モードはオフであるため、commands.native: "auto" では Slack ネイティブコマンドは有効になりません。

/help

ネイティブ引数メニューは、優先順位に従って次のいずれかとしてレンダリングされます：

• 十分に短い選択肢が 3～5 個：オーバーフロー（「...」）メニュー
• 選択肢が 100 個を超え、非同期の選択肢フィルタリングを利用可能：外部選択
• 選択肢が 1～2 個、またはエンコードされた値が選択項目には長すぎる選択肢がある場合：ボタンブロック
• それ以外（選択肢が 6～100 個、または非同期フィルタリングなしで 100 個を超える場合）：静的選択メニュー。メニューごとに 100 個の選択肢でチャンク分割されます

/think

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

ネイティブチャート

Slack の公開 data_visualization Block Kit ブロック は、メッセージ内に折れ線、棒、面、円グラフをレンダリングします。OpenClaw はポータブルな presentation chart ブロックをそのネイティブ形式にマッピングします。通常の chat:write メッセージアクセス以外に、追加の OAuth スコープ、 ファイルアップロード、画像レンダラー、Slack 設定は必要ありません。

{  "blocks": [    {      "type": "chart",      "chartType": "bar",      "title": "Quarterly revenue",      "categories": ["Q1", "Q2"],      "series": [{ "name": "Revenue", "values": [120, 145] }],      "xLabel": "Quarter"    }  ]}

ネイティブレンダリングの前に、Slack の制限が適用されます：

• タイトルと任意の軸ラベル：50 文字
• 円グラフ：1～12 個の正のセグメント
• 折れ線／棒／面：一意の名前を持つ 1～12 個の系列と、共有される 1～20 個のカテゴリ
• セグメント、カテゴリ、系列のラベル：20 文字
• すべての系列には、各カテゴリに対して有限値が 1 つ必要です。円グラフ以外の値は 負でもかまいません

各ネイティブチャートには、スクリーンリーダー、通知、セッションミラーリング、およびブロックをレンダリングできない クライアント向けのトップレベルテキスト表現も含まれます。他の OpenClaw チャンネルへの標準プレゼンテーション送信では、 ネイティブチャート対応を明示していない限り、同じ決定的なチャートデータをテキストとして受信します。 段階的ロールアウト中に Slack が invalid_blocks でチャートを拒否した場合、OpenClaw は 拒否されたネイティブデータブロックを削除し、同列のコントロールを保持したまま、 完全なチャート表現を表示テキストとして送信します。

現在、Slack はメッセージごとに最大 2 個の data_visualization ブロックを受け付けます。 プレゼンテーションに有効なチャートが 2 個を超えて含まれる場合、OpenClaw は順序を維持し、 各メッセージのチャートを 2 個以内にして、後続メッセージでネイティブレンダリングを続行します。

Slack の開発者向けリリース では、このブロックをアプリ向けの Block Kit 機能として説明しており、有料プランの制限は公開されていません。 Business+/Enterprise の利用資格に関する記述は、Slackbot による自動 AI チャート生成に適用されます。 これは、アプリが構造化済みの Block Kit チャートを送信することとは別です。 チャートはメッセージ専用ブロックであり、App Home、モーダル、Canvas のコンテンツではありません。

ネイティブテーブル

Slack の現在の data_table Block Kit ブロック は、構造化された行と列をメッセージ内にレンダリングします。OpenClaw は明示的なポータブル presentation table ブロックを data_table にマッピングします。Slack の 従来の table ブロックは使用しません。 通常の chat:write メッセージアクセス以外に、追加の OAuth スコープや Slack 設定は必要ありません。

{  "blocks": [    {      "type": "table",      "caption": "Open pipeline",      "headers": ["Account", "Stage", "ARR"],      "rows": [        ["Acme", "Won", 125000],        ["Globex", "Review", 82000]      ],      "rowHeaderColumnIndex": 0    }  ]}

OpenClaw はヘッダーセルと文字列セルを Slack の raw_text セルにマッピングします。数値セルは raw_number にマッピングされ、ネイティブの並べ替えとフィルタリング用に有限数値が保持されます。 rowHeaderColumnIndex が存在する場合、ゼロから始まるその列を Slack の行ヘッダーとして指定します。

公開されている Slack の data_table 制限は、ネイティブレンダリングの前に適用されます：

• 1～20 列
• 1～100 データ行と、ヘッダー行
• すべての行で同じセル数
• 1 メッセージ内の全テーブルセルを合計して最大 10,000 文字

メッセージが合計文字数制限内であれば、複数の有効なテーブルブロックをネイティブにレンダリングできます。 ネイティブの範囲内でレンダリングできないテーブルは、行やセルを失う代わりに、完全で決定的なテキストになります。 そのテキストが Slack メッセージ 1 件分を超える場合、送信とスラッシュ応答では順序付けられたテキストチャンクを使用します。 テーブルの編集では、既存メッセージから行を暗黙に切り捨てる代わりに、明示的なサイズエラーが発生します。

ポータブルプレゼンテーションから生成される各ネイティブテーブルには、スクリーンリーダー、通知、セッションミラーリング、 およびブロックをレンダリングできないクライアント向けのトップレベルテキスト表現も含まれます。 フォールバックではチャートとテーブルの生の値がリテラルのまま維持されるため、<@U123> のようなセルデータが Slack メンションになることはありません。 Slack がネイティブのチャートまたはテーブルブロックを invalid_blocks で拒否した場合、OpenClaw は 上限付きの 1 回の復旧処理ですべてのネイティブデータブロックを削除し、ボタンや選択項目などの有効な同列ブロックを保持して、 Slack の書式設定を無効にした完全な表示用チャートおよびテーブルテキストを送信します。スラッシュコマンド配信では、 コマンド全体で Slack の 5 回の response_url 予算を追跡します。各返信バッチの前に、 残りの呼び出し回数内に収まる完全なプランを選択するか、そのバッチを投稿する前に失敗します。

明示的な presentation テーブルブロックのみがネイティブテーブルに昇格されます。 Markdown のパイプテーブルは作成されたテキストのままです。OpenClaw はテーブル構造やセル型を推測しません。 既存の信頼済み Slack ネイティブ生成元は、channelData.slack.blocks を介して生のブロックを引き続き渡せます。 OpenClaw は有効な生の data_table セルからフォールバックテキストを生成しますが、 不正なカスタムブロックはキャプションまたは一般的な Block Kit フォールバックに縮退することがあります。 ポータブルなエージェント、CLI、plugin の出力では presentation を使用してください。

インタラクティブ返信

Slack はエージェントが作成したインタラクティブ返信コントロールをレンダリングできますが、この機能はデフォルトで無効です。 新しいエージェント、CLI、plugin の出力では、共有の presentation ボタンまたは選択ブロックを使用することを推奨します。これらは同じ 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 固有のエスケープハッチ用に維持し、新しいポータブルコントロールには共有プレゼンテーションを使用してください。

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

• 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 を維持し、pluginInteractiveData: "<namespace>:<payload>" をモーダルの private_metadata に配置します。

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

Slack でのネイティブ承認

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

• 実行および Plugin の承認は、Slack ネイティブの Block Kit プロンプトとして表示できます。
• channels.slack.execApprovals.* は引き続き、ネイティブ実行承認クライアントの有効化および DM／チャンネルルーティング設定です。
• 実行承認 DM は channels.slack.execApprovals.approvers または commands.ownerAllowFrom を使用します。
• Slack が発生元セッションのネイティブ承認クライアントとして有効な場合、または approvals.plugin が発生元の Slack セッションか Slack ターゲットにルーティングされる場合、Plugin の承認には Slack ネイティブボタンが使用されます。
• Plugin 承認 DM は、channels.slack.allowFrom の Slack Plugin 承認者、名前付きアカウントの allowFrom、またはアカウントのデフォルトルートを使用します。
• 承認者の認可は引き続き適用されます。実行専用の承認者は、Plugin 承認者でもない限り、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 人の実行承認者が解決される場合、Slack はネイティブ実行承認を自動的に有効にします。Slack Plugin の承認者が解決され、リクエストがネイティブクライアントのフィルターに一致する場合、Slack はこのネイティブクライアント経路を通じてネイティブ Plugin 承認も処理できます。Slack をネイティブ承認クライアントとして明示的に無効にするには、enabled: false を設定します。承認者が解決される場合にネイティブ承認を強制的に有効にするには、enabled: true を設定します。Slack の実行承認を無効にしても、approvals.plugin を通じて有効になっているネイティブ Slack Plugin 承認の配信は無効になりません。Plugin 承認の配信では、代わりに Slack Plugin 承認者が使用されます。

Slack の実行承認を明示的に設定していない場合のデフォルト動作：

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

明示的な Slack ネイティブ設定が必要なのは、承認者の上書き、フィルターの追加、または発生元チャットへの配信を有効にする場合のみです。

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

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

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

イベントと運用動作

• メッセージの編集／削除はシステムイベントにマッピングされます。
• スレッドのブロードキャスト（「Also send to channel」を使用したスレッド返信）は、通常のユーザーメッセージとして処理されます。
• リアクションの追加／削除イベントはシステムイベントにマッピングされます。
• メンバーの参加／退出、チャンネルの作成／名前変更、ピンの追加／削除イベントはシステムイベントにマッピングされます。
• 任意のプレゼンスポーリングにより、観測された人間の参加者の away から active への遷移を、その参加者が最も最近アクティブだった適格な Slack セッションにマッピングできます。デフォルトでは無効です。
• configWrites が有効な場合、channel_id_changed はチャンネル設定キーを移行できます。
• チャンネルのトピック／目的メタデータは信頼されていないコンテキストとして扱われ、ルーティングコンテキストに注入される場合があります。
• 該当する場合、スレッド開始メッセージと初期スレッド履歴コンテキストのシードは、設定済みの送信者許可リストでフィルタリングされます。
• ブロックアクション、ショートカット、モーダル操作は、豊富なペイロードフィールドを持つ構造化された Slack interaction: ... システムイベントを発行します。
  • ブロックアクション：選択された値、ラベル、ピッカー値、workflow_* メタデータ
  • グローバルショートカット：コールバックおよびアクターのメタデータ。アクターの直接セッションにルーティング
  • メッセージショートカット：コールバック、アクター、チャンネル、スレッド、選択されたメッセージのコンテキスト
  • モーダルの view_submission および view_closed イベント。ルーティングされたチャンネルメタデータとフォーム入力を含む

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

プレゼンスイベント

Slack は Events API または Socket Mode を通じてプレゼンスの変更を送信しません。代わりに OpenClaw は、通常の Slack アクセスチェックとルーティングチェックに合格したメッセージを送信した人間の参加者について、users.getPresence をポーリングできます。

{  channels: {    slack: {      presenceEvents: { mode: "auto" },      channels: {        C0123456789: { presenceEvents: { mode: "on" } },        C0987654321: { presenceEvents: { mode: "off" } },      },    },  },}

• off（デフォルト）：プレゼンスタイマーも Slack API 呼び出しも使用しません。
• auto：過去 24 時間にアクティブだった DM、MPIM、Slack スレッドを、観測対象の人間の参加者を最大 8 人として監視します。トップレベルのチャンネルセッションは除外されます。
• on：参加者数の上限なしで同じ会話を監視し、トップレベルのチャンネルセッションも含めます。チャンネルごとの上書きを使用して、特定のチャンネルを強制的に対象または除外します。

OpenClaw は Slack アカウントごとに 1 分あたり最大 45 人の一意のユーザーをポーリングし、最初の結果ではエージェントを起動せずに初期状態を設定し、観測された away から active への遷移時にのみエージェントを起動します。同じ人物が複数のスレッドに参加している場合でも、Slack アカウントおよびユーザーごとに永続的な 8 時間のクールダウンが適用されます。イベントは、その人物が最も最近アクティブだった適格な会話にのみルーティングされ、短い挨拶を 1 件送信するか判断する前に、メモリ／Wiki と既知のタイムゾーンコンテキストを参照するようエージェントに指示します。エージェントは何も送信しないこともできます。

ボットトークンには users:read が必要です。これは推奨マニフェストにすでに含まれています。Enterprise Grid の組織全体へのインストールでは、プレゼンスイベントを利用できません。

設定リファレンス

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

トラブルシューティング

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

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

添付メディアのリファレンス

Slack ファイルのダウンロードに成功し、サイズ制限内であれば、Slack はダウンロードしたメディアをエージェントターンに添付できます。音声クリップは文字起こしでき、画像ファイルはメディア理解パスを通すか、視覚対応の応答モデルに直接渡すことができます。その他のファイルは、ダウンロード可能なファイルコンテキストとして引き続き利用できます。

対応メディア形式

受信パイプライン

ファイル添付のある Slack メッセージを受信した場合：

1. OpenClaw はボットトークンを使用して、Slack の非公開 URL からファイルをダウンロードします。
2. 成功すると、ファイルはメディアストアに書き込まれます。
3. ダウンロードしたメディアのパスとコンテンツタイプが受信コンテキストに追加されます。
4. 音声クリップは共有文字起こしパイプラインにルーティングされます。同じコンテキストの画像添付は、画像対応のモデル／ツールパスで使用できます。
5. その他のファイルは、処理可能なツール向けのファイルメタデータまたはメディア参照として引き続き利用できます。

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

メッセージがスレッド内に届いた場合（thread_ts 親を持つ場合）：

• 返信自体に直接のメディアがなく、含まれているルートメッセージにファイルがある場合、Slack はルートファイルをスレッド開始時のコンテキストとして取り込めます。
• ルートファイルは、新規またはリセットされたスレッドセッションの初期化時にのみ取り込まれます。後続のテキストのみの返信では既存のセッションコンテキストが再利用され、ルートファイルが新しいメディアとして再添付されることはありません。
• 返信に直接添付されたファイルが、ルートメッセージの添付より優先されます。
• テキストがなくファイルのみのルートメッセージは、フォールバックでもファイルを含められるよう、添付プレースホルダーで表現されます。

複数添付の処理

1 件の Slack メッセージに複数のファイル添付が含まれる場合：

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

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

• サイズ上限：デフォルトはファイルごとに 20 MB。channels.slack.mediaMaxMb で設定できます。
• 音声文字起こしの上限：ダウンロードしたファイルを文字起こしプロバイダーまたは CLI に送信する場合も、tools.media.audio.maxBytes が適用されます。
• ダウンロード失敗：Slack が配信できないファイル、期限切れ URL、アクセス不能なファイル、サイズ上限を超えたファイル、Slack の認証／ログイン HTML レスポンスは、未対応形式として報告されるのではなくスキップされます。
• 視覚モデル：画像分析では、視覚に対応している場合はアクティブな応答モデルを使用し、それ以外の場合は agents.defaults.imageModel に設定された画像モデルを使用します。

既知の制限

関連ドキュメント

• メディア理解パイプライン
• 音声とボイスメモ
• PDF ツール

関連項目