让你的AI助手读写飞书云文档：OpenClaw + lark-cli 完整配置教程（含懒人方式）

让你的AI助手读写飞书云文档OpenClaw lark-cli 完整配置教程作者小羊阳 | 更新时间2026-04-05适用版本OpenClaw (CoPaw) lark-cli v1.0.4飞书原文https://www.feishu.cn/docx/Jcs1dA13BoS3l2xCVA7cJ6Zbnsc 目录一、教程目标二、前置要求三、创建飞书自建应用四、安装与配置 lark-cli五、用户授权六、快速验证七、OpenClaw 集成使用八、常见问题解答九、lark-cli 完整能力一览十、下一步十一、懒人方式一、教程目标完成本教程后你的 AI 助手将能够✅ 搜索飞书云文档、知识库、wiki✅ 创建新的飞书文档✅ 读取文档内容✅ 写入内容段落、标题、列表、代码块等✅ 查询日历、发送消息、搜索通讯录二、前置要求在开始之前请确保你拥有飞书账号个人版或企业版均可飞书开发者后台访问权限用于创建自建应用一台运行 OpenClaw 的服务器/电脑本教程以 Docker/Linux 环境为例基础的命令行操作能力三、创建飞书自建应用 参考飞书开放平台 - 自建应用开发指南3.1 创建应用打开 飞书开放平台登录你的飞书账号点击右上角「开发者后台」点击「创建应用」填写以下信息应用名称随意起比如「我的AI助手」应用描述随意填写点击「确认创建」3.2 获取凭证点击左侧菜单「凭证与基础信息」找到App ID和App Secret将它们复制保存下来⚠️ App Secret 点击「查看」按钮才能看到完整内容请妥善保管3.3 开通权限点击左侧菜单「权限管理」搜索并开通以下权限查看、评论和导出云文档docx:document:readonly创建和编辑云文档docx:document:write获取文件元信息drive:drive:readonly管理云空间中所有文件drive:folder:write点击「申请发版」或联系企业管理员审批 参考飞书开放平台 - 权限管理3.4 开启机器人能力点击左侧菜单「应用能力」→「机器人」点击「开启」四、安装与配置 lark-cli 参考lark-cli 官方 GitHub 仓库4.1 安装npm install -g larksuite/cli 参考lark-cli npm 安装页4.2 配置凭证# 交互式配置 lark-cli config init --new # 非交互式配置 echo 你的App Secret | lark-cli config init \n --app-id 你的AppID \n --app-secret-stdin \n --brand feishu4.3 验证lark-cli doctor 参考lark-cli config 命令文档五、用户授权 参考飞书 OAuth 2.0 设备授权流程5.1 发起授权lark-cli auth login --no-wait --recommend --json复制输出的verification_url链接用浏览器打开并扫码确认。5.2 完成登录lark-cli auth login --device-code 你获取到的device_code5.3 补充搜索权限lark-cli auth login --no-wait --scope search:docs:read --json重复扫码授权流程。 参考lark-cli auth login 命令文档六、快速验证# 搜索文档 lark-cli docs search --query 文档 --as user # 创建文档 lark-cli docs create --title 测试 --markdown # 你好 # 查询日历 lark-cli calendar agenda --as user 参考lark-cli docs 命令 参考lark-cli calendar 命令七、OpenClaw 集成使用 参考OpenClaw (CoPaw) 官网配置完成后直接用自然语言指挥 AI 助手操作飞书「帮我搜一下关于「项目总结」的文档」「把会议内容写成飞书文档」「下午3点开会帮我建个议程文档」AI 助手会自动调用 lark-cli 完成操作。八、常见问题解答Q1: lark-cli doctor 显示 token_exists fail请参考本文第五节完成用户授权。Q2: docs search 报错 missing_scope执行lark-cli auth login --no-wait --scope search:docs:read --json补充授权。Q3: App Secret 无效invalid_client确认 App Secret 是否正确应用是否已发布/审批通过。Q4: 授权链接打不开确保手机装了飞书 App且和浏览器登录的是同一账号。Q5: Docker 环境中 keychain 不可用lark-cli 会自动保存 Secret 到文件重新运行config init即可。 参考lark-cli 常见问题九、lark-cli 完整能力一览 参考lark-cli GitHub - 完整能力列表docs— 云文档 CRUD、搜索calendar— 日程、事件、忙闲im— 消息、群聊管理base— 多维表格sheets— 电子表格task— 任务管理mail— 邮箱contact— 通讯录wiki— 知识库drive— 文件管理approval— 审批十、下一步在 OpenClaw 中定义专属技能接入 MCP 协议深度集成飞书自定义工作流如「会议结束 → 自动生成纪要 → 发到群里」 参考lark-cli AI Agent Skills 集成十一、懒人方式你只需要做两件事给 AI 助手提供凭证 扫码授权。其他全部由它自己完成。11.1 懒人核心原则AI 助手能做的事✅ 安装 lark-cli✅ 配置 App ID 和App Secret✅ 验证凭证是否正确✅ 生成授权链接并打开给你扫码✅ 轮询授权结果✅ 补充额外权限授权✅ 运行测试验证能力必须你亲自做的❌ 提供 App ID 和 App Secret❌ 用飞书 App 扫码授权11.2 一句话总结懒人方式把下面的提示词复制发给你的 AI 助手剩下的它自己搞定帮我配置飞书云文档能力。请按以下步骤做 1. 用浏览器打开这个教程https://www.feishu.cn/content/article/7623291503305083853 把教程内容完整读一遍理解 lark-cli 的安装、配置、授权流程 2. 在我的服务器上执行 lark-cli 安装 npm install -g larksuite/cli 3. 运行 lark-cli doctor 检查当前状态 4. 如果显示缺少凭证配置问我 App ID 和 App Secret 5. 拿到凭证后完成配置 6. 运行 lark-cli auth login --no-wait --recommend --json 把返回的 verification_url 发给我告诉我扫码授权 7. 我扫码确认后用返回的 device_code 执行登录命令 lark-cli auth login --device-code device_code 8. 如果缺少搜索权限按上面的方式再走一遍授权流程 9. 全部完成后用以下命令验证各项能力把结果告诉我 - lark-cli docs search --query 文档 --as user - lark-cli docs create --title 测试文档 --markdown # 你好 - lark-cli calendar agenda --as user11.3 懒人注意事项App ID 和 Secret 怎么获取把本教程第三节的 3.1 和 3.2 发给你的 AI 助手让它告诉你怎么操作。或者自己去 飞书开发者后台 创建应用。扫码授权链接打不开确保手机装了飞书 App且和浏览器登录的是同一个账号。授权过期了怎么办重新执行lark-cli auth login --no-wait --recommend --json获取新链接10 分钟内有效。AI 助手说「需要主人授权」是什么意思就是字面意思——token 过期了或需要补充新权限AI 会给你新链接扫一下就好通常 10 秒搞定。参考资料汇总资源链接lark-cli GitHub官方仓库https://github.com/larksuite/clilark-cli npm 安装页https://www.npmjs.com/package/larksuite/cli飞书开放平台https://open.feishu.cn/飞书开发者后台https://open.feishu.cn/app/sandboxOpenClaw (CoPaw) 官网https://copaw.agentscope.io/懒人配置教程原文https://www.feishu.cn/content/article/7623291503305083853本教程由小羊阳 编写基于 飞书开放平台 lark-cli v1.0.4