最近 OpenClaw 热度很高,但官方对 Windows 原生环境并不算友好,很多人会卡在 Node 环境、权限、路径、插件安装等问题上。下面我把完整跑通的流程整理成一篇"照做就能成"的教程。


一、环境准备

1)安装 nvm for Windows

Windows 用户到 GitHub Releases 下载 nvm-setup.exe:
https://github.com/coreybutler/nvm-windows/releases
image.png
安装过程一路 Next 即可。安装成功后建议你用管理员权限打开 PowerShell:

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

image.png

2)安装 node.js 22.22.0

在 PowerShell 中分别运行:

nvm install 22
nvm use 22.22.0

image.png

成功后会看到提示:Now using node v22.22.0


二、安装 OpenClaw

1)一键安装

在管理员 PowerShell 中运行:

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

如果遇到执行策略报错,输入:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

image.png

2)初始化配置

安装完成后执行:

openclaw onboard --flow quickstart

按提示选择模型,配置 API key。

image.png
image.png

接着配置通讯工具(飞书),skips 先跳过,后续再安装。

image.png

安装启动网关后,会自动新开 PowerShell 窗口,浏览器也会打开控制台。

987235d029d43b89f381eb928b6abc5b.png

访问 http://127.0.0.1:18789/ 发消息测试。


三、配置飞书

整体思路是两步:

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

1)安装飞书插件

openclaw plugins install @m1heng-clawd/feishu

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

进入 https://open.feishu.cn/ 创建应用,添加机器人能力。
image.png

复制 App ID 和 App Secret 填入 OpenClaw。
image.png
把这两项提供给 OpenClaw ,让它完成配置:
image.png

3)批量导入权限

进入权限管理 → 批量导入导出权限 → 粘贴:
image.png

{
  "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)事件订阅

进入事件与回调 → 事件配置 → 订阅方式选择「使用长连接接收事件」→ 保存。
image.png
**如果提示“没有建立长连接”:
先别慌,通常等 1~2 分钟再点保存就好
如果等很久仍不行,优先检查 OpenClaw 网关是否正常运行,并查看日志(下面第四部分给了命令)**

5)添加接收消息事件

添加事件:im.message.receive_v1
image.png
不添加这个事件,机器人就无法收到你的消息。

6)发布版本

进入版本管理与发布 → 创建版本 → 发布。
image.png

然后在飞书里找到你刚创建的机器人,发送一条消息,它会自动回复一个配对码
image.png
复制这个配对码,打开 Clawdbot 的 Web UI(就是前面那个控制台),把配对码发给它,Clawdbot 会自动完成绑定。
image.png

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

image.png

四、常用命令

# 启动网关
openclaw gateway start

# 重启网关
openclaw gateway restart

# 重置配置
openclaw config

# 诊断检查
openclaw doctor

# 查看日志
openclaw logs follow

关于在什么地方部署,我依旧推荐在云服务器,常用电脑部署有安全隐患,windows也不适合养小龙虾,又不能24H在线

我使用的是腾讯云轻量应用服务器第一年199元,2核4G,服务器位于新加坡,有几个明显的优势。
1、下单时选中OpenClaw,就可以初始化时自动安装好,并且自动装好几个基础技能比如:ClawHub。
2、可以选择海外服务器,没有网络限制,方便后续更好的使用。
3、确实各大厂商最近对OpenClaw都推出了优惠活动,但是支持海外服务器的我真没找到几个。
4、配置模型,飞书,安装技能都可以在腾讯云后台可视化操作如图:腾讯云后台
5、升级也可以在腾讯云后台一键升级,重要数据也不会丢失。
6、社区的实践教程很丰富,我跟着学了几个实用的功能:学习地址

腾讯云下单地址