飞书 CLI 到底是个啥东西，值不值得普通用户试试

飞书 CLI 到底是啥东西，值不值得普通用户试试

我最早接触飞书 CLI 是因为公司突然要求全员用飞书，那会儿我还在用微信处理工作，一下子被拉进十几个群，消息乱得跟菜市场似的。后来有个同事神神秘秘地给我发了个链接，说「试试这个，能自动整理消息」。我点进去一看，好家伙，飞书 CLI。说白了这个东西就是个命令行工具，能让你在电脑终端里直接操作飞书的各种功能，发消息、查文档、管群组，不用老是打开飞书 App 点来点去。对程序员来说这玩意儿挺香的，但我当时第一个念头是：我一个做内容的，又不写代码，这玩意儿对我有用吗？

下载与安装过程

我第一次下载就差点被劝退。网上一搜「飞书 CLI 下载」，出来的页面鱼龙混杂，有些挂着飞书的名头，其实是广告。最好直接去飞书开放平台，找到开发者工具那一栏，点本页下载按钮，会看到一个叫 lark_cli 的压缩包。我当时下的 Windows 版，解压出来是个 exe 文件，双击竟然闪一下没反应。后来才搞明白，这东西要在命令行里跑。你需要把它解压到一个固定的文件夹，比如 C:lark，然后打开 cmd 或者 PowerShell，输入路径加上文件名才能启动。Mac 用户简单点，解压后放到 Applications 目录，终端里直接输命令就行。我装好那会儿还在想，一个办公工具的辅助工具，怎么搞得跟装游戏似的。

初步设置与账户绑定

装好只是开始，绑定账户才是重头戏。打开终端输入 lark help，会看到一堆命令，当时我头都大了。实际上你只需要先搞定认证，也就是让 CLI 知道你是谁。运行 lark auth，它会弹出一个网页让你扫码，跟飞书 PC 端登录一样。扫完码终端里会显示登录成功，这时候你就绑定上了。有个坑我踩过：如果你在公司的飞书和个人飞书之间切换，每次都要重新 auth，因为它只存一套 token。我那时候为了测试，在自己的机器上绑了公司账户，结果上班时发的消息全跑到个人手机上了，差点被主管抓包。建议你在家里和公司的电脑上分别绑定对应账户，别混着用。

发消息与批量操作

聊点实际的。飞书 CLI 最实用的功能我个人觉得是发消息，尤其是批量发。比如你是一个小组负责人，每个工作日要定时提醒大家更新进度。以前我得一个个群发，或者用机器人，但机器人要配置 webhook。有了 CLI，一行命令就能搞定：lark message send --receiver open_id:xxx --msg_type text --content "今天的日报请在下班前提交"。你可以把这个写进一个 bat 脚本或者 shell 脚本里，然后设置定时任务，Windows 上用任务计划程序，Mac 上用 launchd。我第一次跑通的时候，感觉像发现了新大陆。但注意一个细节：open_id 怎么找？你得去飞书开放平台创建一个应用，然后在成员管理里查看。如果公司没有给你开发者权限，这一套流程会卡住。我一开始就是卡在这一步，折腾了半小时才发现自己没申请权限。

文档与文件操作的冷知识

飞书 CLI 不光能发消息，还能操作云文档。比如你想批量创建周报模板，以前要一个个复制粘贴，现在 lark doc create --title "周报_0901" --folder_token xxx 就能搞定。Folder token 是你飞书云空间里某个文件夹的 ID，在网页端打开文件夹，看地址栏最后那串字符就是。这里有个我试出来的小技巧：你可以写个 Python 脚本，循环生成一周的日报模板，然后在 CLI 里面执行。我当时给团队做了一个自动归档脚本，每周五晚上自动把本周的文档归类到对应月份的文件夹里，省了大家好多时间。但说实话，对于普通用户，这种功能你可能一年也用不上几次。除非你像我一样，每天要和几十个文档打交道，否则手动拖拽反而更省心。

常见问题与解决办法

用飞书 CLI 的过程中，最让我头疼的是权限。你跑一个命令，结果返回「Forbidden」，那就说明你的账户没有对应操作权限。比如我想删除一个过期的群消息，但我的账户不是群主，命令就报错。解决办法要么让群主给你管理员权限，要么你在飞书开放平台上给应用配置好 scope。另一个常见问题是 token 过期，CLI 默认的有效期是两小时，如果你长时间不操作，再跑命令就会让你重新 auth。我当时写脚本时没考虑这个问题，半夜定时任务跑失败了第二天才发现。后来我在脚本开头加了一行 lark auth --check，如果 token 失效就自动退出并发邮件通知我。再一个坑是跨平台兼容，我在 Windows 上写的脚本，拿到 Mac 上路径全变了，得用环境变量来指定 CLI 路径。如果你不是程序员，这些坑可能直接把你劝退。

到底值不值得普通用户试试

最后聊聊值不值的问题。如果你只是偶尔用飞书聊聊天、传个文件、开个会，那 CLI 对你来说纯属多余。我给你算笔账：装这个工具需要你会点命令行基础，理解 token、scope、open_id 这些概念，还得能处理各种报错。普通用户花一个小时下载配置，可能一辈子都用不上第二次。但如果你是那种天天被飞书消息轰炸、需要定期整理文档、或者负责给团队做自动化流程的人，那 CLI 能帮你省不少手。我个人觉得，它更适合「日常被工作推着走、但又想反过来推工作一把」的人。比如我上周用 CLI 配合定时任务，每天中午自动给项目群里发下午茶投票链接，大家不用在群里接龙了。这种成就感，手动点按钮永远给不了。但如果你连 cmd 和 PowerShell 都分不清，还是别勉强自己，飞书的官方客户端其实够用了。