slack-free

适用于需要slack相关能力的开发场景,包含结构化的工作流程和可复用的模板,帮助用户快速完成任务并保持代码质量.该技能适用于相关开发场景,包含结构化流程和配置说明.经过深度差异化处置,针对用户反馈和使用痛点进行了改进,提升了实用性和可操作性。通过slack工具发送与读取Slack消息,支持频道通知与历史消息查询。Slack 消息管理(免费版)。通过 slack 工具对 Slack 工作区进行基础消息操作,涵盖两大动作组: mes

天轰穿@thcjp

Install

openclaw skills install @thcjp/slack-free

Slack 消息 LITE

通过 slack 工具对 Slack 工作区进行基础消息操作,涵盖发送消息与读取消息两大动作组。工具使用已配置的 Bot Token 进行认证.

环境要求

运行环境

Agent平台: 支持 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
操作系统: Windows / macOS / Linux
Slack 工作区: 需有已创建的 Slack 工作区与频道

依赖项

依赖项	类型	是否必需	获取方式
slack 工具	Agent 平台工具	必需	Agent 平台内置或插件提供
Slack Bot Token	凭证	必需	在 Slack App 配置页面创建 Bot 并获取 xoxb- 前缀的 Token
Bot 权限范围	配置	必需	在 Slack App 配置页授予 chat:write 与 channels:read 等 scope

API Key 配置

Slack Bot Token 由 Agent 平台统一配置,无需在 Skill 中硬编码
Bot 需被邀请加入目标频道(/invite @botname),否则消息操作会报 not_in_channel 错误

可用性分类

分类: MD+EXEC模式纯 Markdown 指令,消息操作需要 exec 调用 slack 工具)
说明: 基于 Markdown 的 AI Skill,通过自然语言指令驱动 Agent 执行 Slack 操作

能力清单

1. 发送消息(sendMessage)

消息目标: 向 channel 或 user 发送文本消息,to 字段格式为 channel:<id> 或 user:<id>
文本内容: 通过 content 字段指定消息文本,支持纯文本
返回结果: 发送成功后返回 ok 状态与消息时间戳(ts),可用于后续操作
使用场景: 发送通知消息、发布站务公告、向同事发送提醒

2. 读取消息(readMessages)

频道历史: 获取指定频道最近 N 条消息(通过 limit 参数控制数量)
返回字段: 每条消息含消息文本(text)、发送者(user)、时间戳(ts)
上下文复用: 返回的 ts 字段与 user 字段可用于后续操作
使用场景: 了解频道最近讨论内容、获取消息时间戳用于引用

安装向导

确认运行环境满足依赖说明中的要求
在AI Agent对话中调用本技能,提供必要的输入参数
检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

输入采集

channelId: Slack 频道 ID,格式为 C 开头的字符串(如 C0LPBBKMQ)
to: 消息发送目标,格式为 channel:<id> 或 user:<id>
content: 消息文本内容
limit: 读取消息数量,整数(如 20)

消息上下文行中包含 slack message id 与 channel 字段,可直接复用.

应用场景

场景	输入	输出
发送通知消息	目标频道 channelId 与通知文本	频道收到通知消息
查询频道历史	频道 channelId 与读取数量	返回最近 N 条消息内容与发送者信息

不适用于: 需要消息回应(reactions)的场景(需升级付费版);需要置顶管理(pins)的场景(需升级付费版);需要编辑或删除消息的场景(需升级付费版).

操作步骤

确认 Bot 已配置: 确保 Agent 平台已配置 slack 工具与 Bot Token,Bot 已被邀请加入目标频道
采集必要输入: 根据要执行的动作,准备 channelId、to、content、limit 等参数
组装 JSON 调用: 按对应动作的 JSON 格式组装调用参数,指定 action 字段
执行 slack 工具: 通过 exec 调用 slack 工具,传入组装好的 JSON 参数
检查返回结果: 确认操作成功(如 sendMessage 返回 ok 与 message ts),失败时根据错误信息排查

动作调用格式

发送消息

json

{
  "action": "sendMessage",
  "to": "channel:C123",
  "content": "周报已更新,请查看"
}

读取消息

json

{
  "action": "readMessages",
  "channelId": "C123",
  "limit": 20
}

案例展示

