Slack Skill 为 Claude Code 提供完整的 Slack 工作区集成能力,包含三种运行模式。
一、用途 该技能用于让 Claude Code 与 Slack 工作区交互,覆盖消息收发、历史读取、搜索、文件上传、表情回应、频道与用户管理等常见操作,并可将 Claude Code 会话本身接入 Slack 作为响应大脑。
二、主要能力
- 脚本模式(按需执行):提供 9 个 Python 脚本,包括 slack_post.py(发帖、线程回复、定时消息、AI 反馈按钮)、slack_read.py(读取频道历史或线程)、slack_delete.py(删除单条、批量或清理线程中机器人消息)、slack_search.py(通过 RTS API 搜索消息、文件、频道、用户,并支持旧版回退)、slack_stream.py(通过 chat streaming API 实时流式发送消息)、slack_react.py(添加或移除表情回应)、slack_upload.py(上传文件或代码片段)、slack_channels.py(列出频道、获取频道信息、加入频道含批量加入)、slack_users.py(按名称、ID 或邮箱查找用户)。
- 会话桥接模式(推荐):将任意正在运行的 Claude Code 会话连接到 Slack。后台监听器捕获 @提及和私信并写入 inbox.jsonl,当前会话读取 inbox、以完整工具权限处理并回帖,不产生额外 API 费用;通过 UserPromptSubmit 钩子自动通知新消息;可通过 soul.md 指令赋予 Claudicle 人格。
- 统一启动器模式(持久运行,需要 SDK API 密钥):通过 Claude Agent SDK 在同一进程中运行交互式终端与 Slack 机器人,支持按频道会话连续性、多轮线程对话、按用户人格建模、跨线程 soul 状态、三层记忆(工作记忆、用户模型、soul 记忆),所有 Slack 活动在终端可见。
三、使用方式 前置条件:所有脚本需要 SLACK_BOT_TOKEN 环境变量(xoxb- 开头),并安装 requests(uv pip install --system requests)。可选 SLACK_USER_TOKEN(xoxp-)用于 RTS API 不可用时通过旧版 search.messages/search.files 进行全工作区搜索。 首次设置:在 api.slack.com/apps 创建应用,配置 Bot Token Scopes(包括 app_mentions:read、各类 history/read/write、channels:join、chat:write、files:write/read、reactions:write/read、search:read 系列、users:read/read.email 等),开启 Socket Mode 并生成 App-Level Token(connections:write),开启 Event Subscriptions 并订阅 app_mention、message.im、app_home_opened,启用 App Home 消息标签,安装到工作区并复制 Bot User OAuth Token,设置环境变量,并用 /invite @Claude Code 邀请机器人。 常用命令示例: python3 ~/.claude/skills/slack/scripts/slack_post.py "#general" "Hello from Claude" python3 ~/.claude/skills/slack/scripts/slack_read.py "#general" -n 10 python3 ~/.claude/skills/slack/scripts/slack_search.py "deployment status" python3 ~/.claude/skills/slack/scripts/slack_channels.py --join-all-public 会话桥接:cd ~/.claude/skills/slack/daemon && python3 slack_listen.py --bg,然后用 slack_check.py 检查消息。 统一启动器:cd ~/.claude/skills/slack/daemon && python3 claudicle.py(需安装 slack-bolt 与 claude-agent-sdk)。
四、适用场景 适用于需要在 Slack 中自动发帖、读取与搜索消息、上传文件、管理频道与用户,或希望将 Claude Code 会话直接接入 Slack 处理 @提及与私信的场景;也适用于需要持久运行、按频道保持会话连续性与记忆的机器人部署。
五、限制 脚本需要有效的 Slack 令牌与相应权限范围;搜索功能依赖 RTS API 或旧版搜索权限,否则可能无结果;统一启动器需要 SDK API 密钥与 claude CLI;流式发送仅在 soul 引擎关闭时生效;部分操作受 Slack 速率限制(脚本会自动冷却与重试)。具体收费、价格与效果资料未提供。