Slack

​

选择传输方式

​

Relay 模式

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

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

​

用户身份（以真人身份发帖）

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（消息将以授权用户的身份发布）
   • 打开私信：im:write、mpim:write
2. 在 Event Subscriptions -> Subscribe to events on behalf of users 下，添加以下用户事件。不要仅将其添加到机器人事件列表：
   • message.channels
   • message.groups
   • message.im
   • message.mpim
3. 选择一种事件传输方式：
   • **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 调优字段。
• 只有 clientPingTimeout 具有 OpenClaw 默认值（15000）。仅在配置后，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": "显示或设置 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": "显示你的发送者身份"
    },
    {
      "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"
    }
  ]
}

​

令牌模型

• Bot 身份（默认）在 Socket Mode 下需要 botToken + appToken，在 HTTP 模式下需要 botToken + signingSecret。
• 用户身份在 Socket Mode 下需要 userToken + appToken，在 HTTP 模式下需要 userToken + signingSecret。它不使用 Bot 令牌。
• 中继模式需要 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 对 Bot 身份使用 botTokenStatus + appTokenStatus，对用户身份使用 userTokenStatus + appTokenStatus。

​

操作和门控

​

访问控制和路由

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

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

​

线程、会话和回复标签

• 私信路由为 direct；渠道路由为 channel；MPIM 路由为 group。
• Slack 路由绑定接受原始对等方 ID，以及 channel:C12345678、user:U12345678 和 <@U12345678> 等 Slack 目标形式。
• 使用默认的 session.dmScope=main 时，普通 Slack 私信会归并到智能体主会话。Agent View 根消息和现有 Assistant View 线程仍作为 :thread:<threadTs> 会话保持隔离。
• 渠道会话：agent:<agentId>:slack:channel:<channelId>。
• 普通的顶层渠道消息会保留在每渠道会话中，即使 replyToMode 为非 off 值。
• Slack 渠道、MPIM、Agent View 和 Assistant View 的线程回复使用父 Slack thread_ts 作为会话后缀（:thread:<threadTs>）。普通私信回复线程仍只是基础私信会话上的 UI 辅助功能。
• 当某个符合条件的顶层渠道根消息预计会启动可见的 Slack 线程时，OpenClaw 会将该根消息植入 agent:<agentId>:slack:channel:<channelId>:thread:<rootTs>，从而使根消息与后续线程回复共享一个 OpenClaw 会话。这适用于 app_mention 事件、显式 Bot 提及或已配置的提及模式匹配，以及 replyToMode 为非 off 值的 requireMention: false 渠道。
• channels.slack.thread.historyScope 的默认值为 thread；thread.inheritParent 的默认值为 false。
• channels.slack.thread.initialHistoryLimit 控制新线程会话启动时获取多少条现有线程消息（默认值为 20；设为 0 可禁用）。
• channels.slack.implicitMentions.replyToBot 控制对 Bot 自己消息的回复是否绕过提及门控（默认值为 true）。
• channels.slack.implicitMentions.threadParticipation 控制 Bot 已回复过的线程中的后续消息是否绕过提及门控（默认值为 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
• 智能体身份表情符号回退项（agents.entries.*.identity.emoji，否则为 "eyes" / 👀）

• Slack 要求使用短代码（例如 "eyes"）。
• 使用 "" 可为 Slack 账户或全局禁用该表情回应。

​

范围（messages.ackReactionScope）

• "all"：在私信和群组中添加表情回应，包括环境房间事件。
• "direct"：仅在私信中添加表情回应。
• "group-all"：对除环境房间事件以外的每条群组消息添加表情回应（不包括私信）。
• "group-mentions"（默认值）：在群组中添加表情回应，但仅限 Bot 被提及时（或在已选择启用的群组可提及对象中）。不包括私信。
• "off" / "none"：从不添加表情回应。

{
  messages: {
    ackReaction: "eyes",
    ackReactionScope: "all", // 在私信和群组中添加表情回应
  },
}

​

文本流式传输

• off：禁用实时预览流式传输。
• partial（默认值）：使用最新的部分输出替换预览文本。
• block：追加分块预览更新。
• progress：生成期间显示进度状态文本，然后发送最终文本。
• streaming.preview.toolProgress：启用草稿预览时，将工具/进度更新路由到同一条经过编辑的预览消息中（默认值：true）。设置 false 可保留单独的工具/进度消息。
• streaming.preview.commandText / streaming.progress.commandText：设为 status 可在隐藏原始命令/Exec 文本的同时保留紧凑的工具进度行（默认值：raw）。

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

