Slack

​

トランスポートの選択

​

リレーモード

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

​

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

​

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

{
  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 URL

{
  "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"
      ]
    }
  }
}

{
  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 plugins install @openclaw/slack

​

クイックセットアップ

{
  "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
    },
    "agent_view": {
      "agent_description": "OpenClaw は Slack Agent View の会話を 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",
        "app_context_changed",
        "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
    },
    "agent_view": {
      "agent_description": "OpenClaw は Slack Agent View の会話を 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",
        "app_context_changed",
        "message.channels",
        "message.groups",
        "message.im"
      ]
    }
  }
}

export SLACK_APP_TOKEN=slack-app-token-example
export SLACK_BOT_TOKEN=slack-bot-token-example
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=slack-app-token-example
SLACK_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
    },
    "agent_view": {
      "agent_description": "OpenClaw は Slack Agent View の会話を 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",
        "app_context_changed",
        "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
    },
    "agent_view": {
      "agent_description": "OpenClaw は Slack Agent View の会話を 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",
        "app_context_changed",
        "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-example
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

​

ユーザー ID（実在の人物として投稿）

1. OAuth & Permissions -> User Token Scopes で、次のユーザースコープ権限を追加します：
   • 履歴：channels:history、groups:history、im:history、mpim:history
   • 会話の検索：channels:read、groups:read、im:read、mpim:read
   • ユーザー：users:read
   • 投稿：chat:write（メッセージは認可したユーザーとして投稿されます）
   • DM の開始：im:write、mpim:write
2. Event Subscriptions -> Subscribe to events on behalf of users で、次のユーザーイベントを追加します。ボットイベントのリストだけには追加しないでください：
   • message.channels
   • message.groups
   • message.im
   • message.mpim
3. イベント伝送方式を 1 つ選択します：
   • **Socket Mode：**Socket Mode を有効にし、connections:write を持つアプリレベルトークンを作成します。appToken として設定します。
   • **HTTP Request URL：**Event Subscriptions で公開 OpenClaw Slack エンドポイントを指定し、Basic Information -> App Credentials -> Signing Secret をコピーします。signingSecret として設定します。
4. アプリをインストールまたは再インストールし、対象の人間として認可して、生成されたユーザー OAuth トークンを userToken にコピーします。

{
  channels: {
    slack: {
      identity: "user",
      userToken: "<xoxp>",
      appToken: "<xapp>",
    },
  },
}

{
  channels: {
    slack: {
      identity: "user",
      mode: "http",
      userToken: "<xoxp>",
      signingSecret: "<signing-secret>",
      webhookPath: "/slack/events",
    },
  },
}

​

Socket Mode の伝送設定

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

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

​

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

{
  "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
    },
    "agent_view": {
      "agent_description": "OpenClaw は Slack Agent View の会話を 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",
        "app_context_changed",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

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

​

マニフェストの追加設定

{
  "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": "実行のデフォルトを表示または設定",
      "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": "/login",
      "description": "Codex ログインをペアリング",
      "usage_hint": "[codex|openai]"
    },
    {
      "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"
    }
  ]
}

​

トークンモデル

• ボット ID（デフォルト）には、Socket Mode の場合は botToken + appToken、HTTP モードの場合は botToken + signingSecret が必要です。
• ユーザー ID には、Socket Mode の場合は userToken + appToken、HTTP モードの場合は userToken + 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 では、 ボット ID に botTokenStatus + appTokenStatus、 ユーザー ID に userTokenStatus + appTokenStatus を使用します。

​

アクションとゲート

​

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

{
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        C12345678: { enabled: true, requireMention: true },
      },
    },
  },
}

{
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        "#eng-my-channel": { enabled: true, requireMention: true },
      },
    },
  },
}

​

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

