Openclaw部署+飞书接入（windows环境）

环境准备

1 安装 nvm for Windows（建议用最新版）

对于Windows用户来说，有个好消息：环境管理其实并不复杂。第一步，我们需要借助一个神器——nvm（Node Version Manager）。直接前往 GitHub Releases 页面，下载那个 nvm-setup.exe 安装包就行：https://github.com/coreybutler/nvm-windows/releases。

安装过程没什么需要特别注意的，一路点击“Next”即可完成。安装成功后，有个小建议：最好以管理员身份打开 PowerShell，后续操作会更顺畅。

2 安装node.js

接下来，按照顺序在 PowerShell 中运行下面这两条指令。这相当于告诉系统：“我需要 Node.js 版本 22，并且现在就启用它。”

# 安装指令
nvm install 22
# 使用指令
nvm use 22.22.0

前期准备

安装核心依赖：

• Node.js：确保版本在 v22 及以上，可以从官网下载（https://nodejs.org/zh-cn/download/current/）。安装时，切记勾选“Add to PATH”选项，让系统自动配置好环境变量。
• Git：下载 Windows 版本并进行安装（地址：https://git-scm.com/download/win）。

环境验证与权限配置：

东西装好了，得先验验货，再开个必要的权限。打开你的 PowerShell（记得用管理员身份），依次敲入以下命令：

# 以管理员身份运行PowerShell
# 检查Node.js安装情况
node --version
# 解锁脚本执行权限（避免安装时权限报错）
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 出现提示后输入Y并回车确认

步骤1：安装OpenClaw

核心依赖搞定，现在可以请出主角了。执行下面的安装命令，很快就能完成。

npm install -g openclaw@latest --registry=https://registry.npmmirror.com
# 验证安装结果
openclaw --version

步骤2：初始化配置

安装完毕，接下来是初始化。运行以下命令，会启动一个交互式的配置向导：

openclaw onboard --flow quickstart

过程中遇到的第一个风险提示，放心地选择“YES”就好。

之后，向导会一步步引导你选择模型、配置 API Key 等信息。至于通讯工具和 Skills（技能）部分，完全可以选择先跳过。这些东西可以在后续实际使用中，根据具体需要随时添加，这种迭代式的配置反而更灵活。

配置到最后，它会自动安装并启动一个网关服务。注意，这会新开一个 PowerShell 窗口，两个窗口都不要关闭。

此时，浏览器通常会默认打开控制台界面。如果没自动打开，你也可以直接手动访问这个地址：http://127.0.0.1:18789/。

在控制台里发条消息测试一下，如果能收到回复，恭喜你，核心部分已经安装成功了！

步骤3：连接飞书

1 OpenClaw安装飞书插件

想让你的 AI 助理接入飞书，第一步是安装对应的插件。方法很简单，直接在刚才的 OpenClaw 控制台里发消息指令就行：

openclaw plugins install @m1heng-clawd/feishu

2 飞书开放平台创建应用

接下来，我们去飞书开放平台（https://open.feishu.cn/）创建一个新应用，并为其添加“机器人”能力。

创建成功后，在应用凭证页面，把生成的 App ID 和 App Secret 复制出来备用。这两串字符就是连接飞书和 OpenClaw 的关键钥匙。

回到 OpenClaw 控制台，将刚才复制的 App ID 和 App Secret 提供给它，系统会自动完成基础的配置关联。

3 导入权限

光有应用还不够，我们需要给这个机器人授权，告诉飞书它能做什么。在飞书开放平台的应用管理页面，找到“权限管理”。

点击“开通权限”，然后将下面这一大段权限配置 JSON 直接粘贴进去：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

粘贴完成后，别忘了点击“确认新增权限”。

4 事件订阅

要让机器人能实时响应消息，必须配置事件订阅。进入飞书后台的「事件与回调」页面。

在「事件配置」→「订阅方式」里，有一个关键选择：务必选择“使用长连接接收事件”，然后保存设置。

5 添加接受消息事件

还是在「事件配置」页面，点击「添加事件」。在搜索框里输入并添加下面这个事件：

im.message.receive_v1

这一步至关重要，如果漏了，机器人就收不到任何消息。

6 发布版本

所有配置都调整好了，现在需要发布生效。进入「版本管理与发布」页面，创建一个新版本，然后点击发布。

发布后，在你的飞书里找到刚刚创建的机器人应用，给它发送任意一条消息。这时，机器人会自动回复一个“配对码”。

最后一步，将这个配对码发送给 OpenClaw 控制台，完成最终的绑定配置。

大功告成！现在，你已经可以直接在飞书里和你的 AI 助理对话了。

步骤4 常用命令

日常使用和维护时，记住下面这几个命令会方便很多。它们能帮你启动、调试和管理你的 AI 助理：

# 启动网关
openclaw gateway start
# 重启网关（刷新机器人状态）
openclaw gateway restart
# 重置/更改 API 等配置
openclaw config
# 诊断检查
openclaw doctor
# 实时查看日志（强烈推荐：出 bug 基本都靠它定位）
openclaw logs follow

至此，从环境搭建到飞书接入，整个安装流程就全部完成了。

来源：互联网