OpenClaw 部署指南

来源：飞书文档 - 姚安（AI领域工具应用及创作专家）
整理日期：2026-02-27

前言

大家好，我是姚安。一位深耕AI领域工具应用及创作的90后小伙子，擅长各种AI工具创作变现、AI提示词优化、AI工作流搭建，跑通变现闭环。

下面的内容都是我不断研究AI领域的一些经验及方法论，希望能对你有所帮助，也希望通过免费分享链接到更多同频的人，一起进步！

资源	链接
官网	https://openclaw.ai/
GitHub仓库	https://github.com/openclaw/openclaw
云端部署（火山引擎）	https://mxnzp.com/sl/s866
国产平替版（OpenClaw国内懒人包）	支持飞书/钉钉/QQ一键安装，免费无限Token使用

一、本地部署

前置环境安装

1. 安装 Node.js

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

推荐下载 LTS 长期支持版（如当前的 20.x 系列），稳定性强，适合开发/生产环境
页面会自动识别你的系统（Windows/Mac/Linux），直接点下载按钮即可
Node.js 安装包自带 npm（包管理器），不用单独下载

备用下载（夸克网盘）：

文件名：node-v24.13.0-x64.msi
链接：https://pan.quark.cn/s/9bac944201b9

2. 安装 Git

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

同样会自动识别系统，Windows 点「Download for Windows」，Mac/Linux 对应右侧下载入口
Windows 建议选 64 位版本
安装时默认选项基本够用，新手不用改
注意：安装时建议勾选「Add Git to PATH」（默认会勾），否则命令行识别不到 git 命令

备用下载（夸克网盘）：

文件名：Git-2.52.0-64-bit.exe
链接：https://pan.quark.cn/s/fe604be51538

3. 安装验证（必做）

安装完成后，打开命令行（Windows 用 CMD/PowerShell，Mac/Linux 用终端），分别输入以下命令验证：

# 验证 Node.js 和 npm
node -v
npm -v

# 验证 Git
git --version

能显示版本号即为安装成功。

安装 OpenClaw

# 全局安装 openclaw
npm i -g openclaw

# 配置 Clawdbot
openclaw onboard

二、接入飞书

注意流程顺序：先安装插件 → 配置 App ID/Secret → 重启 Gateway → 再去飞书开放平台配置长连接

1. 飞书开发平台

访问：https://open.feishu.cn/app?lang=zh-CN

创建应用并获取以下信息：

App ID
App Secret

2. 安装飞书插件

方法1：通过 npm 安装（推荐）

# 安装
openclaw plugins install @m1heng-clawd/feishu

# 升级
openclaw plugins update feishu

方法2：手动安装（如果 npm 安装失败）

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

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

方法3：使用夸克网盘下载安装

文件名：clawdbot-feishu-0.1.8.tar.gz
链接：https://pan.quark.cn/s/fa440a409943

下载后复制到用户目录下 C:\Users\你的用户名，然后执行：

# 从本地安装（注意文件名要与你的文件一致）
openclaw plugins install ./clawdbot-feishu-0.1.8.tar.gz

# 进入插件目录安装依赖
cd C:\Users\用户名\.openclaw\extensions\feishu
npm install

# 重启服务
openclaw gateway restart

3. 配置飞书 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"

4. 启动服务

openclaw gateway

三、飞书权限配置

在飞书开放平台中，需要申请以下权限范围（scopes）：

核心权限

{
  "scopes": {
    "tenant": [
      "im:chat:readonly",
      "im:chat",
      "im:message",
      "im:message:readonly",
      "im:message:send",
      "im:message.group_msg",
      "im:message.p2p_msg",
      "im:resource",
      "application:application",
      "application:application.bot.menu:readonly",
      "application:application.bot.menu:write",
      "contact:contact",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user.id:readonly",
      "contact:department.base:readonly",
      "contact:group",
      "contact:group:readonly"
    ]
  }
}

完整权限列表

点击查看完整权限列表（展开）

