openclaw添加飞书channel

一、为 OpenClaw 安装飞书插件：步骤详解与常见问题解决

许多用户注意到，OpenClaw 默认并未集成飞书功能。为了实现飞书平台的对接，我们需要手动安装官方插件。整个过程并不复杂，只需在终端中执行一条核心指令即可完成基础安装：

openclaw plugins install @m1heng-clawd/feishu

不过，在实际操作中，部分用户可能会遇到一些典型的安装障碍。以下是两种常见问题的具体解决方案，帮助您顺利完成配置。

安装异常一：权限不足问题

执行命令后，若终端反馈包含“EACCES”错误码的提示，这通常是文件系统权限冲突的体现：

npm pack failed: npm error code EACCES
npm error syscall mkdir
...

该问题的根本原因在于，您系统内的 .npm 全局缓存目录中，可能存在一些归属 root 用户的遗留文件，导致当前普通用户（例如示例中的“shine”）缺少写入权限。这在此前某些 npm 版本中是一个已知的缺陷。

解决方案非常直接，只需通过一条授权命令，将目录的所有权移交给当前登录用户即可：

sudo chown -R $(whoami) ~/.npm

输入系统管理员密码完成授权后，请再次运行飞书插件的安装命令：

openclaw plugins install @m1heng-clawd/feishu

安装异常二：插件目录已存在

在某些情况下，由于网络中断或首次安装意外终止，系统中可能残留了不完整的插件目录。当您重新尝试安装时，可能会遇到如下提示：

plugin already exists: /Users/shine/.openclaw/extensions/feishu (delete it first)

该提示明确指出，目标插件目录已存在，需要手动清理残留文件。请按以下两步操作：

1. 彻底移除残留的插件目录：

rm -rf ~/.openclaw/extensions/feishu

2. 随后，重新执行初始的安装命令：

openclaw plugins install @m1heng-clawd/feishu

完成上述步骤后，您通常会在终端看到插件安装成功的确认信息。

二、新增飞书频道并进行连接配置

成功安装插件后，下一步是将飞书整合为一个可用的“频道”(Channel)接入 OpenClaw。请打开您的终端，输入以下命令以启动交互式配置向导：

openclaw channels add

该向导将引导您完成添加飞书频道的全部必要设置。

三、飞书频道配置向导全流程解析

跟随向导步骤配置相对直观。为帮助您清晰理解每一步的关键信息，以下是对配置过程中各个选项的详细说明：

1. 确认启用插件 配置初始，向导会询问是否启用刚安装的飞书插件，请毫不犹豫地选择 Yes 以继续。

2. 选定对接平台 接着，在系统展示的所有支持平台列表中，请准确找到并选中 Feishu（飞书） 选项。

3. 填写应用密钥 此步骤要求输入飞书机器人的 App Secret。这是实现身份安全认证的核心凭证，请务必提前从飞书开放平台的应用管理中获取并妥善保管。

4. 指定API接入地址 根据界面提示，准确输入您的飞书机器人所对应的 API 调用地址。

5. 选择应用版本 此处请特别注意：若您的飞书属于国内（中国内地）版本，必须选择 CN 选项，以确保连接到正确的区域服务器端点。

6. 配置访问控制策略 最后一步是设定机器人的交互策略 (Policy)。为了便于初步的功能验证与测试，建议选择 open（开放）策略，该策略将允许最广泛的请求交互，方便快速上手。

完成全部配置步骤后，飞书频道即成功添加至您的 OpenClaw 中。现在，您可以开始体验 OpenClaw 与飞书机器人的自动化协同，处理消息或执行预设任务了。