OpenClaw 无缝接入 Slack 全图文实战指南

🚀 OpenClaw 无缝接入 Slack 全图文实战指南

本文档详细记录了如何将 OpenClaw AI 助手无缝集成到 Slack 工作区,采用最新的 Socket Mode(长连接模式),无需公网 IP 和复杂的 Webhook 验证即可实现双向通讯。

💡 背景备注 :这份文档基于老板(Jason)与 AI 秘书(Alice)于 2026年3月16日 在 GCP 云端服务器的实战踩坑经验总结。特别是针对 missing_scope 等权限拦截问题给出了明确的避坑指南。


🛠️ 核心准备

  • Slack 工作区管理员权限
  • 运行中的 OpenClaw 实例(Gateway)

Step 1: 创建 Slack App

  1. 访问 Slack API 控制台。
  2. 点击右上角的 Create New App -> 选择 From scratch。
  3. 填入 App Name(比如 OpenClaw-Alice),并选择您的 Workspace。

📸 此处插入截图:Create an app 对话框,填入名称并选择工作区


Step 2: 开启 Socket Mode (获取 App-Level Token)

由于 OpenClaw 默认使用 WebSocket 长连接模式来接收消息(不需要配置外网 Request URL),这一步必须开启。

  1. 在左侧导航栏找到 Settings -> Socket Mode。
  2. 打开 Enable Socket Mode 开关。
  3. 弹出的对话框中,为您的 Token 命名(如 openclaw-socket-token),系统会自动为其添加 connections:write 权限。
  4. 点击 Generate,复制并保存 生成的 App-Level Token (以 xapp- 开头)。

Step 3: 配置权限范围 (Bot Scopes) ------ ⚠️ 实战踩坑点!

机器人在 Slack 里能干什么,全看这里给了什么权限。如果权限给少了,OpenClaw 后台会疯狂报错 Error: An API error occurred: missing_scope!

  1. 左侧导航栏找到 Features -> OAuth & Permissions。
  2. 下拉找到 Scopes -> Bot Token Scopes ,点击 Add an OAuth Scope。
  3. 必须添加以下核心权限 :
    • app_mentions:read ------ 允许机器人在频道里被 @ 唤醒
    • channels:history / groups:history / im:history ------ 允许机器人读取频道、私聊的历史消息上下文
    • chat:write ------ 【关键!】 允许机器人发送文本消息(没有它机器人只能看不能回)
    • files:write ------ 【关键!】 允许机器人上传并发送图片、视频(比如我们在后台渲染的 Veo 4K 视频或架构图,缺了这个发不出去)

Step 4: 订阅事件 (Event Subscriptions)

告诉 Slack 哪些动作发生时,需要通知我们的 OpenClaw。

  1. 左侧导航栏找到 Features -> Event Subscriptions。
  2. 打开 Enable Events 开关。
  3. 下拉找到 Subscribe to bot events ,添加以下事件:
    • app_mention (接收群聊中的 @ 消息)
    • message.im (接收私聊消息)
    • message.channels / message.groups (接收公开/私密频道的普通消息)
  4. 点击页面右下角的 Save Changes 。

Step 5: 安装应用并获取 Bot Token

  1. 回到左侧导航栏 Settings -> Install App(或者回到 OAuth & Permissions 的最上方)。
  2. 点击 Install to Workspace ,并在弹出的授权页面点击 Allow (允许)。
  3. 复制并保存 生成的 Bot User OAuth Token (以 xoxb- 开头)。

Step 6: 邀请机器人进入频道

  • 在您的 Slack 客户端中,打开想要让 OpenClaw 工作的频道(Channel)。
  • 在聊天框输入 @OpenClaw-Alice (您给机器人取的名字) 并发送。
  • Slack 会提示您该机器人不在频道中,点击 Add to Channel 即可。

Step 7: 配置 OpenClaw 网关

拿到一前一后两个 Token (xapp-... 和 xoxb-...) 后,进入部署 OpenClaw 的服务器。

通过 CLI 配置(推荐):

bash 复制代码
# 1. 设置 Bot Token (负责发消息)
openclaw config set channels.slack.botToken "xoxb-您的BotToken"

# 2. 设置 App Token (负责建立长连接)
openclaw config set channels.slack.appToken "xapp-您的AppToken"

# 3. 开放群聊和私聊策略 (如果在内网/私人团队,可设为 open,否则建议设为 allowlist)
openclaw config set channels.slack.groupPolicy "open"
openclaw config set channels.slack.dmPolicy "open"

# 4. 启用 Slack 频道并重启 Gateway
openclaw config set channels.slack.enabled true
openclaw gateway restart

验证连通性:

运行 openclaw gateway status 或者去 Slack 里私聊机器人发送 hi。如果收到机器人的回复,配置即大功告成!🎉

相关推荐
严肃小白兔15 分钟前
第 10/24 期:深度神经网络的自动求导机制与梯度验证
人工智能·神经网络·dnn
火山引擎开发者社区20 分钟前
定档12.16-12.18!FORCE原动力大会上海见!
人工智能
努力的MM12334 分钟前
CAIE 二级和阿里云大模型 ACP 怎么选?企业 AI 工程与云平台开发能力对比
人工智能
老金带你玩AI35 分钟前
Kling Image 4.0来了!8K和组图直出,电商人的提效神器?
人工智能
孟健1 小时前
用 unslop 拯救 AI 生成网页的塑料感,7 分钟重构落地实测
前端·人工智能·ai编程
stormzhangV1 小时前
Google 重返第一梯队
人工智能·google·aigc
十有八七2 小时前
手搓 Agent(五):学会翻书——RAG,先查资料再回答
前端·人工智能·后端
阿里云大数据AI技术2 小时前
阿里云 Milvus 场景中心|一键部署你的AI应用
人工智能
京东云开发者2 小时前
Agent 研发工作系统:面向多需求并行端到端开发的设计与实践
人工智能
IT大白鼠3 小时前
当 AI 开始自动化渗透:FBI ARTEX 警报的防守对策
运维·人工智能·自动化