飞书CLI到底是什么鬼，命令行也能玩飞书
飞书CLI到底是什么鬼，先别急着跑
我第一次听说飞书CLI的时候，脑子里的画面还是个黑乎乎的终端窗口，输入一堆看不懂的命令，然后电脑自己噼里啪啦干一堆活。说实话，我当时也觉得这玩意儿跟我一个天天在飞书里发消息、传文件的普通用户有啥关系？后来是因为项目组要求自动化发通知，不得不硬着头皮折腾了一下，才发现这东西还真不是给程序员专用的。飞书CLI其实是一个命令行工具，能让你在终端里直接操作飞书的很多功能，比如发消息、管理用户、拉取群列表，甚至写机器人脚本。它背后的逻辑是把飞书的API封装成了简单的命令，省去你手写请求头和签名算法那些破事。对我这种半吊子来说，最直接的感受就是——不用打开浏览器、不用点各种菜单，一条命令就能把消息丢到群里，爽是真的爽。
不过刚开始用的时候，最大的门槛反而是“CLI”这三个字母听起来太吓人了。很多人一听命令行就联想到Linux内核编译、vim退出不会之类的噩梦。但飞书CLI其实没那么难，它的命令基本都长这样：`lark-cli send --title "警告" --content "服务器挂了"`，跟聊天框里打字差不多，只是换了个地方。你甚至可以把它想象成一个没有图标的飞书客户端，只不过输入框在终端里。如果你跟我一样对终端有心理阴影，可以先在电脑上装个Windows Terminal或者iTerm2，至少颜色好看点，心情能好不少。
安装前先搞清楚你的系统环境
开始装之前，先看看你电脑啥系统。飞书CLI支持Windows、macOS和Linux，但不同系统的安装方式差别挺大。我自己用的是macOS，所以踩过的坑基本都在这边。Windows用户反而会简单点，因为官方直接给了个exe安装包，下载完双击就完事。Mac用户就麻烦点，得先确认你有没有装Homebrew。我当时就是不知道Homebrew是啥，折腾了半天才弄明白。如果你Mac上还没装Homebrew，建议先去Homebrew官网三行命令装上，然后直接`brew install lark-cli`就能搞定，省得手动下载安装包再解压。
Linux用户更考验动手能力，Ubuntu和CentOS的命令还不一样。比如Ubuntu下可以用`sudo apt install`，但前提是你得先把官方仓库地址加到源列表里。我有个同事在服务器上装，折腾了半小时才发现是自己把系统架构写错了。其实最稳妥的办法是去飞书开放平台找到安装指引，点本页下载按钮拿到的那个压缩包，解压后把二进制文件放到`/usr/local/bin`里就行，记得加执行权限，不然会报错“Permission denied”。另外友情提醒，Windows用户最好不要把安装包丢C盘根目录，否则后面写配置文件时可能会被权限卡住，我当初就因为偷懒被坑过。
配置授权才能干活，别以为装上就能用
装完CLI只是开始，接下来就是最让人头大的授权。如果你以为打开终端直接输入`lark-cli`就能像聊天软件一样用，那得泼盆冷水——飞书CLI需要配置App ID和App Secret才能访问你的飞书团队。这两串东西去哪儿找呢？打开浏览器，登录飞书开发者后台，创建一个企业自建应用，在凭证与基础信息页面就能看到。注意这里的App ID格式是一个字符串，App Secret更是一长串字母数字组合，复制的时候千万别漏掉字符，我因为少复制了一个下划线，折腾了半小时查日志。
配置的方式有两种，一种是用交互式命令：`lark-cli config`，然后按提示粘贴进去；另一种更直接，在终端里输入`lark-cli config set app_id "你的ID"`和`lark-cli config set app_secret "你的秘钥"`。我建议用第一种，因为它会校验格式，如果粘错了当场报错。还有个小坑：这个配置是写在`~/.lark-cli/config.yaml`文件里的，如果你换了电脑或者重装了系统，记得备份这个文件。公司内部服务器上用的话，最好把配置文件权限设成600，不然别人`cat`一下就看到了你的密钥，那就尴尬了。
发送消息到群里，到底有多快
配置好之后，先拿发送消息练练手。比如我想给测试群里发一条“今天下午三点开会”的通知，命令长这样：`lark-cli message send --chat_id "oc_xxxxxxxx" --content "今天下午三点开会"`。这个`--chat_id`是群的唯一标识，怎么获取呢？可以先用`lark-cli chat list`拉出你所有群的列表，然后把想发消息的群ID记下来。如果你嫌麻烦，也可以用群名模糊搜索：`lark-cli chat search --name "测试群"`，返回结果里就有ID。
我一开始犯的错是直接在内网服务器上跑，结果报“403 Forbidden”，查了半天才发现是App的权限没开。记得去开发者后台的应用权限里，把“获取群信息”和“发送群消息”这两项打开。更坑的是，有时候刚加完权限还得等个五分钟才能生效。还有个小技巧：如果你只想测试功能，别真的往正经群里发消息，可以先建个只有自己一个人的“测试群”，或者设置`--content`为`Hello World`，看看终端返回的是不是`success`。消息格式还能支持富文本，比如加粗、换行，使用`--msg_type "post"`参数，再在后面跟个JSON格式的内容，但语法挺绕，我建议先用纯文本跑通再说。
写脚本批量管理群成员，解放双手
当你对单条命令熟了之后，就该上点难度——写个Shell脚本批量拉人进群。比如新项目启动，需要把几十个新同事加到工作群里，手动点飞书界面一个个邀请太反人类了。这时候CLI就派上用场了。先准备一个文本文件，一行一个邮箱地址，比如`members.txt`，然后写一个简单的bash循环：
```
for email in $(cat members.txt); do
lark-cli chat member add --chat_id "oc_xxxxxxxx" --email $email
echo "已添加: $email"
done
```
但这里有个隐藏问题：飞书API有速率限制，每秒最多请求多少次？我没查到官方具体数字，但实测大概是每秒10次左右，所以最好在循环里加个`sleep 0.1`，不然可能会报“429 Too Many Requests”，然后被限流一分钟。还有就是如果你的同事邮箱在飞书里没激活账号，命令会直接报错，但不会停，最后脚本跑完你都不知道哪些人没加成功。我的做法是在脚本里把错误输出重定向到另一个文件：`2>> error.log`，跑完再自己去翻那个日志手动补加。
还有更骚的操作：写个定时任务，比如每天早上八点给某个群发日报。用Crontab加一行：`0 8 * * * lark-cli message send --chat_id "oc_xxxx" --content "早安，今日重点工作是..."`，这不比手动到点发消息准点多了？但注意，crontab的环境变量可能和终端不一样，你需要把`lark-cli`的绝对路径写清楚，或者source一下你的shell配置文件。
翻车现场：我遇到过的各种报错
用了这么久，翻车次数也不少。最经典的错误是“Error: invalid app_id or app_secret”，明明复制粘贴正确，但还是报错。后来发现是配置文件的格式问题——我手动编辑了`config.yaml`，把缩进弄乱了，YAML对缩进极其敏感，多一个空格都不行。解决办法很简单，用`lark-cli config set`命令改，别手动改文件。如果非要手动改，先备份原文件，然后用`yaml`格式的编辑器。
另一个让我崩溃的是“Cannot resolve host api.feishu.cn”。我的服务器在内网，DNS解析不到外网域名。解决办法是给服务器配个代理，或者把`api.feishu.cn`解析到你们公司网络出口的公网IP上。如果你实在搞不定网络，可以试试用`--api-base`参数指定一个不同的飞书API地址，但前提是你得知道飞书开放平台在你们区域用的哪个域名，不同地区不一样。
还有一次我写了个循环发消息的脚本，结果一跑就是上千条，把测试群刷屏到所有人都愤怒了。原因是`--chat_id`写错了，发到了一个大群。从那以后我养成了一个习惯：每次跑批量操作前，先用`--dry-run`参数（如果支持的话）模拟一下，不真的执行，只输出日志。可惜飞书CLI好像没这个参数，我就自己写个小脚本，先输出命令但不执行，人工检查一遍再跑。
飞书CLI到底值不值得折腾
说到最后，飞书CLI这东西，你要是只是个普通员工，每天就发发消息、传传文件，那确实用不上。但如果你手上有大量重复性操作，比如每天都要给不同群发周报、定期拉取考勤数据、自动创建会议，那它就真能帮你省下不少时间。而且它还能和你的CI/CD流程结合，比如部署完服务自动在飞书群里发个通知，这比盯着Jenkins日志靠谱多了。
不过也得说实话，飞书CLI目前还不是特别成熟。比如有些API功能还没覆盖全，你想撤回消息？不好意思，命令不支持。你想查某个用户的详细信息？可能得绕道。文档写得也不算详细，很多参数我都是靠猜和搜出来的。最要命的是，有些命令的返回结果是JSON格式，一长串数据堆在终端里，肉眼根本看不清楚，得用`jq`工具格式化一下。所以如果你不太习惯命令行，先用飞书开放平台上的API调试工具熟悉一下字段含义，可能更友好。
总之，我个人的建议是：你先用最基础的功能试试水，比如发条消息到自己的测试群，感受一下那种“不用开界面就能搞定”的爽感。如果觉得不顺手，那就不用强迫自己。但如果你跟我一样，半夜被报警电话叫醒后能用一条命令把故障信息扔到技术群里，那种掌控感还是挺上头的。