slack-workspace-free

Slack工作区管家 LITE（Slack Workspace Free）

面向团队协作场景的Slack基础工作区管理（免费版）。通过ClawLink OAuth托管连接，提供频道消息发送、频道列表、用户列表三大能力.

输入参数

依赖与配置

运行环境

• Agent 平台: 支持 SKILL.md 的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
• 操作系统: Windows / macOS / Linux
• 网络: 需可访问 https://slack.com/api/* 及 ClawLink 服务

依赖项

可用性分类

• 分类: MD+EXEC（Markdown 指令驱动，需 exec 执行 clawlink 命令）
• 说明: 通过 ClawLink 托管OAuth Token，Agent 调用 clawlink_call_tool 驱动 Slack Web API

连接说明

无需在聊天中提供API Token。ClawLink 安全存储 OAuth Token 并自动注入每个 Slack API 请求. 首次使用需：1) 安装 ClawLink 插件并配对设备；2) 访问 ClawLink Dashboard 连接 Slack 工作区；3) 调用 clawlink_list_integrations 验证连接.

能力矩阵

1. 频道消息发送

向指定频道发送文本消息。频道参数需使用频道ID（C0123456789）。支持基础Slack消息格式化：*bold*、_italic_、`code`、emoji语法 :name:.

2. 频道列表

列出工作区内全部频道，返回频道ID、名称、成员数、是否私有等。可用于频道发现与ID解析.

3. 用户列表

列出工作区内全部用户，返回用户ID、姓名、邮箱、是否在线等。可用于成员查询与用户ID获取.

升级提示：线程回复、定时消息、频道创建/归档/重命名、文件上传/下载、表情反应、提醒、画布、用户组管理、企业Grid审计日志等高级功能仅在 slack-workspace 付费版中提供。- 验证返回数据的完整性和格式正确性

上线流程

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

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

操作流程

确认连接状态

clawlink_list_integrations

返回列表中包含 slack 即已连接。若未连接，引导用户访问 ClawLink Dashboard 连接 Slack.

频道名解析为ID

大部分Slack工具需要频道ID。使用 slack_list_all_channels 列出频道后按 name 字段匹配.

发送消息或查询数据

1. 发送消息：clawlink_call_tool --tool "slack_send_message"，传 channel、text
2. 列出频道：clawlink_call_tool --tool "slack_list_all_channels"
3. 列出用户：clawlink_call_tool --tool "slack_list_all_users"

透传结果

1. 发送成功返回 {ok: true, channel, ts, message}
2. 频道列表返回 {ok: true, channels: [{id, name, num_members, ...}]}
3. 用户列表返回 {ok: true, members: [{id, name, profile, ...}]}

案例展示

案例1：通知发布

场景：团队需要在 #general 频道发布版本发布提醒

执行：

# 列出频道找到#general的ID
clawlink_call_tool --tool "slack_list_all_channels" --params '{}'
# ...
# 发送版本发布提醒
clawlink_call_tool --tool "slack_send_message" --params '{
  "channel": "C0GENERAL01",
  "text": ":rocket: *v2.1.0发布提醒*\n发布窗口：今晚 22:00-23:00\n负责人：@alice\n回滚方案：已准备"
}'

输出：

// list_all_channels（截取）
{"ok": true, "channels": [{"id": "C0GENERAL01", "name": "general", "num_members": 42}]}
# ...
// send_message
{"ok": true, "channel": "C0GENERAL01", "ts": "1721452800.123456"}

分析：先通过频道列表解析 #general 的ID为 C0GENERAL01，再发送消息。时间戳 1721452800.123456 可用于后续引用。:rocket: 会被渲染为emoji.

错误恢复方案

问题汇总集锦

Q1：如何连接Slack工作区？

A：安装 ClawLink 插件后，访问 ClawLink Dashboard，点击连接Slack，完成OAuth授权。授权后调用 clawlink_list_integrations 验证连接，再调用 clawlink_list_tools --integration slack 确认工具可用。全程无需手动提供API Token.

Q2：如何找到频道ID？

A：调用 slack_list_all_channels 列出工作区全部频道，返回结果中每个频道包含 id（以 C 开头）和 name 字段。按 name 匹配目标频道名即可获取对应ID。普通频道ID以 C 开头，DM以 D 开头，MPDM以 G 开头.

Q3：免费版和付费版有什么区别？

A：免费版（LITE）包含频道消息发送、频道列表、用户列表三大基础功能。付费版（Slack工作区管家）额外提供：

• 线程回复与定时消息
• 频道创建/归档/重命名/话题设置/邀请成员
• 对话历史与线程获取
• 文件上传/下载/删除
• 表情反应、提醒、置顶与星标
• Canvas画布创建与编辑
• 用户组管理与企业Grid审计日志
• 自定义emoji管理
• 60+ 工具覆盖12大能力域（vs 免费版3个基础工具）
• 3 个完整案例（vs 免费版 1 个）
• 8 种错误处理（vs 免费版 5 种）

Q4：Bot为什么发不出消息？

A：常见原因：1) OAuth Token缺少 chat:write 权限，需在Dashboard重新授权；2) Bot未加入目标频道，需在Slack中用 /invite @botname 邀请；3) 频道ID错误，建议先用 slack_list_all_channels 确认。检查返回的 error 字段可定位具体原因.

使用约束

1. 基础功能：仅支持消息发送、频道列表、用户列表，不支持线程回复、频道管理、文件操作、提醒等（需升级付费版）
2. 需频道ID：发送消息需手动提供频道ID，不支持频道名自动解析（付费版支持 slack_find_channels 搜索）
3. 无写操作预览：不支持 clawlink_preview_tool 写操作预览（付费版支持预览+确认流程）
4. 仅基础查询：不支持对话历史、用户在线状态、文件列表等高级查询（需升级付费版）
5. 无定时消息：不支持消息定时发送与提醒创建（需升级付费版）

---

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

需要更多能力？ 升级到 slack-workspace 付费版获取线程回复、定时消息、频道管理、文件操作、提醒、画布、用户组管理、企业Grid审计等60+工具覆盖12大能力域的高级功能.

创新特色

效率提升量化分析

差异化对比

核心痛点解决

排障手册

安全告示

1. [与「Slack工作区管家LITE」相关的安全注意事项]
   • 确保ClawLink OAuth Token安全，避免泄露。
   • 定期检查API权限，确保只有必要的权限被授予。
   • 使用HTTPS协议进行API调用，确保数据传输安全。
   • 避免在公开渠道分享敏感信息。
   • 及时更新ClawLink插件，以修复已知的安全漏洞。

安全风险防范

功能亮点

• 自动化执行: Slack基础消息发送与频道列表，ClawLink OAuth托管连接。面向团队协作场景的Slack基础工作区管理技能（
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

疑问与解答集

Q1: Slack工作区管家LITE支持哪些输入格式？

A1: Slack基础消息发送与频道列表，ClawLink OAuth托管连接。面向团队协作场景的Slack基础工作区管理技能（免费版）。通过ClawLink。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 使用Slack工作区管家LITE需要什么前置条件？

A2: 请确认运行环境满足依赖说明中的要求。Slack工作区管家LITE基于Markdown指令驱动，无需额外安装包。

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

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

异常响应

针对Slack工作区管家LITE使用中可能遇到的常见问题,提供以下排查方案:

Slack工作区管家LITE通用排查步骤

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

轻松上手

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

前置条件

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

高频问答

Q2: 需要配置API Key吗？

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

快速入门指引

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