⚠️ 小贴士在开始之前有一个非常重要的提醒由于此类工具涉及自动化操作和环境配置如果你的电脑存有重要的商业/资产或个人隐私信息强烈建议弄一台干净的备用设备或者直接租用一个云端虚拟机VPS来运行。这样既能保护隐私也能避免环境冲突。最近OpenClaw热度很高但官方对Windows 原生环境并不算友好很多人会卡在 Node 环境、权限、路径、插件安装等问题上。下面我把自己完整跑通的流程整理成一篇“照做就能成”的教程从环境准备 → OpenClaw 安装 → 初始化配置 →接入飞书机器人最后再补一份常用排错命令。一、环境准备1安装 nvm for Windows建议用最新版Windows 用户到 GitHub Releases 下载nvm-setup.exehttps://github.com/coreybutler/nvm-windows/releases安装过程一路 Next 即可。安装成功后建议你用管理员权限打开 PowerShell按Win 键 S搜索PowerShell鼠标右键 →以管理员身份运行2安装 node.js 22.22.0 版本按照顺序分别在powershell中运行下列指令。# 安装指令nvm install 22# 使用指令nvm use 22.22.0成功后会看到类似提示Now using node v22.22.0如果你仍然下载失败或者公司网络拦截了下载也可以手动去官网下载安装https://nodejs.org/zh-cn/download二、安装 配置 OpenClaw1一键安装PowerShell在管理员 PowerShell中运行iwr-useb https://openclaw.ai/install.ps1|iex如果遇到执行策略报错常见于首次运行脚本在 PowerShell 输入Set-ExecutionPolicy-ExecutionPolicy RemoteSigned-Scope CurrentUser2初始化配置安装完成后通常会自动进入配置流程。如果你不小心关闭了 PowerShell重新打开后执行openclaw onboard--flow quickstart第一个风险提示I understand this is powerful and inherently risky. Continue?选择Yes。如果有小伙伴遇到这个问题系统不知道它被安装在哪里了。处理方式通常很简单关闭当前 PowerShell重新用管理员方式打开 PowerShell一般nvm/环境变量会自动刷新路径问题即可消失之后按提示选择模型。我这里示例用的是Kimi你也可以按自己习惯选择。可以看下配置主要输入API key其他都可以默认。接着配置通讯工具虽然官方这里直接可以选飞书但官方文档明确建议Windows 通过 WSL2 运行并且提到原生 Windows 未测试、更容易出问题。并且我实测这里下载插件会报错所以我们这里先跳过后续再安装。skill也先跳过后续咱们在使用过程中根据自己的工作流慢慢迭代自己的skill。安装启动网关后它会自动新开一个 PowerShell 窗口都不要关闭。浏览器会自动打开控制台。后续你也可以直接访问http://127.0.0.1:18789/发消息测试有回复就说明安装成功三、配置连接飞书整体思路是两步在 OpenClaw 里安装飞书插件在飞书开放平台创建应用 → 配权限/事件 → 发布版本 → 回到 OpenClaw 填 AppID/Secret1安装飞书插件你可以在控制台里让它帮你执行安装命令openclaw plugins install m1heng-clawd/feishu插件安装可能要等一会儿这段时间你可以去飞书开放平台把应用先建好。2飞书开放平台创建应用进入飞书开放平台https://open.feishu.cn/创建一个应用并添加机器人应用能力。然后把App ID和App Secret复制出来备用把这两项提供给 OpenClaw 让它完成配置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事件订阅进入「事件与回调」页面「事件配置」→「订阅方式」选择使用长连接接收事件保存如果提示“没有建立长连接”先别慌通常等 12 分钟再点保存就好如果等很久仍不行优先检查OpenClaw 网关是否正常运行并查看日志下面第四部分给了命令5添加接收消息事件在「事件配置」页面点击「添加事件」搜索并添加im.message.receive_v1不添加这个事件机器人就无法收到你的消息。6发布版本进入「版本管理与发布」创建版本发布只有发布后前面的配置才会真正生效。然后在飞书里找到你刚创建的机器人发送一条消息它会自动回复一个配对码复制这个配对码打开 Clawdbot 的 Web UI就是前面那个控制台把配对码发给它Clawdbot 会自动完成绑定。绑定成功后你就可以在飞书里跟 Clawdbot 愉快交流了也可以把机器人拉到公司群里让所有小伙伴都能用。四、常用命令排查/修复必备下面这些命令非常实用配置过程中遇到卡死、插件异常、网关没起等问题优先用它们自查。# 启动网关openclaw gatewaystart# 重启网关刷新机器人状态openclaw gateway restart# 重置/更改 API 等配置openclaw config# 诊断检查openclaw doctor# 实时查看日志强烈推荐出 bug 基本都靠它定位openclaw logs follow好了这就是整个安装和配置流程。如果你觉得对你有帮助的话可以帮我点个赞也可以转发给其他你觉得需要的朋友们。