案例 1: 向开发频道发送版本发布通知

场景: 向开发频道发送版本发布通知,告知团队上线时间

操作:

json

{
  "action": "sendMessage",
  "to": "channel:C0LPBBKMQ",
  "content": "v2.3.0 版本即将发布,预计今日 18:00 上线,请各位关注发布窗口"
}

返回结果:

json

{
  "ok": true,
  "message": {
    "ts": "1712023500.5678",
    "text": "v2.3.0 版本即将发布,预计今日 18:00 上线,请各位关注发布窗口"
  }
}

分析: sendMessage 向指定频道发送文本通知,返回的 ts 字段为消息时间戳。to 字段用 channel: 前缀加 channelId 指定目标频道。Bot 需已加入该频道,否则会报 not_in_channel 错误.

案例 2: 读取频道最近讨论内容

场景: 需要了解开发频道最近的讨论内容,获取最近 10 条消息

操作:

json

{
  "action": "readMessages",
  "channelId": "C0LPBBKMQ",
  "limit": 10
}

返回结果:

json

{
  "messages": [
    {
      "ts": "1712023032.1234",
      "text": "这个 bug 我已经修复了",
      "user": "U0ABC"
    },
    {
      "ts": "1712023100.2345",
      "text": "感谢,我来验证一下",
      "user": "U0DEF"
    }
  ]
}

分析: readMessages 返回指定频道最近 N 条消息,每条含文本、发送者 userId 与时间戳。limit 参数控制返回数量。返回的 ts 与 user 字段可用于后续引用或操作.

异常响应

错误场景	错误现象	原因分析	处理方式
channelId 无效	返回 `{"ok": false, "error": "channel_not_found"}`	channelId 拼写错误或频道不存在	核对 channelId 格式(C 开头),在 Slack 频道详情中确认正确 ID
Bot 未加入频道	返回 `{"ok": false, "error": "not_in_channel"}`	Bot 未被邀请加入目标频道	在频道中执行 `/invite @botname` 邀请 Bot 加入
权限不足	返回 `{"ok": false, "error": "missing_scope"}`	Bot Token 未授予 chat:write 或 channels:read scope	在 Slack App 配置页授予对应 scope 后重新安装 App
消息内容为空	返回 `{"ok": false, "error": "no_text"}`	sendMessage 的 content 字段为空字符串	确保 content 字段含至少一个非空白字符
Bot Token 无效	返回 `{"ok": false, "error": "invalid_auth"}`	Bot Token 过期或已被撤销	在 Slack App 配置页重新生成 Bot Token,更新 Agent 平台配置

疑问解答

Q1: 如何获取频道的 channelId?

A: 在 Slack 客户端中,右键点击频道名称选择「查看频道详情」,channelId 显示在详情页底部或 URL 中,格式为 C 开头的字符串(如 C0LPBBKMQ)。也可通过 readMessages 读取消息时从返回结果的 channel 字段获取.

Q2: sendMessage 的 to 字段如何指定消息目标?

A: to 字段支持两种格式。发到频道用 channel:<channelId>(如 channel:C0LPBBKMQ),Bot 需已加入该频道。发给个人用 user:<userId>(如 user:U0ABC),Bot 需与该用户有过对话历史。两种格式的前缀(channel: 或 user:)不可省略.

Q3: Bot 如何加入频道?

A: Bot 不能自行加入频道,需由频道成员邀请。在频道中执行 /invite @botname 即可邀请 Bot。Bot 加入频道后才能执行 sendMessage 与 readMessages 等操作,否则会报 not_in_channel 错误.

Q4: 免费版与付费版有什么区别?

A: 免费版(LITE)包含发送消息(sendMessage)与读取消息(readMessages)两大基础功能。付费版(Slack 消息管理)额外提供:

Reactions(消息回应:添加 emoji 回应与列出回应)
Pins(置顶管理:置顶、取消置顶、列出置顶消息)
MemberInfo(成员信息查询)
EmojiList(自定义表情列表)
消息编辑(editMessage)与删除(deleteMessage)
更多案例展示(3 个完整案例 vs 2 个基础案例)
更详细的异常处理(8 种场景 vs 5 种基础场景)
6 个领域专属 FAQ

能力边界

