Clawdbot/Openclaw一键本地部署+对接飞书

本文介绍了OpenClaw/Clawdbot本地部署及飞书接入的完整流程。主要内容包括：1）安装Node.js、Git等基础环境；2）通过npm安装OpenClaw并进行初始配置；3）详细说明两种飞书插件安装方法（手动安装和自动安装），包括配置参数说明；4）提供飞书机器人对接的完整步骤，包括应用ID/Secret配置、事件订阅设置等；5）附带钉钉对接文档参考。文中包含多个命令行操作指引和配置截图，

大梦谁先觉i

1995人浏览 · 2026-03-05 14:13:24

大梦谁先觉i · 2026-03-05 14:13:24 发布

一、本地部署

官网：https://openclaw.ai/
github仓库：https://github.com/openclaw/openclaw

安装node.js

1、Node.js 官方下载地址

官方地址：https://nodejs.org/zh-cn

✅ 推荐下载 LTS 长期支持版（页面上显眼的那个版本，比如当前的 20.x 系列），稳定性强，适合开发 / 生产环境，页面会自动识别你的系统（Windows/Mac/Linux），直接点下载按钮就行。

💡 补充：Node.js 安装包自带 npm（包管理器），不用单独下载。
暂时无法在飞书文档外展示此内容

2、Git 官方下载地址

官方地址：https://git-scm.com/

✅ 同样会自动识别系统，Windows 点「Download for Windows」，Mac/Linux 对应右侧的下载入口；
Windows 建议选 64 位版本，安装时默认选项基本够用，新手不用改。

3、安装后快速验证（必做，确认是否装成功）

安装完成后，打开命令行 （Windows 用 CMD/PowerShell，Mac/Linux 用终端），分别输入以下命令，能显示版本号就是安装成功：
验证 Node.js 和 npm：

node -v
npm -v

验证 Git

git --version

安装 Git 时，建议勾选「Add Git to PATH」（默认会勾），否则命令行识别不到 git 命令

安装 Clawdbot

npm i -g openclaw

配置 Clawdbot

openclaw onboard

在这里插入图片描述

接入飞书

注意：先安装插件 → 配置 App ID/Secret → 重启 Gateway → 再去飞书开放平台配置长连接
在这里插入图片描述

方法1：:安装飞书插件

https://github.com/m1heng/clawdbot-feishu?tab=readme-ov-file
安装

openclaw plugins install @m1heng-clawd/feishu

升级

openclaw plugins update feishu

配置飞书API

openclaw config

配置选项

channels:
  feishu:
    enabled: true
    appId: "cli_xxxxx"
    appSecret: "secret"
    # 域名: "feishu" (国内) 或 "lark" (国际)
    domain: "feishu"
    # 连接模式: "websocket" (推荐) 或 "webhook"
    connectionMode: "websocket"
    # 私聊策略: "pairing" | "open" | "allowlist"
    dmPolicy: "pairing"
    # 群聊策略: "open" | "allowlist" | "disabled"
    groupPolicy: "allowlist"
    # 群聊是否需要 @机器人
    requireMention: true
    # 媒体文件最大大小 (MB, 默认 30)
    mediaMaxMb: 30
    # 回复渲染模式: "auto" | "raw" | "card"
    renderMode: "auto"

启动服务

openclaw gateway

如果 openclaw plugins install 失败，可以手动安装：

## 1. 下载插件包
curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-0.1.3.tgz

## 2. 从本地安装
openclaw plugins install ./feishu-0.1.3.tgz

把文件复制到用户目录下

C:\Users\你的用户名

[图片]

从本地安装
注意文件名“clawdbot-feishu-0.1.13.tar.gz”，要和你的文件一致

openclaw plugins install ./clawdbot-feishu-0.1.13.tar.gz

安装依赖
进入C:\Users\用户名.openclaw\extensions\feishu安装

npm install

重启

openclaw gateway restart

[图片]

如果上面安装失败，可以试一下新插件地址：https://github.com/AlexAnys/openclaw-feishu
完整支持 OpenClaw / Clawdbot

方法2：一键安装 / One-Click Install

OpenClaw
复制以下内容发给你的 OpenClaw：

帮我安装飞书插件: https://github.com/AlexAnys/openclaw-feishu
我的飞书应用配置信息如下
App ID：xxx
App Secret：xxx

OpenClaw 会自动安装、配置、重启，然后需要 App ID和 Secrect，在下方创建机器人后拿到发给它，然后配置事件订阅发布机器人应用更新，就可以测试啦。

Clawdbot
复制以下内容发给你的 Clawdbot：

帮我安装飞书插件: https://github.com/AlexAnys/openclaw-feishu
我的飞书应用配置信息如下
App ID：xxx
App Secret：xxx

🔧 手动配置 / Manual Config
如果没用一键安装，手动配置：
OpenClaw

openclaw plugins install feishu-openclaw
openclaw config set channels.feishu.enabled true --json
openclaw config set channels.feishu.appId "cli_你的AppID"
openclaw config set channels.feishu.appSecret "你的AppSecret"
openclaw gateway restart

Clawdbot

clawdbot plugins install feishu-openclaw
clawdbot config set channels.feishu.enabled true --json
clawdbot config set channels.feishu.appId "cli_你的AppID"
clawdbot config set channels.feishu.appSecret "你的AppSecret"
clawdbot gateway restart