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

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

# 一、环境准备

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

**Windows 用户**到 GitHub Releases 下载 `nvm-setup.exe`：https://github.com/coreybutler/nvm-windows/releases

![1.png](https://developer.qcloudimg.com/http-save/yehe-9985785/e7ddc6340dea80cae9dc9fc98e3a515b.png)

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

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

![2.png](https://developer.qcloudimg.com/http-save/yehe-9985785/105b7e6af63601de2cc8a3d637a4900a.png)

##  2）安装 node.js 22.22.0 版本

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

```powershell
# 安装指令
nvm install 22

# 使用指令
nvm use 22.22.0
```

![3.png](https://developer.qcloudimg.com/http-save/yehe-9985785/1dedf21e9d0772afbfc21192bfb4f695.png)

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

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



# 二、安装 + 配置 OpenClaw

## 1）一键安装（PowerShell）

在 **管理员 PowerShell** 中运行：

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

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

```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

![4.png](https://developer.qcloudimg.com/http-save/yehe-9985785/4014676e9b55119eb1f637f7fb3656f4.png)

## 2）初始化配置

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

```powershell
openclaw onboard --flow quickstart
```

第一个风险提示：

> 
> I understand this is powerful and inherently risky. Continue?
> 

选择 **Yes**。

![5.png](https://developer.qcloudimg.com/http-save/yehe-9985785/1b82debc874c9a891416db35480808f7.png)

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

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

![7.png](https://developer.qcloudimg.com/http-save/yehe-9985785/f3eece893ea3b51bc6dc29360e4f69cc.png)

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

![8.png](https://developer.qcloudimg.com/http-save/yehe-9985785/5afb4b4efc5757b9d7071cc7cabc3751.png)

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

![9.png](https://developer.qcloudimg.com/http-save/yehe-9985785/ef8cadecebb02b3d8741f67fcb92786c.png)

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

![11.png](https://developer.qcloudimg.com/http-save/yehe-9985785/23bb38358e782e32b8c38314a82418c8.png)

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

![12.png](https://developer.qcloudimg.com/http-save/yehe-9985785/740beca91165ed6a77b8b24c1302d1df.png)

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

![13.png](https://developer.qcloudimg.com/http-save/yehe-9985785/ccee8763b4e1e976532509af55acd362.png)

![14.png](https://developer.qcloudimg.com/http-save/yehe-9985785/e352dbd91149fa28761532cc43039d6f.png)

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

![15.png](https://developer.qcloudimg.com/http-save/yehe-9985785/f79ff571e0ce7cc09e821e56d77f402e.png)

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

![16.png](https://developer.qcloudimg.com/http-save/yehe-9985785/b44503b8863a416cf72c656cda507217.png)



# 三、配置连接飞书

整体思路是两步：

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



## 1）安装飞书插件

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

```powershell
openclaw plugins install @m1heng-clawd/feishu
```

![17.png](https://developer.qcloudimg.com/http-save/yehe-9985785/ed29d9f373373956052fa37e9d80db74.png)

![18.png](https://developer.qcloudimg.com/http-save/yehe-9985785/7a12b23d61519dcb44f5727c04810c7c.png)

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



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

进入飞书开放平台：https://open.feishu.cn/，创建一个应用，并添加机器人应用能力。

![19.png](https://developer.qcloudimg.com/http-save/yehe-9985785/0eca4be8bcfafcac5a0c3670eda1d977.png)

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

![20.png](https://developer.qcloudimg.com/http-save/yehe-9985785/8a7334ca832e229baa3b049eddefffe7.png)

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

![20-1.png](https://developer.qcloudimg.com/http-save/yehe-9985785/d59b35b439fdd43ba79c7020d3f24509.png)



## 3）批量导入权限

进入 **权限管理** → 找到「批量导入导出权限」→ 权限配置 JSON → 粘贴导入：

```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](https://developer.qcloudimg.com/http-save/yehe-9985785/b217f35f7c06654471e5a5db65ed4fc4.png)



## 4）事件订阅

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

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

![22.png](https://developer.qcloudimg.com/http-save/yehe-9985785/9954f98cd38911fe7811f570515ce7ed.png)

> 如果提示“没有建立长连接”：
>
> - 先别慌，通常等 1～2 分钟再点保存就好
> - 如果等很久仍不行，优先检查 **OpenClaw 网关是否正常运行**，并查看日志（下面第四部分给了命令）



## 5）添加接收消息事件

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

- `im.message.receive_v1`

![23.png](https://developer.qcloudimg.com/http-save/yehe-9985785/661c5faf11819a94fa528450d8c09eca.png)

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



## 6）发布版本

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

- 创建版本
- 发布

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

![24.png](https://developer.qcloudimg.com/http-save/yehe-9985785/70c251c8a35905eb55273f2954bfb819.png)

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

![25.png](https://developer.qcloudimg.com/http-save/yehe-9985785/39644891d2b2c733f0c73d624a58904e.png)

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

![26.png](https://developer.qcloudimg.com/http-save/yehe-9985785/7c9ca522894180ff40ac1d94e32b2b0d.png)

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

![27.png](https://developer.qcloudimg.com/http-save/yehe-9985785/7edd59db2b1778428dfc1ce7f33219ce.png)


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

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

```powershell
# 启动网关
openclaw gateway start

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

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

# 诊断检查
openclaw doctor

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

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

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


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

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

先锋会员

开发工具

操作系统

客户端

Windows用户安装OpenClaw完整教程：从nvm、Node.js环境配置到飞书机器人接入全流程详解，包含常见问题解决方案和实用排错命令，助你快速搭建AI助手。

虚拟机

Windows

GitHub

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Windows 也能跑 OpenClaw！最完整安装教程 + 飞书接入，全程避坑-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