• 必须有回复线程，原生文本流式传输和 Slack 助手线程状态才会显示。线程选择仍遵循 replyToMode。
• 当原生流式传输不可用或不存在回复线程时，频道、群聊和顶层私信根消息仍可使用常规草稿预览。
• 顶层 Slack 私信默认不使用线程，因此不会显示 Slack 的线程式原生流式传输/状态预览；OpenClaw 会改为在私信中发布并编辑草稿预览。
• 媒体和非文本载荷会回退到常规投递。
• 媒体/错误最终载荷会取消待处理的预览编辑；符合条件的文本/分块最终载荷仅在可以原地编辑预览时才会刷新。
• 如果流式传输在回复过程中失败，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 插件无法启用或接收该功能。
• **Slack 音频剪辑**是存储在 Slack 中的文件，可以发布到 OpenClaw 私信、频道或线程中。OpenClaw 使用 Bot 令牌下载可访问的剪辑，规范化 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": ["第一季度", "第二季度"],
      "series": [{ "name": "收入", "values": [120, 145] }],
      "xLabel": "季度"
    }
  ]
}

• 标题和可选的坐标轴标签：50 个字符
• 饼图：1-12 个正值扇区
• 折线图/柱状图/面积图：1-12 个名称唯一的系列，以及 1-20 个共享类别
• 扇区、类别和系列标签：20 个字符
• 每个系列必须为每个类别包含一个有限数值；非饼图数值 可以为负数

​

原生表格

{
  "blocks": [
    {
      "type": "table",
      "caption": "进行中的销售管线",
      "headers": ["客户", "阶段", "ARR"],
      "rows": [
        ["Acme", "已赢单", 125000],
        ["Globex", "审核", 82000]
      ],
      "rowHeaderColumnIndex": 0
    }
  ]
}

• 1-20 列
• 1-100 个数据行，另加表头行
• 每行的单元格数量相同
• 一条消息中所有表格单元格的字符总数最多为 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 会回退到原始文本回复，而不会发送无效的块载荷。

​

插件所有的模态框提交

• 将 callback_id 设置为 openclaw:<namespace>:<payload>。
• 或者保留现有的 callback_id，并将 pluginInteractiveData: "<namespace>:<payload>" 放入模态框的 private_metadata 中。

​

Slack 中的原生审批

• Exec 和插件审批可以渲染为 Slack 原生 Block Kit 提示。
• channels.slack.execApprovals.* 仍是原生 Exec 审批客户端的启用及私信/频道路由配置。
• Exec 审批私信使用 channels.slack.execApprovals.approvers 或 commands.ownerAllowFrom。
• 当 Slack 被启用为发起会话的原生审批客户端，或者 approvals.plugin 路由到发起的 Slack 会话或 Slack 目标时，插件审批会使用 Slack 原生按钮。
• 插件审批私信使用 channels.slack.allowFrom 中的 Slack 插件审批者、具名账户的 allowFrom，或账户默认路由。
• 仍会强制执行审批者授权：仅有 Exec 审批权限的审批者无法批准插件请求，除非他们同时也是插件审批者。

• 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 小时内活跃的私信、MPIM 和 Slack 线程，最多观察 8 名人类参与者。不包括顶层频道会话。
• 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 文件顺序。
• 一个附件下载失败不会阻塞其他附件。

​

大小、下载和模型限制

• 大小上限：默认每个文件 20 MB。可通过 channels.slack.mediaMaxMb 配置。
• 音频转录上限：将下载的文件发送给转录提供商或 CLI 时，所选支持音频的 tools.media.models[] 条目的 maxBytes 同样适用。
• 下载失败：Slack 无法提供的文件、已过期的 URL、无法访问的文件、超出大小限制的文件，以及 Slack 身份验证/登录 HTML 响应都会被跳过，而不会被报告为不支持的格式。
• 视觉模型：当活动回复模型支持视觉时，图像分析会使用该模型；否则使用在 agents.defaults.imageModel 中配置的图像模型。

​

已知限制

​

相关文档

• 媒体理解流水线
• 音频和语音留言
• PDF 工具

​

相关内容