wsl的装龙虾方式,接入飞书的时候需要在wsl环境装飞书插件,那么node模式接入飞书,需要怎么装飞书插件?

在 Node 模式下接入飞书,和 WSL 环境在安装插件这一步是完全一样的,都用 openclaw plugins install 这个命令。唯一的区别在于,配置完成后,你需要确保受信任的根证书列表是最新的(比如以管理员身份运行一次 node -e "require('https').globalAgent.options.ca = require('tls').rootCertificates"),以避免潜在的本地根证书过期导致的连接失败;而 WSL 环境通常不会出现这个问题。

🛠️ 第一步:在飞书开放平台创建应用并获取凭证

  1. 登录并创建 :访问飞书开放平台,用管理员账号登录后,创建一个"企业自建应用"。
  2. 获取凭证 :创建完成后,在"凭证与基础信息 "页面,你将看到 App ID 和 App Secret,记录下这两个信息。
  3. 添加机器人能力 :在应用的"应用能力 "页面,添加"机器人"能力。
  4. 配置权限 :在"权限管理 "页面,确保开启以下核心权限:
    • im:message (获取与发送单聊、群组消息)
    • im:message.group_at_msg:readonly (读取群聊 @ 机器人的消息)
    • im:message.p2p_msg:readonly (读取用户发给机器人的单聊消息)
    • im:message:send_as_bot (以应用身份发送消息)
    • im:resource (获取与上传图片或文件资源,按需开启)
  5. 发布应用 :在"版本管理与发布 "页面,创建一个新版本并发布。注意 :应用必须是"已发布"状态,飞书插件才能正常连接,否则插件启动会失败。
  6. 配置事件回调(关键步骤) :在插件的 App ID/Secret 配置完成并重启 Gateway 之后,你需要回到飞书开放平台的"事件与回调 "页面,订阅 im.message.receive_v1 事件,并选择"使用长连接接收事件"。

⚙️ 第二步:在 PowerShell 中安装飞书插件

  1. 安装插件 :在管理员 PowerShell 中运行下面命令,安装社区中最常用的插件。任选其一即可:

    powershell 复制代码
    # 官方推荐插件
    openclaw plugins install openclaw-feishu
    # 或社区流行插件
    openclaw plugins install @overlink/openclaw-feishu
    # 推荐:第三个脚本
    npx -y @larksuite/openclaw-lark@2026.4.7 install --version 2026.4.7 --tools-version 1.0.37
    
    备注:鼠标移到Windows PowerShell标题栏点击右键,点击属性,在弹出的窗口上方点击字体栏,选择最上面的第一个英文字体MS Gothic就行了。
  2. 编辑配置 :在管理员 PowerShell 中运行 notepad "$env:USERPROFILE\.openclaw\openclaw.json"。在配置文件中找到或创建 channels 和 plugins 字段,并填入以下配置:

    json 复制代码
    "channels": {
      "openclaw-feishu": {
        "enabled": true,
        "appId": "cli_你的AppID",
        "appSecret": "你的AppSecret"
      }
    },
    "plugins": {
      "entries": {
        "openclaw-feishu": {
          "enabled": true
        }
      }
    }

    注意 :将 cli_你的AppID 和 你的AppSecret 替换为你在第一步中获取的真实凭证。appId 格式类似 cli_xxxxxxxx,请务必确保填写正确。

    保存并关闭文件。

  3. 重启并验证 :在 PowerShell 中依次运行以下命令,重启 Gateway 使配置生效,并检查状态:

    powershell 复制代码
    openclaw gateway restart
    openclaw channels status openclaw-feishu

    如果状态显示为 ON 和 OK,则表明插件已成功运行。

💡 如何选择插件?

目前社区中有多个飞书插件可选,以下是对比:

插件名称 (npm 包名) 主要特点 推荐场景
openclaw-feishu 官方维护,功能全面,支持多账号 大多数用户的默认首选
@overlink/openclaw-feishu 支持飞书/Lark双版本,WebSocket/Webhook双模式,富媒体和文件处理强大 需要同时接入国内/国际版或对文件处理有高要求
feishu-openclaw 轻量级,安装简单 对配置要求不高的简单场景

如无特殊需求,可从 openclaw-feishu 开始使用。

💎 总结

  1. 核心步骤 :就是"安装插件→配置凭证→重启→配置事件"这四个步骤。
  2. 平台通用 :这里的 openclaw plugins install 命令在所有支持 Node.js 的平台上通用(Windows/macOS/Linux),你无需担心环境差异。
  3. 重启生效 :每次修改 openclaw.json 配置文件后,必须重启 Gateway 才能生效 (openclaw gateway restart)。
相关推荐
玩泥巴的1 小时前
MAF + 飞书:让大模型干活,但别让它乱干
ai·c#·.net·飞书·agent
对象存储与RustFS2 小时前
网盘限速逼你开会员?用 RustFS 自己搭一个不限速的“私人网盘
服务器·后端·docker
..Dauntless..4 小时前
【Linux】一切皆文件和缓冲区
linux·运维·服务器
裕晟资质规划4 小时前
三类资质变更报告时限差在哪?军工 15 日、集成印制 10 日
大数据·服务器·网络
QMCY_jason4 小时前
x86 ubuntu2204 无gui 安装 openeuler 2203 aarch64版本
linux·运维·服务器
ychqsq4 小时前
234.无题
经验分享·职场和发展
重生之小比特4 小时前
【Linux系统】12 进程程序替换 自定义Shell 命令行解释器
linux·运维·服务器
轻舟技术A4 小时前
Provider 不属于 Agent 核心:rpi 的分层理由与收益
服务器·网络
连山齐名4 小时前
ai应用开发的学习笔记
服务器·笔记·学习
Shadow(⊙o⊙)4 小时前
仿muduo实现高并发服务器——事件就绪管理Channel.hpp
服务器·c++