用途:向 Slack 频道发送消息与富内容,支持 Incoming Webhook 与 Slack Web API 两种方式,可用 Block Kit 构建格式化公告、营销报告、指标看板和社区更新。
前置条件:需在 .env、.env.local 或 ~/.claude/.env.global 中设置 SLACK_WEBHOOK_URL 或 SLACK_BOT_TOKEN。命令:source ~/.claude/.env.global 2>/dev/null、source .env 2>/dev/null、source .env.local 2>/dev/null;未设置时按设置指南配置。
两种凭证:Webhook 模式无需 OAuth 权限,仅限单个频道,不能读消息、列频道或程序化回复线程。Bot Token 模式需在 Slack App 的 OAuth & Permissions 添加 chat:write、chat:write.public、channels:read,可选 files:write、reactions:write,并将机器人邀请到目标频道。
主要能力:发送纯文本及带用户名/图标的消息;用 Block Kit 构建 header、section、divider、image、context、actions、rich_text 等块;通过 chat.postMessage 发消息并获取 ts 用于线程回复(thread_ts、reply_broadcast);用 chat.update 更新、chat.delete 删除消息;用 conversations.list 列出公开频道;用 files.uploadV2 上传文件;用 reactions.add 添加表情回应。
Block Kit 限制:每条消息最多 50 个块;每个文本块 3000 字符;header 150 字符;section 最多 10 个字段;actions 块最多 25 个元素;context 块最多 10 个元素。可用 Block Kit Builder 预览。
格式注意:Slack 使用 mrkdwn,加粗用 text,斜体用 text,链接用 <url|text>,提及用户 <@U0123456>、频道 <#C0123456>;无标题语法,图片不能内联。
限制:按钮若含 action_id 且无 url,需要在 Slack App 配置 Interactivity 的 Request URL 才能接收点击。资料未提供收费、价格与平台范围信息。