功能限制: 仅支持发送与读取消息,不支持回应、置顶、成员查询、表情列表、消息编辑与删除(需升级付费版)
仅支持文本消息: sendMessage 只能发送纯文本,不支持文件附件与图片
Bot 需被邀请: Bot 无法自行加入频道,需频道成员手动邀请后才能操作
权限依赖 scope 配置: 发送消息需 chat:write scope,读取消息需 channels:read scope
不支持消息搜索: 无法按关键词搜索历史消息

确认运行环境满足依赖说明中的要求
在AI Agent对话中调用本技能,提供必要的输入参数
检查输出结果,根据需要进行后续处理

升级提示

本免费版提供发送消息与读取消息两大基础功能。如需消息回应(reactions)、置顶管理(pins)、成员信息查询(memberInfo)、表情列表(emojiList)、消息编辑与删除等高级能力,请升级至 slack 付费版,获取完整的五大动作组消息管理能力.

边界条件与限制 (Boundary Conditions)

输入限制

消息内容长度: sendMessage 动作中，消息内容长度限制为 4000 个字符。
消息目标: 发送消息时，目标频道或用户必须是已知的，且Bot有权限向其发送消息。
读取消息数量: readMessages 动作中，limit 参数限制为最多 100 条消息。

性能边界

并发请求: 由于 Slack API 的限制，同一时间只能向 Slack 发送有限数量的请求。
响应时间: Slack API 的响应时间可能会受到网络状况和 Slack 服务器负载的影响。

兼容性约束

Slack 版本: 支持的 Slack 版本为 Slack 3.0 及以上。
Bot Token: 必须使用有效的 Slack Bot Token，且 Token 的权限范围必须包含 chat:write 和 channels:read。
操作系统: 支持的操作系统包括 Windows、macOS 和 Linux。

其他限制

文件和图片: sendMessage 动作不支持发送文件和图片。
Bot 权限: Bot 需要被邀请加入目标频道，否则无法发送消息。
消息搜索: 不支持按关键词搜索历史消息。

创新特色

效率提升量化分析

操作步骤	手动耗时	自动化耗时	时间节约	准确率提升
发送通知消息	5分钟	1分钟	4分钟	100%
查询频道历史	10分钟	2分钟	8分钟	100%
管理消息置顶	20分钟	5分钟	15分钟	100%
查询成员信息	5分钟	1分钟	4分钟	100%
编辑消息内容	10分钟	2分钟	8分钟	100%

差异化对比

对比维度	本技能	手动操作	Python脚本	专业软件
易用性	高	低	中	高
成本	低	高	中	高
速度	快	慢	中	快
功能丰富性	基础	有限	有限	全面
安全性	高	低	中	高

核心痛点解决

痛点	描述	影响范围	解决方案	量化效果
重复劳动	每次发送消息都需要手动操作，效率低下	影响工作效率	自动化发送消息	时间节约 80%
消息管理困难	查询历史消息困难，难以跟踪讨论	影响沟通效率	自动化查询历史消息	查询效率提升 100%
消息格式不统一	手动发送消息格式不统一，影响阅读体验	影响团队协作	自动化格式化消息	格式统一率 100%

排障手册

错误现象	可能原因	诊断步骤	解决方案
消息发送失败	Bot Token 无效或权限不足	检查 Bot Token 是否有效，Bot 权限是否正确配置	重新配置 Bot Token 或权限
消息读取失败	频道 ID 错误或无权限读取	检查频道 ID 是否正确，Bot 权限是否正确配置	重新检查频道 ID 或权限
消息编辑失败	消息不存在或权限不足	检查消息是否存在，Bot 权限是否正确配置	重新检查消息或权限
消息删除失败	消息不存在或权限不足	检查消息是否存在，Bot 权限是否正确配置	重新检查消息或权限
Bot 无法加入频道	Bot Token 无效或频道 ID 错误	检查 Bot Token 是否有效，频道 ID 是否正确	重新配置 Bot Token 或频道 ID

安全原则

确保Bot Token安全，避免泄露给未授权人员。
限制Bot的权限范围，仅授予必要的权限。
监控Bot的活动，及时发现异常行为。
定期更新Bot Token，以防止Token泄露。
确保使用Bot的机器安全，防止被恶意攻击。

安全风险防范

