飞书 CLI 配置文档 · AI 实践分享

本文档描述如何使用 飞书 CLI + 飞书多维表格 搭建个人 AI 助理系统，涵盖安装、配置、命令速查等完整内容。

核心架构

用户输入
"帮我记录..."

↓

AI 调度层

理解用户意图 · 调用 CLI 工具 · 设置定时任务

↓

飞书 CLI（工具层）

写操作：写入多维表格 · 读操作：查询多维表格

↓

飞书多维表格（数据层）

待办事项表 · 项目进度表

工作流程

场景 1：用户说"帮我记录"

📝

用户 → AI → 飞书 CLI → 多维表格
用户"帮我记录，四月份要去香港办银行卡" → AI 理解意图、提取任务 → 飞书 CLI 写入待办表格 → 回复"已记录"

场景 2：定时任务触发

⏰

定时器 → AI → 飞书 CLI → 多维表格 → 提醒
每天早上 8 点触发 → AI 调用 CLI 查询 → 返回今日待办 → 整理结果发送提醒

第一部分：安装飞书 CLI

系统要求

Node.js >= 18.0.0
npm >= 9.0.0
飞书账号（企业或个人均可）

安装步骤

      bash
# 1. 检查 Node.js 版本
node -v
npm -v

# 2. 全局安装飞书 CLI
npm install -g @larksuite/cli

# 3. 验证安装
feishu --version

登录飞书

      bash
feishu login

执行后会显示二维码，用飞书手机 App 扫码确认登录即可。

验证登录状态

      bash
feishu auth status

第二部分：创建飞书多维表格

待办事项表格

在飞书中创建多维表格，包含以下字段：

字段名	字段类型	说明
任务名称	文本	任务描述
截止日期	日期	任务截止时间
优先级	单选	高 / 中 / 低
状态	单选	未开始 / 进行中 / 已完成
备注	文本	补充说明
创建时间	创建时间	自动记录
完成时间	日期	任务完成时填写

项目进度表格（可选）

字段名	字段类型	说明
项目名称	文本	项目名称
当前进度	数字	0-100%
更新日期	日期	最后更新时间
负责人	文本	负责人姓名
下周计划	文本	下周工作计划
风险点	文本	潜在风险

获取表格 ID

在飞书多维表格 URL 中找到表格 ID：

      url
https://feishu.cn/base/{app_token}?table={table_id}
                                      ↑ 这就是 table_id

第三部分：配置说明

核心逻辑

写操作（用户说"帮我记录"）

✍️

当用户输入包含"帮我记录"、"记一下"、"记住"等关键词时：
1. 提取任务信息（任务名称、截止日期、优先级等）
2. 写入多维表格
3. 回复"已记录"

读操作（定时任务触发）

📋

当定时任务触发时（如每天早上 8 点）：
1. 查询多维表格（截止日期=今天或未来 7 天，状态≠已完成）
2. 整理查询结果
3. 发送提醒

完整交互流程示例

示例 1：记录待办

💬

用户：帮我记录，四月份要去香港办银行卡

分析：提取任务 → "去香港办银行卡"，截止 2026-04-30，优先级：中

执行：调用 CLI 写入待办事项表格

回复：✅ 已记录：去香港办银行卡，截止日期 2026-04-30

示例 2：定时提醒

🌅

08:00 触发 → 查询今日待办 → 按优先级排序 → 发送提醒：

📋 早安！今日待办提醒：
🔴 高优先级（今天截止）：
- [ ] 完成项目报告
🟡 中优先级：
- [ ] 去香港办银行卡（4 月 30 日）

说"完成项目报告"可标记为已完成~

示例 3：完成任务

✅

用户：完成项目报告

执行：更新记录 → 状态：已完成，完成时间：2026-04-04

回复：✅ 已标记"完成项目报告"为已完成，辛苦了！🎉

第四部分：飞书 CLI 命令速查

表格操作

      bash
# 列出所有多维表格
feishu table list

# 查看表格结构
feishu table info "{table_id}"

# 查询记录
feishu table query "{table_id}" --filter '状态 != "已完成"'

# 创建记录
feishu table create "{table_id}" --fields '{
  "任务名称": "xxx",
  "截止日期": "2026-04-30",
  "优先级": "高",
  "状态": "未开始"
}'

# 更新记录
feishu table update "{record_id}" --fields '{
  "状态": "已完成",
  "完成时间": "2026-04-04"
}'

# 删除记录
feishu table delete "{record_id}"

高级查询

      bash
# 按条件筛选
feishu table query "{table_id}" --filter '
  截止日期 >= 2026-04-04 AND 
  截止日期 <= 2026-04-11 AND 
  优先级 = "高"
'

# 排序
feishu table query "{table_id}" --sort '截止日期 ASC'

# 限制结果数量
feishu table query "{table_id}" --limit 10

第五部分：意图识别与定时任务

意图识别规则

配置意图识别，根据用户输入匹配对应操作：

意图名称	匹配模式	操作
record_todo	帮我记录* / 记一下* / 记住* / 添加待办*	写入表格
complete_todo	完成* / 做完了* / 已完成*	更新表格
query_todo	我有什么待办* / 查询待办* / 待办列表*	查询表格

定时任务管理

      bash
# 查看定时任务列表
openclaw cron list

# 添加定时任务
openclaw cron add --name "每日待办提醒" --cron "0 8 * * *"

# 删除定时任务
openclaw cron remove "{job_id}"

# 暂停 / 启用定时任务
openclaw cron pause "{job_id}"
openclaw cron resume "{job_id}"

第六部分：故障排查

常见问题

⚠️

问题 1：飞书 CLI 命令找不到
重新安装：npm install -g @larksuite/cli，检查 PATH 配置

问题 2：多维表格权限不足
联系表格管理员添加权限，或使用有权限的账号重新登录

问题 3：定时任务不执行
检查 cron 服务状态，查看定时任务日志

问题 4：查询结果为空
检查筛选条件是否正确，确认表格中有数据

获取帮助

      bash
# 飞书 CLI 帮助
feishu --help
feishu table --help

# OpenClaw 帮助
openclaw --help
openclaw cron --help

附录：完整配置示例

个人待办管理配置

📁

1. 在飞书中创建待办事项多维表格（任务名称、截止日期、优先级、状态、备注、创建时间、完成时间）
2. 配置意图识别：当用户说"帮我记录 XXX"时，调用飞书 CLI 写入表格
3. 设置每日提醒（每天早上 8 点）：openclaw cron add --name "每日待办提醒" --cron "0 8 * * *"

项目进度跟踪配置

📊

1. 在飞书中创建项目进度多维表格（项目名称、当前进度、更新日期、负责人、下周计划、风险点）
2. 设置每周汇报（每周五下午 5 点）：openclaw cron add --name "每周项目汇报" --cron "0 17 * * 5"
3. 查询本周更新的项目，生成汇报消息发送到工作群

更新日志

2026-04-04：初始版本，明确调度层角色，区分写操作（用户触发）和读操作（定时任务触发）