{
  "scopes": {
    "tenant": [
      "acs:access_record:readonly",
      "acs:access_record:write",
      "acs:device:write",
      "acs:devices:readonly",
      "acs:users",
      "admin:admin_dept_stat:readonly",
      "admin:admin_user_stat:readonly",
      "admin:app.admin:check",
      "admin:app.admin:readonly",
      "admin:app.admin_id:readonly",
      "admin:app.category:update",
      "admin:app.enable:write",
      "admin:app.info:readonly",
      "admin:app.user_usable:readonly",
      "admin:app.visibility",
      "admin:badge",
      "admin:badge.grant",
      "admin:ent_email_password",
      "aily:data_asset:read",
      "aily:data_asset:upload_file",
      "aily:data_asset:write",
      "aily:file:read",
      "aily:file:write",
      "aily:knowledge:ask",
      "aily:knowledge:read",
      "aily:knowledge:write",
      "aily:message:read",
      "aily:message:write",
      "aily:run:read",
      "aily:run:write",
      "aily:session:read",
      "aily:session:write",
      "aily:skill:read",
      "aily:skill:write",
      "app_engine:application.environment_variable:read",
      "app_engine:application.event:read",
      "app_engine:application.function:write",
      "app_engine:application.log:read",
      "app_engine:application.metric:read",
      "app_engine:approval:read",
      "app_engine:approval:write",
      "app_engine:attachment:read",
      "app_engine:attachment:write",
      "app_engine:data.record.change:read",
      "app_engine:dataset.meta:read",
      "app_engine:dataset.record:read",
      "app_engine:flow:write",
      "app_engine:global_option:read",
      "app_engine:object.meta:read",
      "app_engine:object.record:read",
      "app_engine:object.record:write",
      "app_engine:record_permission.member:write",
      "app_engine:role.member:write",
      "app_engine:role:read",
      "application:application",
      "application:application.app_message_stats.overview:readonly",
      "application:application.app_package",
      "application:application.app_usage_stats.overview:readonly",
      "application:application.app_version",
      "application:application.app_version:readonly",
      "application:application.bot.operator_name:readonly",
      "application:application.collaborators:write",
      "application:application.contacts_range:write",
      "application:application.feedback.feedback_info",
      "application:application.self_manage",
      "application:bot.menu:readonly",
      "application:bot.menu:write",
      "approval:approval",
      "approval:approval.list:readonly",
      "approval:approval:readonly",
      "approval:definition",
      "approval:external_approval",
      "approval:external_instance",
      "approval:instance",
      "approval:instance.comment",
      "approval:task",
      "attendance:overtime_approval:write",
      "attendance:rule",
      "attendance:rule:readonly",
      "attendance:task",
      "attendance:task:readonly",
      "attendance_machine:check_in_record:write",
      "attendance_machine:device:write",
      "attendance_machine:users",
      "baike:entity",
      "baike:entity:exempt_delete",
      "baike:entity:exempt_review",
      "baike:entity:readonly",
      "base:app:copy",
      "base:app:create",
      "base:app:read",
      "base:app:update",
      "base:collaborator:create",
      "base:collaborator:delete",
      "base:collaborator:read",
      "base:dashboard:copy",
      "base:dashboard:read",
      "base:field:create",
      "base:field:delete",
      "base:field:read",
      "base:field:update",
      "base:form:read",
      "base:form:update",
      "base:record:create",
      "base:record:delete",
      "base:record:read",
      "base:record:retrieve",
      "base:record:update",
      "base:role:create",
      "base:role:delete",
      "base:role:read",
      "base:role:update",
      "base:table:create",
      "base:table:delete",
      "base:table:read",
      "base:table:update",
      "base:view:read",
      "base:view:write_only",
      "bitable:app",
      "bitable:app:readonly",
      "block:entity",
      "block:message",
      "board:whiteboard:node:create",
      "board:whiteboard:node:delete",
      "board:whiteboard:node:read",
      "board:whiteboard:node:update",
      "calendar:calendar",
      "calendar:calendar.acl:create",
      "calendar:calendar.acl:delete",
      "calendar:calendar.acl:read",
      "calendar:calendar.event:create",
      "calendar:calendar.event:delete",
      "calendar:calendar.event:read",
      "calendar:calendar.event:reply",
      "calendar:calendar.event:update",
      "calendar:calendar.free_busy:read",
      "calendar:calendar:create",
      "calendar:calendar:delete",
      "calendar:calendar:read",
      "calendar:calendar:readonly",
      "calendar:calendar:subscribe",
      "calendar:calendar:update",
      "calendar:exchange.bindings:create",
      "calendar:exchange.bindings:delete",
      "calendar:exchange.bindings:read",
      "calendar:room",
      "calendar:room:readonly",
      "calendar:settings.caldav:create",
      "calendar:settings.workhour:read",
      "calendar:time_off:create",
      "calendar:time_off:delete",
      "calendar:timeoff",
      "cardkit:card:read",
      "cardkit:card:write",
      "cardkit:template:read",
      "collab_plugins:collab_plugins",
      "collab_plugins:collab_plugins.relation.change:read",
      "contact:contact",
      "contact:contact.base:readonly",
      "contact:contact:update_department_id",
      "contact:contact:update_user_id",
      "contact:department.base:readonly",
      "contact:department.hrbp:readonly",
      "contact:department.organize:readonly",
      "contact:functional_role",
      "contact:functional_role:readonly",
      "contact:group",
      "contact:group:readonly",
      "contact:job_family",
      "contact:job_family:readonly",
      "contact:job_level",
      "contact:job_level:readonly",
      "contact:job_title:readonly",
      "contact:role:readonly",
      "contact:unit",
      "contact:unit:readonly",
      "contact:user.assign_info:read",
      "contact:user.base:readonly",
      "contact:user.department:readonly",
      "contact:user.dotted_line_leader_info.read",
      "contact:user.email:readonly",
      "contact:user.employee:readonly",
      "contact:user.employee_id:readonly",
      "contact:user.employee_number:read",
      "contact:user.gender:readonly",
      "contact:user.id:readonly",
      "contact:user.job_family:readonly",
      "contact:user.job_level:readonly",
      "contact:user.phone:readonly",
      "contact:user.subscription_ids:write",
      "contact:user.user_geo",
      "contact:work_city:readonly"
    ]
  }
}

