技术团队日常沟通基本都离不开 Slack但大多数时候我们是在图形界面里点点点。随着自动化运维、CI/CD 流水线和内部工具的普及越来越多团队开始希望在终端里直接操作 Slack发消息、查频道、管理应用、触发机器人通知。这时候 SlackCLI 就是一个很实用的选择。本文将围绕 SlackCLI 展开从概念、安装到登录认证、调用 Web API 发送消息再到 CI/CD 自动化场景完整拆解一套可落地的终端操作 Slack 方案。无论是刚接触 Slack 开发的初学者还是需要为团队搭建自动化通知的后端开发、运维工程师都可以参考本文逐步操作。先说明一点不同版本的 SlackCLI 在命令和底层运行时上存在差异为了让大家不被版本细节卡住本文在关键位置会同时给出通用写法和版本提醒。你只需要保留思路命令则根据实际安装版本稍作调整即可。1. SlackCLI 是什么它解决什么问题1.1 从命令行操作 Slack 的价值Slack 的日常使用场景大多是图形界面但当我们希望把消息通知、应用部署、异常告警接入到脚本里时命令行工具的效率优势就非常明显了。举个例子假设你负责维护一套定时任务每天凌晨执行数据同步。同步失败时最直接的需求是让相关同事第一时间知道。虽然可以在后端代码里调用 Slack API但很多时候我们只是想快速验证一个通知能不能发出去或者临时手动触发一个测试消息。如果还要为此写一个完整项目、配一堆依赖明显太重了。SlackCLI 的价值正在于此它把 Slack 的登录、会话管理、应用创建、消息发送等操作封装成终端命令让你可以不离开终端完成常见任务也能在脚本里直接调用把 Slack 能力嵌入自动化流程。1.2 SlackCLI 与 Slack API 的关系这里需要先做一个概念区分。Slack Web APISlack 对外提供的 HTTP 接口比如chat.postMessage、conversations.list。任何语言都可以通过 HTTP 请求调用。SlackCLI一个封装好的终端工具底层仍然会调用 Slack Web API或交互式 API但使用者在终端里操作时不需要关心 HTTP 细节。简单理解SlackCLI 是“客户端”Slack Web API 是“服务端接口”。你可以直接用 curl 调 Web API也可以用 SlackCLI 让操作更规范、更高效。1.3 常见使用场景从实际项目来看SlackCLI 的典型场景集中在以下几类1.3.1 自动化通知将构建结果、测试报告、监控告警、数据任务状态发送到指定频道。这是最常见也最实用的场景。1.3.2 管理工作区应用通过命令行创建 Slack 应用、更新应用配置、查看应用信息适合调试阶段快速操作不需要打开管理后台。1.3.3 本地开发与测试开发 Slack Bot 或消息应用时用 SlackCLI 快速模拟消息收发验证配置是否正确比反复在图形界面创建应用更高效。1.3.4 内部工具集成把 SlackCLI 嵌入公司内部的运维平台、发布系统实现“一行命令通知所有人”的效果。2. 环境准备与版本说明2.1 运行环境要求SlackCLI 的安装和使用通常需要满足以下条件操作系统macOS、Linux 或 WindowsWindows 建议使用 WSL 或 Git Bash 体验更稳定网络能够正常访问 Slack 服务账号权限拥有 Slack 工作区的账号或至少能够创建工作区这里提醒一下不同版本的 SlackCLI 对运行时的要求不一样。早期版本基于 Node.js安装前需要先装 Node.js新版本则基于 Deno 或自带运行时。为了避免因为版本问题卡在第一步安装前建议先看一眼官方文档。2.2 安装 SlackCLISlackCLI 的官方推荐安装方式是通过安装脚本。在 macOS 或 Linux 终端中执行curl -fsSL https://slack.com/cli/install | bash安装完成后打开一个新的终端窗口检查是否安装成功slack --version如果输出类似版本号的信息说明安装成功。如果没有成功可能需要检查 PATH 环境变量。如果你使用的是 Windows官方建议通过 WSL 安装 Linux 版本。在 WSL 终端中执行上述安装命令即可。我个人的建议是先使用官方脚本安装安装成功后多执行几次slack --help把当前版本的命令列表确认清楚。因为 SlackCLI 的命令变化比较频繁网上教程里的命令可能与最新版不一致。2.3 验证环境安装完成后先查看帮助信息确认当前版本的可用命令slack --help通常输出会包含 login、logout、list、apps 等子命令。不同版本可能略有差异以实际输出为准。3. 登录与身份认证3.1 为什么需要单独登录SlackCLI 默认是以“开发者”身份操作不能直接读取你工作区的所有数据。你需要先通过登录操作完成 OAuth 认证让 CLI 获取你授予的权限。这一点非常重要不是安装完 CLI 就能直接发消息你必须完成登录并授予对应权限否则后续调用 API 会返回missing_scope或invalid_auth之类的报错。3.2 登录流程示例在终端中执行slack login此时终端会输出一个链接同时尝试打开浏览器。如果没有自动打开浏览器请手动复制链接访问。在浏览器页面中选择你要登录的 Slack 工作区并确认授权。授权完成后回到终端你会看到登录成功提示。如果是在无浏览器环境中SlackCLI 通常会提供一种设备码device code方式终端显示一个短码你在浏览器中输入该短码即可完成授权。3.3 查看当前登录状态登录后可以使用以下命令查看当前登录的账号和工作区slack whoami或者slack auth list不同版本命令略有差异如果无法识别请参考slack --help的输出。3.4 登出与切换账号需要切换工作区或账号时先登出当前账号slack logout随后再执行slack login登录新账号。这里想提醒一个常见误区很多初学者以为登录后 SlackCLI 就可以代表自己向任意频道发消息。实际上CLI 登录后能做的事情依然受到 Slack 工作区权限和 OAuth scope 的限制。如果你后续希望通过脚本发送消息建议单独创建一个 Slack 应用使用 Bot Token而不是使用个人登录身份。4. 核心概念Token、Scope 与 Bot4.1 什么是 Token在 Slack 的 API 体系中Token 相当于“钥匙”。你拿着 Token就代表应用以某个身份调用 API。常见的有两种User Token代表一个用户身份权限随用户走。Bot Token代表一个机器人身份权限由应用配置决定。在使用 SlackCLI 时如果只是临时手动操作登录后的会话 Token 就够了但如果你要写脚本、接入自动化任务建议用 Bot Token这样权限更可控也不会因为个人账号变动而失效。4.2 什么是 ScopeScope 是 Slack 应用申请的具体权限范围比如channels:read查看频道信息chat:write发送消息users:read查看用户信息你在 Slack 应用管理页面为应用配置这些权限后安装应用到工作区Slack 才会发放对应权限的 Token。很多人的消息发送失败根因就是 Scope 没配全。比如只配置了channels:read没有配置chat:write调用发送消息接口时就会收到missing_scope错误。4.3 为什么推荐创建独立应用直接用 SlackCLI 登录个人账号确实方便但在生产环境中存在几个问题个人账号被停用或离职脚本就失效。个人权限范围过大不适合给脚本使用。无法精细控制脚本能访问哪些频道。所以更规范的做法是创建一个专门的 Slack 应用给这个应用配置最小权限安装到目标工作区然后使用它的 Bot Token 执行脚本。下面的实战案例就采用这种方式这也是最接近真实生产环境的使用方式。5. 实战用 SlackCLI 配合 Web API 发送消息接下来我们完成一个完整案例通过 SlackCLI 创建工作区应用、获取 Bot Token然后编写脚本向指定频道发送消息。5.1 创建项目结构首先在本地创建一个项目目录mkdir slackcli-demo cd slackcli-demo目录结构如下slackcli-demo/ ├── app-manifest.yaml ├── send_message.py └── README.md如果你习惯用 Node.js也可以把send_message.py替换成send_message.js思路是一样的。5.2 使用 SlackCLI 创建应用如果你安装了 SlackCLI可以直接用命令创建应用。不同版本的创建命令可能不同常见的是slack apps create执行后终端会引导你选择应用名称和开发语言。这里我们选择创建一个使用 Manifest应用配置文件管理的应用。创建完成后SlackCLI 通常会生成一个本地目录里面包含应用配置模板。如果这一步命令无法运行你也可以直接在 Slack 管理后台手动创建应用。两种方式的最终效果是一样的获得一个 app_id 和一个 Bot Token。这里重点说明一下创建应用本质上是在配置“这台机器人能做什么”。创建完成后你需要到应用管理页面添加 Bot Token Scope至少添加chat:writechannels:read然后安装应用到你的工作区安装完成后复制 Bot User OAuth Token它通常以xoxb-开头。5.3 编写发送消息的 Python 脚本有了 Token我们可以直接调用 Slack Web API 发送消息。这里不使用第三方 Slack SDK而是用标准库urllib这样可以减少依赖方便复制运行。创建send_message.py内容如下# 文件路径slackcli-demo/send_message.py import json import urllib.request # 请替换为你的 Bot User OAuth Token SLACK_TOKEN xoxb-你的token # 请替换为目标频道ID或频道名称 CHANNEL C1234567890 # 要发送的消息内容 MESSAGE Hello from SlackCLI Demo! def send_slack_message(token, channel, text): url https://slack.com/api/chat.postMessage headers { Content-Type: application/json; charsetutf-8, Authorization: fBearer {token} } payload { channel: channel, text: text } data json.dumps(payload).encode(utf-8) req urllib.request.Request(url, datadata, headersheaders, methodPOST) with urllib.request.urlopen(req) as resp: result json.loads(resp.read().decode(utf-8)) return result if __name__ __main__: response send_slack_message(SLACK_TOKEN, CHANNEL, MESSAGE) if response.get(ok): print(消息发送成功) print(消息时间戳, response.get(ts)) else: print(消息发送失败, response.get(error))这段代码做了以下几件事构造请求头把 Token 放在 Authorization 中。构造请求体指定频道和消息内容。调用chat.postMessage接口。输出发送结果。5.4 获取频道 ID发送消息前我们需要确定目标频道。在 Slack 界面中频道 ID 通常显示在频道详情的最底部是一串以C开头的字符。例如C02ABCDEFGH。如果看不到可以使用下面这个简单的 Python 脚本来查询可见频道列表。# 文件路径slackcli-demo/list_channels.py import json import urllib.request import urllib.parse SLACK_TOKEN xoxb-你的token def get_channels(token): url https://slack.com/api/conversations.list headers { Authorization: fBearer {token} } req urllib.request.Request(url, headersheaders, methodGET) with urllib.request.urlopen(req) as resp: result json.loads(resp.read().decode(utf-8)) return result if __name__ __main__: response get_channels(SLACK_TOKEN) if response.get(ok): channels response.get(channels, []) for ch in channels: print(ch.get(id), ch.get(name)) else: print(查询失败, response.get(error))运行python3 list_channels.py输出类似C02ABCDEFGH general C03EDFG1234 random C04HIJK5678 project-news复制目标频道 ID更新send_message.py中的CHANNEL变量。注意如果脚本查询不到频道通常说明 Bot 没有加入该频道。需要在 Slack 界面中手动邀请 Bot 进入频道或者调用conversations.join接口让 Bot 加入公开频道。5.5 运行与验证执行发送脚本python3 send_message.py预期输出消息发送成功 消息时间戳1712345678.123456此时打开 Slack 客户端进入对应的频道就能看到机器人发送的消息。如果你的脚本报错最常见的是如下两种消息发送失败not_in_channel说明 Bot 不在这个频道里。需要先把 Bot 加进频道。消息发送失败missing_scope说明应用的权限配置不完整需要回到 Slack 应用管理页面添加chat:write权限并重新安装应用。5.6 用 Node.js 实现同样的功能很多团队的技术栈是 Node.js这里也给出对应的实现方式。创建send_message.js// 文件路径slackcli-demo/send_message.js const https require(https); const SLACK_TOKEN xoxb-你的token; const CHANNEL C1234567890; const MESSAGE Hello from SlackCLI Demo!; function sendSlackMessage(token, channel, text) { const payload JSON.stringify({ channel, text }); const options { hostname: slack.com, path: /api/chat.postMessage, method: POST, headers: { Content-Type: application/json; charsetutf-8, Content-Length: Buffer.byteLength(payload), Authorization: Bearer ${token} } }; const req https.request(options, (res) { let data ; res.on(data, (chunk) { data chunk; }); res.on(end, () { const result JSON.parse(data); if (result.ok) { console.log(消息发送成功); console.log(消息时间戳, result.ts); } else { console.log(消息发送失败, result.error); } }); }); req.on(error, (error) { console.error(请求失败, error.message); }); req.write(payload); req.end(); } sendSlackMessage(SLACK_TOKEN, CHANNEL, MESSAGE);运行node send_message.js思路与 Python 版本完全一致核心就是构造请求并处理返回的 JSON。6. 进阶在 CI/CD 流水线中使用 Slack 通知6.1 为什么要在 CI/CD 中接入 Slack构建系统如 Jenkins、GitLab CI、GitHub Actions在任务结束后通常需要把结果同步给团队成员。以前很多团队用邮件但邮件容易被忽略在 Slack 频道里通知配合 提醒效果会好很多。SlackCLI 在这里的角色有两种一种是在 CI 脚本中直接调用 CLI 命令另一种是配合 Web API 请求。个人更推荐第二种因为 Token 更好管理也更容易在密钥库中配置。6.2 GitHub Actions 示例下面是一个 GitHub Actions 中发送构建结果的例子。# 文件路径.github/workflows/notify.yml name: Build Notify on: push: branches: - main jobs: build: runs-on: ubuntu-latest steps: - name: Checkout code uses: actions/checkoutv4 - name: Run build run: echo 构建中... - name: Notify Slack env: SLACK_BOT_TOKEN: ${{ secrets.SLACK_BOT_TOKEN }} SLACK_CHANNEL: ${{ secrets.SLACK_CHANNEL }} run: | python3 send_message.py在这个流程中你需要先在 GitHub 仓库的 Secrets 配置中添加SLACK_BOT_TOKEN和SLACK_CHANNEL两个变量然后把写好的send_message.py放到仓库中。这里要特别强调不要直接把 Token 明文写在代码或命令行中一定要使用平台的密钥管理功能。6.3 Jenkins Pipeline 示例Jenkins 中可以在流水线文件里加入通知步骤。pipeline { agent any environment { SLACK_TOKEN credentials(slack-bot-token) SLACK_CHANNEL C1234567890 } stages { stage(Build) { steps { echo 构建中... } } } post { success { script { sh curl -X POST -H Authorization: Bearer ${SLACK_TOKEN} \ -H Content-Type: application/json \ -d {channel:${SLACK_CHANNEL},text:构建成功 ✅} \ https://slack.com/api/chat.postMessage } } failure { script { sh curl -X POST -H Authorization: Bearer ${SLACK_TOKEN} \ -H Content-Type: application/json \ -d {channel:${SLACK_CHANNEL},text:构建失败 ❌} \ https://slack.com/api/chat.postMessage } } } }在这个示例中Slack Token 通过 Jenkins Credentials 管理流水线运行时以环境变量的形式注入不会出现在日志里。6.4 消息中附带任务链接仅仅发送“成功”或“失败”还不够更好的做法是在消息里附带构建链接方便同事直接点击查看。以 Python 为例可以在消息内容中加入链接build_url https://github.com/your-repo/actions/runs/123456789 MESSAGE f构建成功点击查看{build_url}Slack 的消息格式支持 URL 与文本的组合实际显示时https://...会渲染成可点击的链接。如果是更复杂的富文本可以考虑使用 Block Kit 格式这里就不展开了。7. 常见问题与排查思路在 SlackCLI 和 Slack API 的使用过程中几乎每个人都会遇到下面这些问题。这里统一整理成表格并补充详细的排查步骤。问题现象常见原因解决思路安装失败或slack: command not foundPATH 没有配置检查安装目录手动添加 PATH登录时浏览器没有自动打开系统没有默认浏览器或无浏览器环境手动复制终端中的链接到浏览器访问登录后命令提示未认证授权流程未完成重新执行slack login发送消息报错missing_scope应用缺少权限在应用管理页添加对应 Scope 并重新安装发送消息报错not_in_channelBot 不在目标频道手动邀请 Bot 加入频道或调用conversations.join发送消息报错invalid_authToken 错误或已失效检查 Token 是否以xoxb-开头重新安装应用查询频道列表为空Bot 无查看频道权限添加channels:read权限中文消息乱码请求编码问题确保请求头 Content-Type 包含charsetutf-87.1 排查步骤建议遇到问题时建议按照以下顺序排查先确认网络能正常访问 Slack 服务。再确认 Token 是否有效、是否对应目标工作区。然后检查应用权限中是否包含所需 Scope。接着确认 Bot 是否已经加入目标频道。最后检查消息内容格式尤其是 JSON 是否转义正确。这套顺序基本能解决 90% 以上的消息发送问题。7.2 如何避免重复踩坑我个人的经验是在项目一开始就创建一个专门的 Slack 应用并把所有权限和 Token 记录下来而不是在多个测试应用之间来回切换。另外把发送消息的逻辑封装成公共函数或独立模块这样后续项目复用会更方便排查问题时也不用到处找代码。8. 最佳实践与工程建议8.1 Token 管理Token 是最敏感的信息任何时候都不应该出现在代码、日志或 Git 仓库中。建议开发环境放到.env文件中并加入.gitignore。CI/CD 环境使用平台的 Secret 管理功能。本机长期使用可以使用系统密钥链保存。示例.env结构SLACK_BOT_TOKENxoxb-xxxxxxxx SLACK_CHANNELC1234567890Python 读取方式import os from dotenv import load_dotenv load_dotenv() SLACK_TOKEN os.getenv(SLACK_BOT_TOKEN) CHANNEL os.getenv(SLACK_CHANNEL)8.2 权限最小化原则给 Slack 应用配置权限时只申请当前需要的最小权限范围。比如只发送消息就只加chat:write不需要读取历史消息就不要申请channels:history。权限越多风险面越大值得始终记住一切权限申请都要遵循最小化原则。8.3 消息内容设计自动化通知虽然发送简单但内容设计直接影响团队协作效率。建议必须包含事件类型是成功还是失败。必须包含项目/任务名称。必须包含链接方便继续查看。可以包含触发人、时间等上下文信息。避免刷屏同一个任务多次失败时可以考虑消息聚合。一个相对完整的消息示例[定时任务] 每日数据同步 状态: 失败 触发时间: 2025-06-01 03:00:00 错误信息: 上游数据库连接超时 查看详情: https://your-platform.com/tasks/1238.4 异常处理与重试在脚本中调用 Slack API 时不能只假设一次请求必定成功。网络抖动、Token 过期、限流都可能发生。建议做好以下处理捕获网络异常避免脚本崩溃。对 429 限流响应做退避重试。记录失败日志方便后续排查。对于不影响主流程的消息通知建议“失败不影响主流程”避免消息服务挂掉导致整个构建失败。在 Python 中可以用try...except包裹请求逻辑简单的重试可以这样实现import time import urllib.error def send_slack_message_with_retry(token, channel, text, retries3): for attempt in range(1, retries 1): try: response send_slack_message(token, channel, text) if response.get(ok): return response if response.get(error) in (ratelimited, internal_error): time.sleep(2 * attempt) continue return response except urllib.error.URLError as e: print(f网络异常第 {attempt} 次重试: {e}) time.sleep(2 * attempt) return {ok: False, error: max_retries_exceeded}8.5 日志与可观测性在 CI/CD 中接入 Slack 通知后你还需要注意通知本身也需要日志。import logging logging.basicConfig(levellogging.INFO, format%(asctime)s %(levelname)s %(message)s) logger logging.getLogger(__name__) logger.info(开始发送Slack消息) response send_slack_message(...) if response.get(ok): logger.info(消息发送成功ts%s, response.get(ts)) else: logger.error(消息发送失败error%s, response.get(error))这样即使哪一次通知没有送达你也可以通过日志快速定位是网络问题、Token 问题还是参数问题。8.6 环境隔离如果团队有多个环境比如测试环境、生产环境建议为每个环境创建不同的 Slack 应用和 Token并配置不同的通知频道。这样生产告警和测试噪音不会混在一起。9. 总结本文从 SlackCLI 的概念入手介绍了它的价值、安装、登录认证方式并通过一个完整案例演示了如何创建 Slack 应用、获取 Bot Token以及用 Python 和 Node.js 向 Slack 频道发送消息。最后还结合 CI/CD 自动化场景给出了 GitHub Actions 和 Jenkins 的集成示例并整理了常见问题与最佳实践。回过头来看这里面的核心并不在于 SlackCLI 命令本身而在于你如何理解 Slack 的权限体系、Token 管理和 API 调用方式。只要理清了这几个概念无论是用 SlackCLI还是直接写脚本调用 Web API都能顺畅完成。下一步如果你希望进一步深入学习可以尝试以下方向阅读 Slack API 官方文档研究 Block Kit 交互式消息。开发一个自定义 Slack Bot处理/slash斜杠命令。结合消息队列做一个自动收集告警并去重通知的服务。如果本文对你有帮助可以收藏备用后续使用 SlackCLI 时遇到问题也能快速翻出来排查。实践才是不变的硬道理。