--- read_when: - Slack のセットアップまたは Slack ソケット/HTTP モードのデバッグ summary: Slack のセットアップとランタイム動作（ソケットモード + HTTP リクエスト URL） title: Slack x-i18n: generated_at: "2026-05-11T20:21:48Z" model: gpt-5.5 provider: openai source_hash: 34e740fd5cb0ca936edce1843316cde17570d77778bdf4fc761cad77c51ee9cf source_path: channels/slack.md workflow: 16 --- DM とチャンネル向けに Slack アプリ連携で本番運用可能です。デフォルトのモードは Socket Mode です。HTTP Request URLs もサポートされています。 Slack の DM はデフォルトでペアリングモードになります。 ネイティブコマンドの動作とコマンドカタログ。 チャンネル横断の診断と修復プレイブック。 ## Socket Mode または HTTP Request URLs の選択 どちらのトランスポートも本番運用可能で、メッセージング、スラッシュコマンド、App Home、インタラクティビティについて機能は同等です。機能ではなくデプロイ形態で選択してください。 | 観点 | Socket Mode（デフォルト） | HTTP Request URLs | | ---------------------------- | ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------- | | 公開 Gateway URL | 不要 | 必須（DNS、TLS、リバースプロキシまたはトンネル） | | アウトバウンドネットワーク | `wss-primary.slack.com` へのアウトバウンド WSS に到達可能である必要があります | アウトバウンド WS なし。インバウンド HTTPS のみ | | 必要なトークン | Bot トークン（`xoxb-...`）+ `connections:write` 付き App-Level Token（`xapp-...`） | Bot トークン（`xoxb-...`）+ Signing Secret | | 開発用ノート PC / ファイアウォール内 | そのまま動作します | 公開トンネル（ngrok、Cloudflare Tunnel、Tailscale Funnel）またはステージング Gateway が必要 | | 水平スケーリング | アプリごと、ホストごとに Socket Mode セッションは 1 つ。複数の Gateway には別々の Slack アプリが必要 | ステートレスな POST ハンドラー。複数の Gateway レプリカがロードバランサーの背後で 1 つのアプリを共有可能 | | 1 つの Gateway での複数アカウント | サポートされています。各アカウントが独自の WS を開きます | サポートされています。登録が衝突しないよう、各アカウントに一意の `webhookPath`（デフォルトは `/slack/events`）が必要 | | スラッシュコマンドのトランスポート | WS 接続経由で配信されます。`slash_commands[].url` は無視されます | Slack が `slash_commands[].url` に POST します。コマンドをディスパッチするにはこのフィールドが必須です | | リクエスト署名 | 使用しません（認証は App-Level Token） | Slack がすべてのリクエストに署名します。OpenClaw は `signingSecret` で検証します | | 接続切断時の復旧 | Slack SDK が自動再接続します。Gateway の pong-timeout トランスポート調整が適用されます | 切断される永続接続はありません。リトライは Slack からのリクエスト単位です | **Socket Mode を選択**するのは、単一 Gateway ホスト、開発用ノート PC、`*.slack.com` へのアウトバウンド到達は可能だがインバウンド HTTPS を受け付けられないオンプレミスネットワークの場合です。 **HTTP Request URLs を選択**するのは、ロードバランサーの背後で複数の Gateway レプリカを実行する場合、アウトバウンド WSS はブロックされているがインバウンド HTTPS は許可されている場合、またはすでにリバースプロキシで Slack Webhook を終端している場合です。 ## クイックセットアップ [api.slack.com/apps](https://api.slack.com/apps/new) を開く → **Create New App** → **From a manifest** → ワークスペースを選択 → 下のいずれかのマニフェストを貼り付け → **Next** → **Create**。 ```json Recommended { "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" ] } } } ``` ```json Minimal { "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" ] } } } ``` **Recommended** は、バンドルされた Slack plugin の完全な機能セットに対応します: App Home、スラッシュコマンド、ファイル、リアクション、ピン、グループ DM、絵文字/ユーザーグループの読み取り。ワークスペースポリシーでスコープが制限される場合は **Minimal** を選択してください。これは DM、チャンネル/グループ履歴、メンション、スラッシュコマンドをカバーしますが、ファイル、リアクション、ピン、グループ DM（`mpim:*`）、`emoji:read`、`usergroups:read` は含みません。スコープごとの根拠と、追加のスラッシュコマンドのような追加オプションについては、[マニフェストとスコープのチェックリスト](#manifest-and-scope-checklist) を参照してください。 Slack がアプリを作成した後: - **Basic Information → App-Level Tokens → Generate Token and Scopes**: `connections:write` を追加し、保存して、`xapp-...` 値をコピーします。 - **Install App → Install to Workspace**: `xoxb-...` Bot User OAuth Token をコピーします。 推奨される SecretRef セットアップ: ```bash 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 ``` env フォールバック（デフォルトアカウントのみ）: ```bash SLACK_APP_TOKEN=xapp-... SLACK_BOT_TOKEN=xoxb-... ``` ```bash openclaw gateway ``` [api.slack.com/apps](https://api.slack.com/apps/new) を開く → **Create New App** → **From a manifest** → ワークスペースを選択 → 下のいずれかのマニフェストを貼り付け → `https://gateway-host.example.com/slack/events` を公開 Gateway URL に置き換え → **Next** → **Create**。 ```json Recommended { "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" } } } ``` ```json 最小構成 { "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" } } } ``` **推奨** は同梱 Slack Plugin の全機能セットと一致します。**最小構成** は制限の厳しいワークスペース向けに、ファイル、リアクション、ピン、グループ DM (`mpim:*`)、`emoji:read`、`usergroups:read` を省きます。スコープごとの根拠は [マニフェストとスコープのチェックリスト](#manifest-and-scope-checklist) を参照してください。 3 つの URL フィールド (`slash_commands[].url`、`event_subscriptions.request_url`、`interactivity.request_url` / `message_menu_options_url`) はすべて同じ OpenClaw エンドポイントを指します。Slack のマニフェストスキーマではそれぞれ別名が必要ですが、OpenClaw はペイロード種別でルーティングするため、単一の `webhookPath` (デフォルトは `/slack/events`) で十分です。`slash_commands[].url` のないスラッシュコマンドは、HTTP モードでは通知なく no-op になります。 Slack がアプリを作成した後: - **Basic Information → App Credentials**: リクエスト検証用の **Signing Secret** をコピーします。 - **Install App → Install to Workspace**: `xoxb-...` Bot User OAuth Token をコピーします。 推奨 SecretRef 設定: ```bash 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 ``` 複数アカウントの HTTP では一意の Webhook パスを使う 登録が衝突しないように、各アカウントに個別の `webhookPath` (デフォルトは `/slack/events`) を指定します。 ```bash openclaw gateway ``` ## Socket Mode トランスポート調整 OpenClaw は、Socket Mode ではデフォルトで Slack SDK クライアントの pong タイムアウトを 15 秒に設定します。ワークスペースまたはホスト固有の調整が必要な場合にのみ、トランスポート設定を上書きしてください。 ```json5 { 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 のデフォルト): ```json { "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 が必要です。 ```json { "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 用に引き続き有効です。 単一の設定済みコマンドの代わりに、複数の [ネイティブスラッシュコマンド](#commands-and-slash-behavior) を細かく使い分けられます。 - `/status` コマンドは予約済みのため、`/status` ではなく `/agentstatus` を使用します。 - 一度に利用可能にできるスラッシュコマンドは 25 個までです。 既存の `features.slash_commands` セクションを、[利用可能なコマンド](/ja-JP/tools/slash-commands#command-list) のサブセットに置き換えます。 ```json { "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 or max-age " }, { "command": "/think", "description": "Set the thinking level", "usage_hint": "" }, { "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= security= ask= node=" }, { "command": "/model", "description": "Show or set the model", "usage_hint": "[name|#|status]" }, { "command": "/models", "description": "List providers/models", "usage_hint": "[provider] [page] [limit=|size=|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": " [input]" }, { "command": "/btw", "description": "Ask a side question without changing session context", "usage_hint": "" }, { "command": "/side", "description": "Ask a side question without changing session context", "usage_hint": "" }, { "command": "/usage", "description": "Control the usage footer or show cost summary", "usage_hint": "off|tokens|full|cost" } ] } ``` 上記の Socket Mode と同じ `slash_commands` リストを使用し、すべてのエントリに `"url": "https://gateway-host.example.com/slack/events"` を追加します。例: ```json { "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" } ] } ``` リスト内のすべてのコマンドで、その `url` 値を繰り返します。 送信メッセージでデフォルトの Slack アプリ ID ではなく、アクティブなエージェント ID（カスタムユーザー名とアイコン）を使用したい場合は、`chat:write.customize` bot スコープを追加します。 絵文字アイコンを使う場合、Slack は `:emoji_name:` 構文を想定します。 `channels.slack.userToken` を設定する場合、一般的な読み取りスコープは次のとおりです。 - `channels:history`, `groups:history`, `im:history`, `mpim:history` - `channels:read`, `groups:read`, `im:read`, `mpim:read` - `users:read` - `reactions:read` - `pins:read` - `emoji:read` - `search:read`（Slack 検索の読み取りに依存する場合） ## トークンモデル - 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 または別の非インラインシークレットソースを通じて設定されているが、現在のコマンド/ランタイムパスでは 実際の値を解決できなかったことを意味します。 - HTTP モードでは `signingSecretStatus` が含まれます。Socket Mode では、 必須のペアは `botTokenStatus` + `appTokenStatus` です。 actions/directory の読み取りでは、設定されている場合にユーザートークンが優先されることがあります。書き込みでは bot トークンが引き続き優先されます。ユーザートークンでの書き込みは、`userTokenReadOnly: false` かつ bot トークンが利用できない場合にのみ許可されます。 ## アクションとゲート Slack アクションは `channels.slack.actions.*` で制御されます。 現在の Slack ツールで利用可能なアクショングループ: | グループ | デフォルト | | ---------- | ------- | | messages | 有効 | | reactions | 有効 | | pins | 有効 | | memberInfo | 有効 | | emojiList | 有効 | 現在の Slack メッセージアクションには、`send`、`upload-file`、`download-file`、`read`、`edit`、`delete`、`pin`、`unpin`、`list-pins`、`member-info`、`emoji-list` が含まれます。`download-file` は受信ファイルプレースホルダーに表示される Slack ファイル ID を受け取り、画像の場合は画像プレビューを、それ以外のファイルタイプの場合はローカルファイルメタデータを返します。 ## アクセス制御とルーティング `channels.slack.dmPolicy` は DM アクセスを制御します。`channels.slack.allowFrom` は正規の DM 許可リストです。 - `pairing`（デフォルト） - `allowlist` - `open`（`channels.slack.allowFrom` に `"*"` を含める必要があります） - `disabled` DM フラグ: - `dm.enabled`（デフォルト true） - `channels.slack.allowFrom` - `dm.allowFrom`（レガシー） - `dm.groupEnabled`（グループ DM のデフォルトは false） - `dm.groupChannels`（任意の MPIM 許可リスト） マルチアカウントの優先順位: - `channels.slack.accounts.default.allowFrom` は `default` アカウントにのみ適用されます。 - 名前付きアカウントは、独自の `allowFrom` が未設定の場合に `channels.slack.allowFrom` を継承します。 - 名前付きアカウントは `channels.slack.accounts.default.allowFrom` を継承しません。 レガシーの `channels.slack.dm.policy` と `channels.slack.dm.allowFrom` は互換性のために引き続き読み取られます。`openclaw doctor --fix` は、アクセスを変更せずに実行できる場合、それらを `dmPolicy` と `allowFrom` に移行します。 DM でのペアリングは `openclaw pairing approve slack ` を使用します。 `channels.slack.groupPolicy` はチャンネル処理を制御します。 - `open` - `allowlist` - `disabled` チャンネル許可リストは `channels.slack.channels` 配下にあり、設定キーとして **安定した Slack チャンネル ID**（例: `C12345678`）を使用する必要があります。 ランタイムの注意: `channels.slack` が完全に欠落している場合（env のみのセットアップ）、ランタイムは `groupPolicy="allowlist"` にフォールバックし、警告をログに記録します（`channels.defaults.groupPolicy` が設定されている場合でも）。 名前/ID 解決: - チャンネル許可リストエントリと DM 許可リストエントリは、トークンアクセスで可能な場合に起動時に解決されます - 解決できなかったチャンネル名エントリは設定どおり保持されますが、デフォルトではルーティングで無視されます - 受信認可とチャンネルルーティングはデフォルトで ID 優先です。直接的なユーザー名/slug マッチングには `channels.slack.dangerouslyAllowNameMatching: true` が必要です 名前ベースのキー（`#channel-name` または `channel-name`）は、`groupPolicy: "allowlist"` では一致しません。チャンネル検索はデフォルトで ID 優先のため、名前ベースのキーは正常にルーティングされることがなく、そのチャンネル内のすべてのメッセージが黙ってブロックされます。これは、ルーティングにチャンネルキーが不要で、名前ベースのキーが機能しているように見える `groupPolicy: "open"` とは異なります。 常に Slack チャンネル ID をキーとして使用してください。確認するには、Slack でチャンネルを右クリック → **リンクをコピー** — ID（`C...`）が URL の末尾に表示されます。 正しい例: ```json5 { channels: { slack: { groupPolicy: "allowlist", channels: { C12345678: { allow: true, requireMention: true }, }, }, }, } ``` 誤った例（`groupPolicy: "allowlist"` では黙ってブロックされます）: ```json5 { channels: { slack: { groupPolicy: "allowlist", channels: { "#eng-my-channel": { allow: true, requireMention: true }, }, }, }, } ``` チャンネルメッセージはデフォルトでメンションゲートされます。 メンションソース: - 明示的なアプリメンション（`<@botId>`） - Slack ユーザーグループメンション（``）。bot ユーザーがそのユーザーグループのメンバーである場合。`usergroups:read` が必要です - メンション正規表現パターン（`agents.list[].groupChat.mentionPatterns`、フォールバック `messages.groupChat.mentionPatterns`） - bot への暗黙的な返信スレッド動作（`thread.requireExplicitMention` が `true` の場合は無効） チャンネルごとの制御（`channels.slack.channels.`。名前は起動時解決または `dangerouslyAllowNameMatching` 経由のみ）: - `requireMention` - `users`（許可リスト） - `allowBots` - `skills` - `systemPrompt` - `tools`, `toolsBySender` - `toolsBySender` キー形式: `channel:`、`id:`、`e164:`、`username:`、`name:`、または `"*"` ワイルドカード （レガシーの接頭辞なしキーは引き続き `id:` のみにマップされます） `allowBots` はチャンネルとプライベートチャンネルに対して保守的です。bot 作成のルームメッセージは、送信 bot がそのルームの `users` 許可リストに明示的に含まれている場合、または `channels.slack.allowFrom` からの明示的な Slack オーナー ID の少なくとも 1 つが現在ルームメンバーである場合にのみ受け付けられます。ワイルドカードと表示名のオーナーエントリは、オーナー存在の条件を満たしません。オーナー存在は Slack `conversations.members` を使用します。アプリにルームタイプに対応する読み取りスコープ（パブリックチャンネルでは `channels:read`、プライベートチャンネルでは `groups:read`）があることを確認してください。メンバー検索に失敗した場合、OpenClaw は bot 作成のルームメッセージをドロップします。 ## スレッド、セッション、返信タグ - DM は `direct` として、チャンネルは `channel` として、MPIM は `group` としてルーティングされます。 - Slack ルートバインディングは、raw ピア ID に加えて、`channel:C12345678`、`user:U12345678`、`<@U12345678>` などの Slack ターゲット形式を受け付けます。 - デフォルトの `session.dmScope=main` では、Slack DM はエージェントのメインセッションに集約されます。 - チャンネルセッション: `agent::slack:channel:`。 - スレッド返信は、該当する場合にスレッドセッションサフィックス（`:thread:`）を作成できます。 - OpenClaw が明示的なメンションを要求せずにトップレベルメッセージを処理するチャンネルでは、`off` 以外の `replyToMode` により、処理された各 root が `agent::slack:channel::thread:` にルーティングされるため、表示される Slack スレッドは最初のターンから 1 つの OpenClaw セッションに対応します。 - `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:]]` `message` ツールから明示的な Slack スレッド返信を行う場合、`action: "send"` と `threadId` または `replyTo` とともに `replyBroadcast: true` を設定すると、Slack にスレッド返信を親チャンネルにもブロードキャストするよう要求します。これは Slack の `chat.postMessage` の `reply_broadcast` フラグにマップされ、テキストまたは Block Kit 送信でのみサポートされ、メディアアップロードではサポートされません。 `message` ツール呼び出しが Slack スレッド内で実行され、同じチャンネルをターゲットにする場合、OpenClaw は通常 `replyToMode` に従って現在の Slack スレッドを継承します。代わりに新しい親チャンネルメッセージを強制するには、`action: "send"` または `action: "upload-file"` に `topLevel: true` を設定します。`threadId: null` も同じトップレベルのオプトアウトとして受け付けられます。 `replyToMode="off"` は、明示的な `[[reply_to_*]]` タグを含む Slack の **すべての** 返信スレッドを無効にします。これは、`"off"` モードでも明示的なタグが引き続き尊重される Telegram とは異なります。Slack スレッドはチャンネルからメッセージを隠しますが、Telegram の返信はインラインで表示されたままです。 ## Ack リアクション `ackReaction` は、OpenClaw が受信メッセージを処理している間に確認応答の絵文字を送信します。 解決順序: - `channels.slack.accounts..ackReaction` - `channels.slack.ackReaction` - `messages.ackReaction` - エージェント ID の絵文字フォールバック（`agents.list[].identity.emoji`、それ以外は "👀"） 注意: - Slack はショートコード（例: `"eyes"`）を想定します。 - Slack アカウントまたはグローバルでリアクションを無効にするには `""` を使用します。 ## テキストストリーミング `channels.slack.streaming` はライブプレビュー動作を制御します。 - `off`: ライブプレビューストリーミングを無効にします。 - `partial`（デフォルト）: プレビューテキストを最新の部分出力で置き換えます。 - `block`: チャンク化されたプレビュー更新を追加します。 - `progress`: 生成中に進行状況テキストを表示し、その後最終テキストを送信します。 - `streaming.preview.toolProgress`: ドラフトプレビューが有効な場合、ツール/進行状況更新を同じ編集済みプレビューメッセージにルーティングします（デフォルト: `true`）。別々のツール/進行状況メッセージを維持するには `false` を設定します。 - `streaming.preview.commandText` / `streaming.progress.commandText`: raw command/exec テキストを隠しながらコンパクトなツール進行状況行を維持するには `status` に設定します（デフォルト: `raw`）。 raw command/exec テキストを隠しながら、コンパクトな進行状況行を維持します。 ```json { "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 ネイティブテキストストリーミングの代わりに下書きプレビューを使用します。 ```json5 { 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` のランタイムエイリアスです。 - `openclaw doctor --fix` を実行して、永続化された Slack ストリーミング設定を正規キーに書き換えます。 ## 入力中リアクションのフォールバック `typingReaction` は、OpenClaw が返信を処理している間、受信 Slack メッセージに一時的なリアクションを追加し、実行が完了したら削除します。これは、デフォルトの「is typing...」ステータスインジケーターを使用するスレッド返信の外で特に有用です。 解決順序: - `channels.slack.accounts..typingReaction` - `channels.slack.typingReaction` 注記: - Slack はショートコードを想定します (例: `"hourglass_flowing_sand"`)。 - リアクションはベストエフォートで、返信または失敗パスの完了後にクリーンアップが自動的に試行されます。 ## メディア、チャンク化、配信 Slack ファイル添付は、Slack がホストするプライベート URL (トークン認証付きリクエストフロー) からダウンロードされ、取得に成功しサイズ制限が許す場合にメディアストアへ書き込まれます。ファイルプレースホルダーには Slack `fileId` が含まれるため、エージェントは `download-file` で元のファイルを取得できます。 ダウンロードには、制限付きのアイドルタイムアウトと総タイムアウトが使用されます。Slack ファイル取得が停止または失敗した場合でも、OpenClaw はメッセージ処理を継続し、ファイルプレースホルダーにフォールバックします。 ランタイムの受信サイズ上限は、`channels.slack.mediaMaxMb` で上書きされない限り、デフォルトで `20MB` です。 - テキストチャンクは `channels.slack.textChunkLimit` を使用します (デフォルト 4000) - `channels.slack.chunkMode="newline"` は段落優先の分割を有効にします - ファイル送信は Slack アップロード API を使用し、スレッド返信 (`thread_ts`) を含められます - 送信メディア上限は、設定されている場合は `channels.slack.mediaMaxMb` に従います。それ以外の場合、チャンネル送信はメディアパイプラインの MIME 種別デフォルトを使用します 推奨される明示的なターゲット: - DM は `user:` - チャンネルは `channel:` テキスト/ブロックのみの Slack DM はユーザー ID に直接投稿できます。ファイルアップロードとスレッド送信では、具体的な会話 ID が必要なため、まず Slack 会話 API 経由で DM を開きます。 ## コマンドとスラッシュ動作 スラッシュコマンドは、Slack では単一の設定済みコマンドまたは複数のネイティブコマンドとして表示されます。コマンドのデフォルトを変更するには `channels.slack.slashCommand` を設定します。 - `enabled: false` - `name: "openclaw"` - `sessionPrefix: "slack:slash"` - `ephemeral: true` ```txt /openclaw /help ``` ネイティブコマンドには、Slack アプリで [追加のマニフェスト設定](#additional-manifest-settings) が必要で、代わりに `channels.slack.commands.native: true` またはグローバル設定の `commands.native: true` で有効化します。 - Slack ではネイティブコマンドの自動モードが **オフ** のため、`commands.native: "auto"` では Slack ネイティブコマンドは有効になりません。 ```txt /help ``` ネイティブ引数メニューは、選択されたオプション値をディスパッチする前に確認モーダルを表示する適応型レンダリング戦略を使用します。 - 最大 5 個のオプション: ボタンブロック - 6〜100 個のオプション: 静的選択メニュー - 100 個を超えるオプション: インタラクティビティオプションハンドラーが利用可能な場合、非同期オプションフィルタリング付き外部選択 - Slack 制限を超過: エンコードされたオプション値はボタンにフォールバックします ```txt /think ``` スラッシュセッションは `agent::slack:slash:` のような分離キーを使用し、コマンド実行は引き続き `CommandTargetSessionKey` を使用してターゲット会話セッションへルーティングされます。 ## インタラクティブ返信 Slack はエージェントが作成したインタラクティブ返信コントロールをレンダリングできますが、この機能はデフォルトで無効です。 グローバルに有効化します。 ```json5 { channels: { slack: { capabilities: { interactiveReplies: true, }, }, }, } ``` または、1 つの Slack アカウントだけで有効化します。 ```json5 { 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 は無効なブロックペイロードを送信する代わりに、元のテキスト返信にフォールバックします。 ## Slack での実行承認 Slack は Web UI やターミナルにフォールバックする代わりに、インタラクティブボタンとインタラクションを備えたネイティブ承認クライアントとして動作できます。 - 実行承認はネイティブ 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` Slack は、`enabled` が未設定または `"auto"` で、少なくとも 1 人の承認者が解決される場合、ネイティブ実行承認を自動的に有効化します。Slack をネイティブ承認クライアントとして明示的に無効化するには `enabled: false` を設定します。 承認者が解決される場合にネイティブ承認を強制的にオンにするには `enabled: true` を設定します。 明示的な Slack 実行承認設定がない場合のデフォルト動作: ```json5 { commands: { ownerAllowFrom: ["slack:U12345678"], }, } ``` 明示的な Slack ネイティブ設定が必要なのは、承認者を上書きしたい、フィルターを追加したい、または送信元チャット配信にオプトインしたい場合だけです。 ```json5 { channels: { slack: { execApprovals: { enabled: true, approvers: ["U12345678"], target: "both", }, }, }, } ``` 共有 `approvals.exec` 転送は別物です。実行承認プロンプトを他のチャットまたは明示的な帯域外ターゲットにもルーティングする必要がある場合にのみ使用します。共有 `approvals.plugin` 転送も別物です。Slack ネイティブボタンは、それらのリクエストがすでに Slack に届いている場合、Plugin 承認を引き続き解決できます。 同一チャットの `/approve` は、すでにコマンドをサポートしている Slack チャンネルと DM でも機能します。完全な承認転送モデルについては、[実行承認](/ja-JP/tools/exec-approvals) を参照してください。 ## イベントと運用動作 - メッセージ編集/削除はシステムイベントにマッピングされます。 - スレッドブロードキャスト (「Also send to channel」のスレッド返信) は通常のユーザーメッセージとして処理されます。 - リアクション追加/削除イベントはシステムイベントにマッピングされます。 - メンバー参加/退出、チャンネル作成/名前変更、ピン追加/削除イベントはシステムイベントにマッピングされます。 - `channel_id_changed` は、`configWrites` が有効な場合にチャンネル設定キーを移行できます。 - チャンネルトピック/目的メタデータは信頼できないコンテキストとして扱われ、ルーティングコンテキストに注入される可能性があります。 - スレッド開始者と初期スレッド履歴コンテキストのシードは、該当する場合、設定された送信者許可リストでフィルタリングされます。 - ブロックアクションとモーダルインタラクションは、リッチなペイロードフィールドを持つ構造化された `Slack interaction: ...` システムイベントを出力します。 - ブロックアクション: 選択値、ラベル、ピッカー値、および `workflow_*` メタデータ - モーダル `view_submission` と `view_closed` イベント。ルーティングされたチャンネルメタデータとフォーム入力を含みます ## 設定リファレンス 主要リファレンス: [設定リファレンス - Slack](/ja-JP/gateway/config-channels#slack)。 - モード/認証: `mode`, `botToken`, `appToken`, `signingSecret`, `webhookPath`, `accounts.*` - DM アクセス: `dm.enabled`, `dmPolicy`, `allowFrom` (レガシー: `dm.policy`, `dm.allowFrom`), `dm.groupEnabled`, `dm.groupChannels` - 互換性トグル: `dangerouslyAllowNameMatching` (緊急回避用。必要な場合を除きオフのままにしてください) - チャンネルアクセス: `groupPolicy`, `channels.*`, `channels.*.users`, `channels.*.requireMention` - スレッド/履歴: `replyToMode`, `replyToModeByChatType`, `thread.*`, `historyLimit`, `dmHistoryLimit`, `dms.*.historyLimit` - 配信: `textChunkLimit`, `chunkMode`, `mediaMaxMb`, `streaming`, `streaming.nativeTransport`, `streaming.preview.toolProgress` - 展開プレビュー: `chat.postMessage` のリンク/メディアプレビュー制御用 `unfurlLinks`, `unfurlMedia` - 運用/機能: `configWrites`, `commands.native`, `slashCommand.*`, `actions.*`, `userToken`, `userTokenReadOnly` ## トラブルシューティング 次の順に確認します。 - `groupPolicy` - チャンネル許可リスト (`channels.slack.channels`) — **キーはチャンネル ID** (`C12345678`) である必要があり、名前 (`#channel-name`) ではありません。`groupPolicy: "allowlist"` では、チャンネルルーティングがデフォルトで ID 優先のため、名前ベースのキーは暗黙に失敗します。ID を見つけるには、Slack でチャンネルを右クリック → **リンクをコピー** — URL 末尾の `C...` 値がチャンネル ID です。 - `requireMention` - チャンネルごとの `users` 許可リスト 有用なコマンド: ```bash openclaw channels status --probe openclaw logs --follow openclaw doctor ``` 確認項目: - `channels.slack.dm.enabled` - `channels.slack.dmPolicy` (またはレガシー `channels.slack.dm.policy`) - ペアリング承認 / 許可リストエントリ - Slack アシスタント DM イベント: `drop message_changed` に言及する詳細ログは、通常、Slack がメッセージメタデータ内に復元可能な人間の送信者を持たない編集済みアシスタントスレッドイベントを送信したことを意味します ```bash openclaw pairing list slack ``` Slack アプリ設定で bot + app トークンと Socket Mode の有効化を検証します。 `openclaw channels status --probe --json` が `botTokenStatus` または `appTokenStatus: "configured_unavailable"` を表示する場合、その Slack アカウントは 設定されていますが、現在のランタイムが SecretRef ベースの値を解決できなかったことを示します。 確認事項: - 署名シークレット - Webhook パス - Slack リクエスト URL（イベント + インタラクティビティ + スラッシュコマンド） - HTTP アカウントごとに一意の `webhookPath` アカウントスナップショットに `signingSecretStatus: "configured_unavailable"` が表示される場合、 HTTP アカウントは設定済みですが、現在のランタイムは SecretRef によって裏付けられた署名シークレットを 解決できませんでした。 意図していたものが次のどちらかを確認してください: - Slack に登録された一致するスラッシュコマンドを使うネイティブコマンドモード（`channels.slack.commands.native: true`） - または単一スラッシュコマンドモード（`channels.slack.slashCommand.enabled: true`） `commands.useAccessGroups` とチャンネル/ユーザーの許可リストも確認してください。 ## 添付ファイルビジョンリファレンス Slack ファイルのダウンロードが成功し、サイズ制限が許す場合、Slack はダウンロードしたメディアをエージェントターンに添付できます。画像ファイルはメディア理解パスを通すか、ビジョン対応の返信モデルに直接渡すことができます。その他のファイルは、画像入力として扱われるのではなく、ダウンロード可能なファイルコンテキストとして保持されます。 ### サポートされるメディアタイプ | メディアタイプ | ソース | 現在の動作 | 注記 | | ------------------------------ | -------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | | JPEG / PNG / GIF / WebP 画像 | Slack ファイル URL | ダウンロードされ、ビジョン対応処理のためにターンへ添付される | ファイルごとの上限: `channels.slack.mediaMaxMb`（デフォルト 20 MB） | | PDF ファイル | Slack ファイル URL | ダウンロードされ、`download-file` や `pdf` などのツール向けのファイルコンテキストとして公開される | Slack の受信処理は PDF を画像ビジョン入力に自動変換しない | | その他のファイル | Slack ファイル URL | 可能な場合はダウンロードされ、ファイルコンテキストとして公開される | バイナリファイルは画像入力として扱われない | | スレッド返信 | スレッド開始メッセージのファイル | 返信に直接メディアがない場合、ルートメッセージのファイルをコンテキストとしてハイドレートできる | ファイルのみの開始メッセージは添付ファイルプレースホルダーを使用する | | 複数画像メッセージ | 複数の Slack ファイル | 各ファイルは個別に評価される | Slack 処理はメッセージごとに 8 ファイルに制限される | ### 受信パイプライン ファイル添付を含む Slack メッセージが到着すると: 1. OpenClaw はボットトークン（`xoxb-...`）を使用して、Slack のプライベート URL からファイルをダウンロードします。 2. 成功すると、ファイルはメディアストアに書き込まれます。 3. ダウンロードされたメディアパスとコンテンツタイプが受信コンテキストに追加されます。 4. 画像対応のモデル/ツールパスは、そのコンテキストの画像添付を使用できます。 5. 非画像ファイルは、それらを処理できるツール向けのファイルメタデータまたはメディア参照として引き続き利用できます。 ### スレッドルート添付ファイルの継承 メッセージがスレッド内に到着する場合（親 `thread_ts` を持つ）: - 返信自体に直接メディアがなく、含まれるルートメッセージにファイルがある場合、Slack はルートファイルをスレッド開始コンテキストとしてハイドレートできます。 - 直接返信の添付ファイルは、ルートメッセージの添付ファイルより優先されます。 - ファイルのみでテキストがないルートメッセージは添付ファイルプレースホルダーで表されるため、フォールバックはそのファイルを引き続き含められます。 ### 複数添付ファイルの処理 1 件の Slack メッセージに複数のファイル添付が含まれる場合: - 各添付ファイルはメディアパイプラインを通じて個別に処理されます。 - ダウンロードされたメディア参照はメッセージコンテキストに集約されます。 - 処理順序はイベントペイロード内の Slack のファイル順序に従います。 - 1 つの添付ファイルのダウンロード失敗が他の添付ファイルをブロックすることはありません。 ### サイズ、ダウンロード、モデルの制限 - **サイズ上限**: ファイルごとにデフォルト 20 MB。`channels.slack.mediaMaxMb` で設定可能です。 - **ダウンロード失敗**: Slack が提供できないファイル、期限切れの URL、アクセスできないファイル、サイズ超過ファイル、Slack 認証/ログイン HTML レスポンスは、非サポート形式として報告されるのではなくスキップされます。 - **ビジョンモデル**: 画像分析では、ビジョンをサポートしている場合はアクティブな返信モデルを使用し、そうでない場合は `agents.defaults.imageModel` に設定された画像モデルを使用します。 ### 既知の制限 | シナリオ | 現在の動作 | 回避策 | | -------------------------------------- | ------------------------------------------------------------------------ | -------------------------------------------------------------------------- | | 期限切れの Slack ファイル URL | ファイルはスキップされ、エラーは表示されない | Slack にファイルを再アップロードする | | ビジョンモデル未設定 | 画像添付はメディア参照として保存されるが、画像としては分析されない | `agents.defaults.imageModel` を設定するか、ビジョン対応の返信モデルを使用する | | 非常に大きい画像（デフォルトでは > 20 MB） | サイズ上限に従ってスキップされる | Slack が許可する場合は `channels.slack.mediaMaxMb` を増やす | | 転送/共有された添付ファイル | テキストと Slack ホストの画像/ファイルメディアはベストエフォート | OpenClaw スレッドで直接再共有する | | PDF 添付ファイル | ファイル/メディアコンテキストとして保存され、画像ビジョン経由に自動ルーティングされない | ファイルメタデータには `download-file` を使用し、PDF 分析には `pdf` ツールを使用する | ### 関連ドキュメント - [メディア理解パイプライン](/ja-JP/nodes/media-understanding) - [PDF ツール](/ja-JP/tools/pdf) - エピック: [#51349](https://github.com/openclaw/openclaw/issues/51349) — Slack 添付ファイルビジョンの有効化 - 回帰テスト: [#51353](https://github.com/openclaw/openclaw/issues/51353) - ライブ検証: [#51354](https://github.com/openclaw/openclaw/issues/51354) ## 関連 Slack ユーザーを Gateway にペアリングします。 チャンネルとグループ DM の動作。 受信メッセージをエージェントにルーティングします。 脅威モデルとハードニング。 設定のレイアウトと優先順位。 コマンドカタログと動作。