四、常见问题

安装问题

npm 安装失败：尝试使用手动安装方法，从夸克网盘下载插件包
Git 命令无法识别：检查安装时是否勾选「Add Git to PATH」
Node.js 版本问题：建议使用 LTS 长期支持版

飞书接入问题

权限不足：检查飞书开放平台中是否申请了所需的全部权限
连接失败：确认 appId 和 appSecret 配置正确
消息无法接收：检查 connectionMode 配置，推荐使用 websocket

五、相关链接汇总

名称	链接
OpenClaw 官网	https://openclaw.ai/
GitHub 仓库	https://github.com/openclaw/openclaw
飞书插件仓库	https://github.com/m1heng/clawdbot-feishu
飞书开放平台	https://open.feishu.cn/app?lang=zh-CN
Node.js 官网	https://nodejs.org/zh-cn
Git 官网	https://git-scm.com/
云端部署（火山引擎）	https://mxnzp.com/sl/s866

作者：姚安
简介：深耕AI领域工具应用及创作的90后，擅长AI工具创作变现、AI提示词优化、AI工作流搭建

OpenClaw 部署指南

OpenClaw 部署指南

前言

相关资源链接

学习资料

一、本地部署

前置环境安装

1. 安装 Node.js

2. 安装 Git

3. 安装验证（必做）

安装 OpenClaw

二、接入飞书

1. 飞书开发平台

2. 安装飞书插件

3. 配置飞书 API

4. 启动服务

三、飞书权限配置

核心权限

完整权限列表

四、常见问题

安装问题

飞书接入问题

五、相关链接汇总