Windows 也能跑 OpenClaw！最完整安装教程 + 飞书接入，全程避坑

别惹CC
22 阅读5分钟

⚠️ 小贴士：在开始之前，有一个非常重要的提醒：由于此类工具涉及自动化操作和环境配置，如果你的电脑存有重要的商业/资产或个人隐私信息，强烈建议弄一台干净的备用设备，或者直接租用一个云端虚拟机（VPS）来运行。 这样既能保护隐私，也能避免环境冲突。

最近 OpenClaw 热度很高，但官方对 Windows 原生环境并不算友好，很多人会卡在 Node 环境、权限、路径、插件安装等问题上。下面我把自己完整跑通的流程整理成一篇“照做就能成”的教程：从环境准备 → OpenClaw 安装 → 初始化配置 → 接入飞书机器人，最后再补一份常用排错命令。

一、环境准备

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

Windows 用户 到 GitHub Releases 下载 nvm-setup.exe：github.com/coreybutler…

1.png

安装过程一路 Next 即可。安装成功后建议你用 管理员权限打开 PowerShell：

  • 按 Win 键 + S
  • 搜索 PowerShell
  • 鼠标右键 → 以管理员身份运行

2.png

2）安装 node.js 22.22.0 版本

按照顺序分别在 powershell 中运行下列指令。

# 安装指令
nvm install 22

# 使用指令
nvm use 22.22.0

3.png

成功后会看到类似提示：Now using node v22.22.0

如果你仍然下载失败，或者公司网络拦截了下载，也可以手动去官网下载安装：nodejs.org/zh-cn/downl…

二、安装 + 配置 OpenClaw

1）一键安装（PowerShell）

在 管理员 PowerShell 中运行：

iwr -useb https://openclaw.ai/install.ps1 | iex

如果遇到执行策略报错（常见于首次运行脚本），在 PowerShell 输入：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

4.png

2）初始化配置

安装完成后通常会自动进入配置流程。 如果你不小心关闭了 PowerShell，重新打开后执行：

openclaw onboard --flow quickstart

第一个风险提示：

I understand this is powerful and inherently risky. Continue?

选择 Yes。

5.png

如果有小伙伴遇到这个问题：系统不知道它被安装在哪里了。处理方式通常很简单：

  • 关闭当前 PowerShell
  • 重新用管理员方式打开 PowerShell
  • 一般 nvm/环境变量会自动刷新路径，问题即可消失

7.png

之后按提示选择模型。我这里示例用的是 Kimi，你也可以按自己习惯选择。

8.png

可以看下配置，主要输入API key，其他都可以默认。

9.png

接着配置通讯工具，虽然官方这里直接可以选飞书，但官方文档明确建议 Windows 通过 WSL2 运行，并且提到原生 Windows 未测试、更容易出问题。并且我实测这里下载插件会报错，所以我们这里先跳过，后续再安装。

11.png

skill也先跳过，后续咱们在使用过程中根据自己的工作流慢慢迭代自己的skill。

12.png

安装启动网关后，它会自动新开一个 PowerShell 窗口，都不要关闭。

13.png

14.png

浏览器会自动打开控制台。后续你也可以直接访问：http://127.0.0.1:18789/

15.png

发消息测试，有回复就说明安装成功：

16.png

三、配置连接飞书

整体思路是两步：

  1. 在 OpenClaw 里安装飞书插件
  2. 在飞书开放平台创建应用 → 配权限/事件 → 发布版本 → 回到 OpenClaw 填 AppID/Secret

1）安装飞书插件

你可以在控制台里让它帮你执行安装命令：

openclaw plugins install @m1heng-clawd/feishu

17.png

18.png

插件安装可能要等一会儿，这段时间你可以去飞书开放平台把应用先建好。

2）飞书开放平台创建应用

进入飞书开放平台：open.feishu.cn/，创建一个应用，并添加…

19.png

然后把 App ID 和 App Secret 复制出来备用：

20.png

把这两项提供给 OpenClaw ，让它完成配置：

20-1.png

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"]
  }
}

导入完成后点击「确认新增权限」。

21.png

4）事件订阅

进入「事件与回调」页面：

  • 「事件配置」→「订阅方式」
  • 选择：使用长连接接收事件
  • 保存

22.png

如果提示“没有建立长连接”：

  • 先别慌，通常等 1～2 分钟再点保存就好
  • 如果等很久仍不行，优先检查 OpenClaw 网关是否正常运行，并查看日志（下面第四部分给了命令）

5）添加接收消息事件

在「事件配置」页面点击「添加事件」，搜索并添加：

  • im.message.receive_v1

23.png

不添加这个事件，机器人就无法收到你的消息。

6）发布版本

进入「版本管理与发布」：

  • 创建版本
  • 发布

只有发布后，前面的配置才会真正生效。

24.png

然后在飞书里找到你刚创建的机器人，发送一条消息，它会自动回复一个配对码

25.png

复制这个配对码，打开 Clawdbot 的 Web UI（就是前面那个控制台），把配对码发给它，Clawdbot 会自动完成绑定。

26.png

绑定成功后，你就可以在飞书里跟 Clawdbot 愉快交流了，也可以把机器人拉到公司群里，让所有小伙伴都能用。

27.png

四、常用命令（排查/修复必备）

下面这些命令非常实用：配置过程中遇到卡死、插件异常、网关没起等问题，优先用它们自查。

# 启动网关
openclaw gateway start

# 重启网关（刷新机器人状态）
openclaw gateway restart

# 重置/更改 API 等配置
openclaw config

# 诊断检查
openclaw doctor

# 实时查看日志（强烈推荐：出 bug 基本都靠它定位）
openclaw logs follow

好了，这就是整个安装和配置流程。

如果你觉得对你有帮助的话，可以帮我点个赞👍，也可以转发给其他你觉得需要的朋友们。

avatar
文章
阅读
粉丝