> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zerone.run/llms.txt
> Use this file to discover all available pages before exploring further.

# 飞书 CLI

> 安装并授权飞书 CLI，让 Agent 处理云文档和表格。

飞书 CLI 让 Agent 访问你授权的飞书文档、表格和知识库。它用于操作飞书资源；如果要在飞书聊天中向桌面 Agent 发消息，请查看[飞书接入](/zh/app/feishu)。

## 安装

先准备可用的 Node.js 和 npm。在终端执行官方安装命令：

```bash theme={null}
npx @larksuite/cli@latest install
```

也可以把 [飞书 CLI 官方仓库](https://github.com/larksuite/cli)发给 Zerone，或直接说「帮我安装 lark-cli」。安装时先核对请求的操作，再决定是否允许。

## 配置应用

在终端启动交互式配置：

```bash theme={null}
lark-cli config init
```

也可以让 Zerone 协助启动配置；需要登录和授权的步骤由你在浏览器中完成。根据引导创建或选择应用，按组织要求完成审批。

<img src="https://mintcdn.com/zerone/Sg-N27cdMGbTyTuO/images/app/lark-cli-2.png?fit=max&auto=format&n=Sg-N27cdMGbTyTuO&q=85&s=8c96680acef8417210592896ddc20aea" alt="飞书开放平台创建 CLI 应用" width="2878" height="1528" data-path="images/app/lark-cli-2.png" />

创建并发布后，可从应用入口继续配置：

<img src="https://mintcdn.com/zerone/Sg-N27cdMGbTyTuO/images/app/lark-cli-3.png?fit=max&auto=format&n=Sg-N27cdMGbTyTuO&q=85&s=42c697ae1a3f509750c11b6abd81fb13" alt="飞书应用审批通过后的打开入口" width="1646" height="1468" data-path="images/app/lark-cli-3.png" />

## 授权账号

运行登录引导，并打开本次命令生成的授权链接：

```bash theme={null}
lark-cli auth login --recommend
```

核对登录账号、申请的权限以及需要操作的数据范围，再决定是否授权。不要复用他人的二维码或授权链接，也不要将授权码放进聊天截图或公开文档。

## 确认连接

```bash theme={null}
lark-cli auth status
```

确认登录状态后，可以让 Zerone 在已授权范围内读取或处理飞书资源。先用只读任务验证，例如总结一份你有权访问的文档，再尝试写入操作。

本页命令参照 [飞书 CLI 官方安装和认证说明](https://github.com/larksuite/cli#installation--quick-start)。界面图来自原手册，仅作流程示意。

<Warning>
  授权后，工具可在获准范围内以你的身份操作。只授予当前任务所需权限，不要为了完成安装而跳过权限审核。
</Warning>
