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

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

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

  1. 登录并创建 :访问飞书开放平台,用管理员账号登录后,创建一个"企业自建应用"。
  2. 获取凭证 :创建完成后,在"凭证与基础信息 "页面,你将看到 App IDApp 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"。在配置文件中找到或创建 channelsplugins 字段,并填入以下配置:

    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

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

💡 如何选择插件?

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

插件名称 (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)。
相关推荐
SL-staff11 小时前
2026 企业项目管理工具选型:JIRA、飞书、JVS企业计划功能对比
项目管理·飞书·团队开发·jira·okr·jvs企业计划·决策流程
海的预约11 小时前
Bootloader应用分析
linux·运维·服务器
biolite6806455811 小时前
流式多色Panel新选择 | PE-Cy5预活化染料,让抗体标记一步到位!
经验分享
时空未宇11 小时前
海鸥派顺利运行YOLO11S
linux·运维·服务器
j_xxx404_11 小时前
Linux:深入解析ELF文件结构
linux·运维·服务器
weixin_5372170611 小时前
商业计划资源合集
经验分享
ShineWinsu11 小时前
对于Linux:进程间通信IPC(共享内存)的解析
linux·服务器·面试·笔试·进程·共享内存·ipc
代码中介商11 小时前
Linux 进程间通信:共享内存与消息队列完全指南
linux·运维·服务器
minji...11 小时前
Linux 网络套接字编程(六)TCP的通信是全双工的,自定义协议的定制,序列化和反序列化
linux·运维·服务器·网络·c++