Slack

DM とチャンネル向けに、Slack アプリ連携経由で本番利用可能です。デフォルトモードは Socket Mode です。HTTP Request URLs もサポートされています。

# Socket Mode または HTTP Request URLs の選択

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

# クイックセットアップ

{
"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
},
"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",
"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
},
"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",
"message.channels",
"message.groups",
"message.im"
]
}
}
}

export SLACK_APP_TOKEN=xapp-...
export SLACK_BOT_TOKEN=xoxb-...
cat > 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" },
},
},
}
JSON5
openclaw config patch --file ./slack.socket.patch.json5 --dry-run
openclaw config patch --file ./slack.socket.patch.json5

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

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
},
"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",
"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
},
"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",
"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=xoxb-...
export 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",
},
},
}
JSON5
openclaw config patch --file ./slack.http.patch.json5 --dry-run
openclaw 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 の待機時間です。アプリメッセージとイベントはアプリケーション状態であり、トランスポートの生存性シグナルではありません。

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

基本の 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
    },
    "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",
        "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",
        "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 ビューを公開します。会話ペイロードやプライベート設定は含まれません。Messages タブは Slack DM 用に有効なままです。

{
"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": "/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, appToken, signingSecret, userToken はプレーンテキスト 文字列または SecretRef オブジェクトを受け付けます。
• 設定内のトークンは env フォールバックを上書きします。
• SLACK_BOT_TOKEN / SLACK_APP_TOKEN env フォールバックはデフォルトアカウントにのみ適用されます。
• userToken（xoxp-...）は設定専用（env フォールバックなし）で、デフォルトでは読み取り専用の動作（userTokenReadOnly: true）になります。

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

• Slack アカウント検査は、認証情報ごとの *Source と *Status フィールド（botToken, appToken, signingSecret, userToken）を追跡します。
• ステータスは available, configured_unavailable, missing のいずれかです。
• configured_unavailable は、アカウントが SecretRef または別の非インライン Secret ソースを通じて設定されているものの、現在のコマンド/ランタイムパスでは 実際の値を解決できなかったことを意味します。
• 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>。
• スレッド返信は、該当する場合にスレッドセッション接尾辞（:thread:<threadTs>）を作成できます。
• channels.slack.thread.historyScope のデフォルトは thread です。thread.inheritParent のデフォルトは false です。
• channels.slack.thread.initialHistoryLimit は、新しいスレッドセッションが開始されるときに取得する既存スレッドメッセージ数を制御します（デフォルト 20。無効にするには 0 を設定）。
• channels.slack.thread.requireExplicitMention（デフォルト false）: true の場合、暗黙的なスレッドメンションを抑制し、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>]]

# Ack リアクション

ackReaction は、OpenClaw が受信メッセージを処理している間に確認応答の絵文字を送信します。

解決順序:

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

メモ:

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

# テキストストリーミング

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

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

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

レガシーキー:

• channels.slack.streamMode (replace | status_final | append) は channels.slack.streaming.mode のレガシー実行時エイリアスです。
• boolean 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 メッセージに一時的なリアクションを追加し、実行が完了したら削除します。これは、デフォルトの「入力中...」ステータスインジケーターを使用するスレッド返信以外で特に役立ちます。

解決順序:

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

/help

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

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

/think

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

# インタラクティブ返信

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

# Slack での Exec 承認

Slack は Web UI やターミナルへのフォールバックではなく、インタラクティブボタンとインタラクションを備えたネイティブ承認クライアントとして動作できます。

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

これは、他のチャネルと同じ共有承認ボタン画面を使用します。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 はネイティブ Exec 承認を自動で有効にします。Slack をネイティブ承認クライアントとして明示的に無効にするには、enabled: false を設定します。 承認者が解決される場合にネイティブ承認を強制的に有効にするには、enabled: true を設定します。

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

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

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

{
  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 はチャネル設定キーを移行できます。
• チャネルのトピック/目的メタデータは信頼できないコンテキストとして扱われ、ルーティングコンテキストへ注入される場合があります。
• スレッド開始者と初期スレッド履歴コンテキストのシードは、該当する場合、設定された送信者許可リストによってフィルタリングされます。
• ブロックアクションとモーダルインタラクションは、豊富なペイロードフィールドを持つ構造化された Slack interaction: ... システムイベントを出力します:
  • ブロックアクション: 選択値、ラベル、ピッカー値、workflow_* メタデータ
  • ルーティングされたチャネルメタデータとフォーム入力を含むモーダル view_submission および view_closed イベント

# 設定リファレンス

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

# トラブルシューティング

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

openclaw pairing list slack

# 添付ファイルのビジョンリファレンス

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

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

# 受信パイプライン

ファイル添付を含む Slack メッセージが到着した場合:

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

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

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

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

# 複数添付の処理

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

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

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

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

# 既知の制限

# 関連ドキュメント

• メディア理解パイプライン
• PDF ツール
• Epic: #51349 — Slack 添付のビジョン有効化
• 回帰テスト: #51353
• ライブ検証: #51354

# 関連