Slack工作区未与OpenClaw通信，主因是App创建不全、权限缺失或网关未启动；需通过五种方式之一完成接入：一、Slack开发者平台创建App并启用Socket Mode；二、配置Bot Token必要权限范围；三、订阅关键事件并验证网关连接；四、使用配对码轻量接入；五、阿里云镜像一键注入Slack参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成 OpenClaw 的本地或云端部署，但 Slack 工作区尚未与 OpenClaw 建立通信连接，则可能是由于 Slack App 创建不完整、权限缺失或网关未启动所致。以下是接入 Slack 工作区的多种方法：
一、通过 Slack 官方开发者平台创建 App 并启用 Socket Mode
该方法适用于拥有 Slack 工作区管理权限的用户，可完全自主控制 App 配置与权限范围，确保事件推送与响应链路稳定可靠。
1、访问 https://api.slack.com/apps，点击右上角 Create New App → 选择 From scratch。
2、输入 App Name（如 OpenClaw-TeamBot），在 Workspace 下拉菜单中选择目标 Slack 工作区。
3、进入 Settings → Socket Mode，开启 Enable Socket Mode 开关。
4、在弹出对话框中为 Token 命名（如 openclaw-gateway-token），点击 Generate，复制以 xapp- 开头的 App-Level Token 并安全保存。
二、配置必需的 Bot Token 权限范围（Scopes）
缺少关键权限将导致 OpenClaw 在接收消息后无法回复或上传文件，所有权限必须在 OAuth & Permissions 页面中显式添加，不可跳过。
1、进入 Features → OAuth & Permissions → Bot Token Scopes → Add an OAuth Scope。
2、依次添加以下权限：app_mentions:read、channels:history、groups:history、im:history、chat:write、files:write。
3、完成添加后，点击页面右上角 Install to Workspace，授权安装至当前工作区。
三、订阅关键事件类型并验证网关连接
Slack 只有在明确被告知需监听哪些事件时，才会向 OpenClaw Gateway 推送消息；未订阅对应事件将导致机器人静默无响应。
1、进入 Features → Event Subscriptions，开启 Enable Events 开关。
2、在 Subscribe to bot events 区域，添加以下三项：app_mention、message.im、message.channels。
3、返回终端，执行 openclaw gateway status 确认服务运行中；若未运行，执行 openclaw gateway start 启动。
4、在 Slack 工作区任意频道中 @ 机器人发送任意文本，观察终端是否输出「连接成功」及事件日志。
四、使用配对码方式完成轻量级快速接入
当已部署 OpenClaw 且 gateway 服务处于运行状态时，该方法无需手动配置 Token 或权限，由系统自动生成临时配对凭证，适合测试环境或临时协作场景。
1、在终端中执行 openclaw gateway pair，获取 6 位数字配对码。
2、打开 Slack 客户端，在任意频道中向机器人发送消息：/openclaw pair 123456（替换为实际配对码）。
3、等待终端提示「配对完成」，随后在 Slack 中发送 @bot 测试消息，确认机器人正常响应。
五、通过阿里云镜像一键完成 Slack 参数注入
针对使用阿里云轻量应用服务器部署 OpenClaw 的用户，该方法利用预置脚本自动填充 Slack 凭证，避免手动编辑配置文件出错，特别适配海外节点直连 Slack 的网络环境。
1、登录阿里云控制台，进入已部署 OpenClaw 的 Lighthouse 实例远程终端。
2、执行 openclaw config，选择渠道为 Slack，进入交互式配置流程。
3、按提示依次填入：App-Level Token（xapp-...）、Bot User OAuth Token（xoxb-...）、Workspace ID。
4、配置完成后，系统自动重启 gateway 服务，并在终端输出「Slack channel linked」提示。
