跳转到主要内容
使用 Socket Mode 向您的 Slack 工作区添加 AI 助手 —— 无需公共 URL。本指南适用于托管的 Claw 实例和私有部署的 LemonClaw。

​
前提条件

​
设置指南

1

创建 Slack 应用

  1. 访问 Slack API 并点击 Create New App
  2. 选择 From scratch
  3. 输入应用名称（例如 “AI Assistant”）并选择您的工作区
  4. 点击 Create App
2

启用 Socket Mode

  1. 在左侧边栏中，前往 Socket Mode
  2. 将 Enable Socket Mode 切换为 ON
  3. 为 token 命名（例如 “claw-socket”）并点击 Generate
  4. 复制 App-Level Token（以 xapp- 开头）—— 您稍后会用到它
3

配置机器人权限

  1. 前往边栏中的 OAuth & Permissions
  2. 在 Bot Token Scopes 下，添加以下权限范围 (scopes)：
    • chat:write — 发送消息
    • im:history — 读取私聊历史记录
    • im:read — 查看私聊
    • im:write — 发起私聊
    • app_mentions:read — 检测 @提及
  3. 点击顶部的 Install to Workspace
  4. 授权该应用
  5. 复制 Bot User OAuth Token（以 xoxb- 开头）
4

启用事件

  1. 前往边栏中的 Event Subscriptions
  2. 将 Enable Events 切换为 ON
  3. 在 Subscribe to bot events 下，添加：
    • message.im — 私聊消息
    • app_mention — 频道中的 @提及
  4. 点击 Save Changes
5

打开 LemonClaw WebUI

  1. 如果您使用的是托管版 Claw，请前往您的 Claw Dashboard 并点击 Open WebUI
  2. 如果您是私有部署 LemonClaw，请打开您自己的 WebUI（例如 http://your-ip:18789）并使用您的 token 登录
  3. 在 WebUI 中，导航至 Settings → Channels
  4. 展开 Slack 部分
  5. 粘贴您的 App Token (xapp-...) 和 Bot Token (xoxb-...)
  6. 点击 Save
6

开始聊天

  1. 在 Slack 中，向您的机器人发送私聊消息或在频道中 @提及它
  2. 第一个用户将自动配对为所有者 —— 无需代码！
  3. 开始与 AI 聊天吧！

​
访问控制

​
群组设置

在 LemonClaw WebUI 的 Channels 设置中配置频道访问权限：
设置选项描述
Group PolicyOpen (默认) / Allowlist / Disabled控制机器人在哪些频道中进行响应
Require @mention开启 / 关闭机器人仅在被 @提及 时响应
Group IDs频道 ID 列表限制在特定频道（留空 = 所有频道）
Group Allowed Users用户 ID 列表仅这些用户可以触发机器人（白名单模式）
默认情况下，Slack 使用 open 群组策略 —— 机器人会在其被邀请的所有频道中进行响应。使用 allowlist 可将其限制在特定频道。

​
故障排除

  • 验证两个 token 是否正确（App Token 以 xapp- 开头，Bot Token 以 xoxb- 开头）
  • 检查是否已订阅 message.im 事件
  • 确保应用已安装到您的工作区
  • 检查是否已配置 app_mentions:read 权限范围和 app_mention 事件
  • 必须先将机器人邀请到频道中（输入 /invite @botname）
  • 确保在 App Token 字段中使用的是 App-Level Token (xapp-)，而不是 Bot Token
  • Bot Token (xoxb-) 应填入 Bot Token 字段