• DM は direct、チャンネルは channel、MPIM は group としてルーティングされます。
• Slack ルートバインディングは、生のピア ID に加え、channel:C12345678、user:U12345678、<@U12345678> などの Slack ターゲット形式を受け付けます。
• デフォルトの session.dmScope=main では、通常の Slack DM はエージェントのメインセッションに統合されます。Agent View のルートと既存の Assistant View スレッドは、:thread:<threadTs> セッションとして分離されたままです。
• チャンネルセッション：agent:<agentId>:slack:channel:<channelId>。
• 通常のトップレベルのチャンネルメッセージは、replyToMode が off 以外の場合でも、チャンネルごとのセッションに残ります。
• Slack チャンネル、MPIM、Agent View、Assistant View のスレッド返信では、親 Slack の thread_ts がセッションのサフィックス（:thread:<threadTs>）に使用されます。通常の DM 返信スレッドは、ベースの DM セッション上の UI 機能として残ります。
• OpenClaw は、表示される Slack スレッドを開始すると見込まれる対象のトップレベルチャンネルルートを agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> にシードし、ルートとその後のスレッド返信が同じ OpenClaw セッションを共有するようにします。これは、app_mention イベント、明示的なボットメンションまたは設定済みメンションパターンとの一致、および replyToMode が off 以外に設定された requireMention: false チャンネルに適用されます。
• channels.slack.thread.historyScope のデフォルトは thread、thread.inheritParent のデフォルトは false です。
• channels.slack.thread.initialHistoryLimit は、新しいスレッドセッションの開始時に取得する既存スレッドメッセージ数を制御します（デフォルトは 20。無効にするには 0 を設定）。
• channels.slack.implicitMentions.replyToBot は、ボット自身のメッセージへの返信がメンションゲートを回避するかどうかを制御します（デフォルトは true）。
• channels.slack.implicitMentions.threadParticipation は、ボットが返信したスレッドでの後続メッセージがメンションゲートを回避するかどうかを制御します（デフォルトは true）。これらの後続メッセージで新たな明示的メンションを必須にするには、false に設定します。openclaw doctor --fix は、以前の channels.slack.thread.requireExplicitMention キーを、この肯定形の正規フラグへ移行します。
• アカウントの上書き設定は channels.slack.accounts.<id>.implicitMentions、共有デフォルトは channels.defaults.implicitMentions にあります。

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

​

確認リアクション

​

絵文字（ackReaction）

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

• Slack ではショートコード（たとえば "eyes"）が必要です。
• Slack アカウントまたはグローバルでリアクションを無効にするには、"" を使用します。

​

スコープ（messages.ackReactionScope）

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

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

​

テキストストリーミング

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

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

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

{
  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 のレガシーエイリアスです。
• レガシーエイリアスは実行時には読み込まれません。openclaw doctor --fix を実行して、永続化された Slack ストリーミング設定を正規キーに書き換えてください。

​

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

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

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

​

音声入力

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

​

メディア、分割、および配信

​

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

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

/openclaw /help

• Slack ではネイティブコマンドの自動モードがオフであるため、commands.native: "auto" では Slack ネイティブコマンドは有効になりません。

/help

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

/think

​

ネイティブチャート

{
  "blocks": [
    {
      "type": "chart",
      "chartType": "bar",
      "title": "四半期売上高",
      "categories": ["Q1", "Q2"],
      "series": [{ "name": "売上高", "values": [120, 145] }],
      "xLabel": "四半期"
    }
  ]
}

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

​

ネイティブテーブル

{
  "blocks": [
    {
      "type": "table",
      "caption": "進行中のパイプライン",
      "headers": ["アカウント", "ステージ", "ARR"],
      "rows": [
        ["Acme", "獲得済み", 125000],
        ["Globex", "レビュー", 82000]
      ],
      "rowHeaderColumnIndex": 0
    }
  ]
}

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

​

インタラクティブな返信

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

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

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

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

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

​

Plugin が所有するモーダル送信

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

​

Slack のネイティブ承認

• 実行および 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、名前付きアカウントの allowFrom、またはアカウントのデフォルトルートから取得した Slack Plugin 承認者が使用されます。
• 承認者の認可は引き続き適用されます。実行専用の承認者は、Plugin 承認者でもない限り、Plugin リクエストを承認できません。

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

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

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

​

イベントと運用動作

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

​

プレゼンスイベント

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

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

​

設定リファレンス

​

トラブルシューティング

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

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

openclaw pairing list slack

​

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

​

対応するメディアタイプ

​

受信パイプライン

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

​

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

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

​

複数添付ファイルの処理

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

​

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

• サイズ上限: デフォルトはファイルごとに 20 MB。channels.slack.mediaMaxMb で設定できます。
• 音声文字起こしの上限: ダウンロードされたファイルが文字起こしプロバイダーまたは CLI に送信される場合、選択された音声対応 tools.media.models[] エントリの maxBytes も適用されます。
• ダウンロード失敗: Slack が提供できないファイル、期限切れの URL、アクセスできないファイル、サイズ上限を超えたファイル、Slack の認証/ログイン HTML 応答は、未対応形式として報告されるのではなくスキップされます。
• ビジョンモデル: 画像分析では、ビジョンに対応している場合は有効な返信モデルを使用し、それ以外の場合は agents.defaults.imageModel で設定された画像モデルを使用します。

​

既知の制限

​

関連ドキュメント

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

​

関連項目