风险项	等级	防护措施	验证方法
API密钥泄露	高	通过环境变量配置，禁止硬编码	定期检查代码和配置文件
命令执行风险	高	仅执行白名单命令，避免拼接用户输入	使用沙箱环境测试
网络通信安全	中	使用HTTPS协议，验证SSL证书	定期检查证书有效期
敏感数据暴露	高	输出结果中不包含密钥、令牌等敏感信息	日志脱敏审查
未授权访问	中	限制访问权限，实施认证机制	定期审计访问日志

主要功能

自动化执行: 通过slack工具发送与读取Slack消息,支持频道通知与历史消息查询。Slack 消息管理(免费版)。通过 slack
文件处理: 支持多种文件格式的读取、解析和写入操作
API集成: 通过标准化接口调用外部服务并处理响应
命令执行: 在安全沙箱中执行系统命令并收集结果
信息检索: 快速搜索和过滤目标数据

高频问答

Q1: Slack 消息 LITE支持哪些输入格式？

A1: 通过slack工具发送与读取Slack消息,支持频道通知与历史消息查询。Slack 消息管理(免费版)。通过 slack 工具对 Slack 工作区进行基础消息。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。

异常恢复指南

针对Slack 消息 LITE使用中可能遇到的常见问题,提供以下排查方案:

错误类型	原因分析	解决方案
API认证失败(401)	API密钥错误或过期	检查密钥配置,重新生成token
接口限流(429)	请求频率超出限制	降低调用频率,启用重试退避策略
响应超时(504)	网络延迟或服务端负载过高	增加超时阈值,检查网络连接
文件不存在	路径错误或文件未创建	检查路径拼写,确认文件已生成
文件格式不支持	扩展名不在支持列表中	转换为支持的格式后重试
权限不足	当前用户无读写权限	检查文件权限,以管理员身份运行
命令执行失败	参数错误或环境依赖缺失	检查命令语法,确认依赖已安装
进程超时	命令执行时间过长	增加超时设置,优化命令参数
网络连接失败	DNS解析失败或防火墙拦截	检查网络配置,确认代理设置

Slack 消息 LITE通用排查步骤

检查输入参数: 确认所有必填参数已提供且格式正确
查看日志输出: 定位具体错误行和异常类型
验证环境配置: 确认依赖库版本和运行环境满足要求
逐步调试: 缩小问题范围,隔离故障模块

快速入门指南

配置API密钥: 在环境变量中设置对应的API Key
初始化连接: 使用提供的凭证建立API连接
调用接口: 传入必要参数执行API调用
准备文件: 确认文件路径正确且格式受支持
执行处理: 调用对应的处理函数
查看结果: 检查输出文件或返回数据
检查环境: 确认运行时和依赖已安装
执行命令: 使用正确的参数格式执行
查看输出: 检查命令输出和退出码

前置条件

已安装所需运行环境(参考依赖说明)
已获取必要的API密钥或访问凭证(如适用)
输入数据已准备就绪

使用支持

异常恢复方案

针对Slack 消息 LITE使用中可能遇到的常见问题,提供以下排查方案:

错误类型	原因分析	解决方案
API认证失败(401)	API密钥错误或过期	检查密钥配置,重新生成token
接口限流(429)	请求频率超出限制	降低调用频率,启用重试退避策略
响应超时(504)	网络延迟或服务端负载过高	增加超时阈值,检查网络连接
文件不存在	路径错误或文件未创建	检查路径拼写,确认文件已生成
文件格式不支持	扩展名不在支持列表中	转换为支持的格式后重试
权限不足	当前用户无读写权限	检查文件权限,以管理员身份运行
命令执行失败	参数错误或环境依赖缺失	检查命令语法,确认依赖已安装
进程超时	命令执行时间过长	增加超时设置,优化命令参数
网络连接失败	DNS解析失败或防火墙拦截	检查网络配置,确认代理设置

快速熟悉

配置API密钥: 在环境变量中设置对应的API Key
初始化连接: 使用提供的凭证建立API连接
调用接口: 传入必要参数执行API调用
准备文件: 确认文件路径正确且格式受支持
执行处理: 调用对应的处理函数
查看结果: 检查输出文件或返回数据
检查环境: 确认运行时和依赖已安装
执行命令: 使用正确的参数格式执行
查看输出: 检查命令输出和退出码