夜雨聆风
引言：为什么你需要飞书CLI？
作为一名个人创作者，你是否遇到过这些困扰：
灵感来了随手记在飞书文档里，后来却再也找不到 收藏了上百篇优质文章，却从未系统整理成知识库 每天花大量时间在飞书界面间切换，重复操作消耗创造力 想建立个人学习框架，却苦于没有高效的工具支撑
如果以上任何一条戳中了你，那么今天介绍的飞书CLI（lark-cli）将是你的救星。
这个由飞书官方开源的命令行工具，GitHub上线仅47天就突破万星，被誉为"AI Agent时代的办公革命"。它把飞书200+核心能力搬到终端，配合19个AI Agent Skills，让你用自然语言就能操控飞书全部功能。
本文将手把手教你从安装到实战，用飞书CLI打造专属的个人知识库管理系统。
第一部分：飞书CLI基础安装与配置
1.1 什么是飞书CLI？
飞书CLI（@larksuite/cli）是飞书官方团队开发的开源命令行工具，采用Go语言编写，MIT协议开源。它的核心价值在于：
- 终端操控飞书
：不用打开任何界面，敲几行命令就能操作消息、日历、文档、知识库 - AI Agent原生支持
：专为AI Agent设计，让AI助手直接接管飞书操作 - 200+命令覆盖
：涵盖飞书所有核心功能模块 - 跨平台支持
：Windows、macOS、Linux全平台可用
1.2 环境准备
在开始安装前，请确保你的系统已安装：
- Node.js
（版本16+） - npm
或 yarn
检查Node.js版本：
node-v
如果未安装，请前往 nodejs.org 下载安装LTS版本。
1.3 安装飞书CLI
打开终端，执行以下命令：
# 全局安装飞书CLI
npm install -g @larksuite/cli
# 验证安装
lark-cli --version
安装成功后，你会看到版本号输出，例如 1.0.0。
1.4 配置应用凭证
飞书CLI需要飞书应用的凭证才能访问你的飞书数据。配置步骤如下：
步骤1：创建飞书应用
访问 飞书开发者平台 点击"创建企业自建应用" 填写应用名称（如"个人知识库助手"） 记录 App ID和App Secret
步骤2：配置权限
在应用后台，开通以下权限：
云文档相关权限（读取、编辑文档） 知识库相关权限（读取、管理知识库） 消息相关权限（发送消息）
步骤3：本地配置
# 初始化配置
lark-cli config init
# 按提示输入App ID和App Secret
1.5 安装AI Skills（关键步骤）
这是让AI Agent能够操控飞书的关键：
# 安装飞书AI Skills
npx skills add larksuite/cli -y -g
安装完成后，你的AI助手就具备了操作飞书的能力。
第二部分：结合AI Agent使用飞书CLI
2.1 身份认证：User vs Bot
飞书CLI支持两种身份模式：
--as user | ||
--as bot |
用户身份认证：
lark-cli auth login --scope "calendar:calendar:readonly"
执行后会弹出授权链接，按提示完成授权即可。
2.2 AI Agent调用飞书CLI的原理
当你安装AI Skills后，AI助手获得了一组"技能包"，可以理解你的自然语言指令并转换为飞书CLI命令。
例如：
你说："帮我创建一个名为'读书笔记'的文档" AI转换为： lark-cli docs create --title "读书笔记"执行并返回结果
2.3 常用AI Agent指令示例
以下是一些可以直接对AI助手说的指令：
文档操作：
"在飞书里给我新建一个周报模板" "把昨天的会议纪要整理成文档" "查找我上个月写的关于AI的文章"
知识库管理：
"帮我把这个链接保存到'待读清单'知识库" "整理我收藏的所有设计资源" "创建一个学习Python的知识库结构"
日程管理：
"查看我这周的所有会议" "帮我预定下周三的会议室" "设置一个明天上午9点的提醒"
第三部分：实战案例——个人创作者的知识库管理
3.1 案例背景
假设你是一名内容创作者，每天会产生大量碎片化信息：
阅读文章时的灵感笔记 刷到的有价值的内容链接 学习到的新概念和方法论 自己的创作草稿和思路
目标是建立一套输入→整理→输出的完整工作流。
3.2 知识库架构设计
我们用飞书知识库搭建如下结构：
📚 个人知识库
├── 📝 灵感收集（Inbox）
│ ├── 待整理文章
│ ├── 临时笔记
│ └── 随机想法
├── 📖 学习框架
│ ├── 主题A（如：AI工具）
│ ├── 主题B（如：写作技巧）
│ └── 主题C（如：产品设计）
├── ✍️ 创作输出
│ ├── 文章草稿
│ ├── 发布记录
│ └── 素材库
└── 🔖 资源归档
├── 优质文章收藏
├── 工具推荐
└── 人脉笔记
3.3 实战步骤
步骤1：创建知识库结构
对AI助手说：
"帮我在飞书创建一个名为'个人知识库'的知识空间，并在里面创建四个文件夹：灵感收集、学习框架、创作输出、资源归档。"
AI会自动执行：
lark-cliwikicreate-space--name"个人知识库"
lark-cliwikicreate-node--parent"个人知识库"--name"灵感收集"
lark-cliwikicreate-node--parent"个人知识库"--name"学习框架"
lark-cliwikicreate-node--parent"个人知识库"--name"创作输出"
lark-cliwikicreate-node--parent"个人知识库"--name"资源归档"
步骤2：建立日常收集工作流
每天遇到有价值的内容时，直接对AI说：
"把这个链接保存到灵感收集文件夹，标题是《XXX》，标签是#AI #工具"
AI会：
自动提取链接内容摘要 在指定位置创建文档 添加标签和来源信息 返回确认信息
步骤3：定期整理工作流
每周一次，对AI说：
"帮我整理这周灵感收集里的内容，把关于AI的文章移到学习框架/AI工具文件夹，并生成一份摘要"
AI会：
扫描灵感收集文件夹 按主题分类内容 移动到对应位置 生成周报摘要
步骤4：创作输出工作流
当你要开始写作时：
"我要写一篇关于飞书CLI的教程，帮我从知识库里找相关资料，并创建一个文章大纲"
AI会：
搜索知识库中相关主题的内容 提取关键观点和数据 生成文章大纲 在创作输出文件夹创建草稿文档
3.4 进阶技巧
技巧1：批量导入现有内容
如果你之前用其他工具（如Notion、Obsidian）管理笔记，可以用飞书CLI批量迁移：
# 导出Notion为Markdown
# 使用飞书CLI批量导入
lark-clidocsimport--folder"学习框架"--files"*.md"
技巧2：自动化日报/周报
设置定时任务，让AI自动生成日报：
"每天晚上8点，帮我总结今天创建的所有文档，生成一份日报发送到我的工作群"
技巧3：知识库健康检查
定期对AI说：
"检查我的知识库，找出30天未访问的文档，并建议如何整理或归档"
第四部分：常见问题与解决方案
Q1：安装时提示权限不足？
解决方案：
# macOS/Linux 使用sudo
sudo npm install -g @larksuite/cli
# Windows 以管理员身份运行PowerShell
Q2：配置时提示App Secret错误？
检查清单：
确认App ID和App Secret没有多余的空格 确认应用已发布（在开发者后台点击"发布"） 确认已开通所需权限
Q3：AI Agent无法识别飞书命令？
解决方案：
确认已安装AI Skills： npx skills list查看是否包含larksuite/cli重启AI助手或终端 检查身份认证状态： lark-cli auth status
Q4：如何查看所有可用命令？
# 查看所有命令
lark-cli --help
# 查看特定服务命令
lark-cli docs --help
lark-cli wiki --help
lark-cli calendar --help
结语：开启你的Agent办公时代
飞书CLI不仅仅是一个命令行工具，它代表了AI Agent时代办公方式的变革。当AI助手能够直接操控你的生产力工具，重复性工作将被自动化，你可以把更多精力投入到创造性工作中。
对于个人创作者而言，飞书CLI+AI Agent的组合，让你能够：
建立系统化的知识管理体系 实现从灵感到输出的无缝衔接 用自然语言管理复杂的文档和知识库 构建真正属于你的"第二大脑"
现在就开始安装飞书CLI，让你的AI助手帮你管理知识库吧！
附录：快速参考命令
# 安装
npminstall -g @larksuite/cli
npxskillsaddlarksuite/cli -y -g
# 配置
lark-cliconfiginit
lark-cliauthlogin
# 文档操作
lark-clidocscreate--title"文档标题"
lark-clidocslist
lark-clidocsget--token <文档token>
# 知识库操作
lark-cliwikilist-spaces
lark-cliwikicreate-space--name"空间名称"
lark-cliwikicreate-node--parent <父节点> --name"节点名称"
# 日历操作
lark-clicalendarlist-events
lark-clicalendarcreate-event--title"会议标题"--start"2026-01-01 10:00"
本文基于飞书CLI v1.0.0编写，后续版本可能有更新，请以官方文档为准。
