在 Windows 环境下安装 OpenClaw AI Agent 框架并接入飞书机器人的完整流程。内容包括环境准备（Node.js 22+）、OpenClaw 安装与初始化、大模型 API 配置（以阿里云百炼为例）、飞书企业自建应用创建及权限设置、事件订阅配置以及配对操作。文中还提供了常用排错命令和常见问题解决方案，帮助用户实现自动化办公协作。
OpenClaw 作为一个强大的开源 AI Agent 框架，与飞书结合可以大幅提升办公效率。本文将手把手教你如何在 Windows 系统上完成 OpenClaw 的安装，并成功接入飞书机器人。全文均为实测可用的步骤，附带排错命令，帮你避开常见坑点。
在开始之前，有一个非常重要的提醒：由于 OpenClaw 这类自动化工具会深度接触你的系统和数据，如果你的电脑存有重要的商业资料或个人隐私信息，强烈建议使用一台干净的备用电脑，或者在阿里云、腾讯云等平台租用一个云端虚拟机（VPS）来运行。这样既能保护隐私，也能避免环境冲突。
使用 nvm 可以方便地管理 Node.js 版本，避免版本冲突。
nvm-setup.exe 安装包OpenClaw 要求 Node.js 22 或更高版本。以管理员身份打开 PowerShell（按 Win 键搜索 PowerShell → 右键 → 以管理员身份运行），然后执行以下命令：
# 安装 Node.js 22.x
nvm install 22
# 使用安装好的版本
nvm use 22.22.0
看到提示 Now using node v22.22.0 即表示成功。如果下载失败，也可以手动去 Node.js 官网 下载安装。
验证安装：
node --version
npm --version
在管理员 PowerShell 中执行以下命令：
# 如果遇到执行策略报错，先解除限制
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 一键安装 OpenClaw
iwr -useb https://openclaw.ai/install.ps1 | iex
如果网络不稳定，可以使用国内镜像：
iwr -useb https://clawd.org.cn/install.ps1 | iex
安装过程会自动下载并配置 Node.js 和 OpenClaw 核心文件，通常需要等待 5-10 分钟。
安装完成后会自动进入配置流程。如果意外关闭，可以重新执行：
openclaw onboard --flow quickstart
交互配置步骤（按提示操作）：
I understand this is powerful and inherently risky. Continue? → 输入 YesQuickStart（直接回车）Skip for now 跳过，后续再配置Skip for now 跳过（飞书稍后单独配置）No 跳过，后续可根据需要安装⚠️ 常见问题：如果执行 openclaw 命令提示"无法识别"，只需关闭当前 PowerShell，重新用管理员权限打开一个新窗口即可。这是因为环境变量还未刷新。
# 启动网关服务
openclaw gateway start
# 访问 Web 控制台（会自动打开浏览器）
openclaw dashboard
浏览器会自动打开控制台地址：http://127.0.0.1:18789/。发一条消息测试，有回复就说明安装成功。
OpenClaw 的自然语言理解能力依赖大模型，需要先配置 API 密钥。这里以阿里云百炼为例：
在 OpenClaw 中配置：
# 配置百炼 API-Key（替换为你的实际密钥）
openclaw config set models.providers.bailian.apiKey "你的百炼 API-Key"
# 设置默认模型
openclaw config set agents.defaults.model.primary "bailian/qwen3-plus"
# 重启网关使配置生效
openclaw gateway restart
在管理员 PowerShell 中执行：
openclaw plugins install @m1heng-clawd/feishu
插件安装可能需要几分钟，期间可以继续后续的飞书开放平台配置。
在应用详情页左侧导航栏，找到"添加应用能力" → 选择"机器人" → 点击"添加"。
进入"凭证与基础信息"页面，复制以下信息并妥善保存（后续配置需要使用）：
进入"权限管理"页面，点击"批量导入/导出权限"，粘贴以下 JSON 配置，然后点击"确认新增权限"：
{"scopes":{"tenant":["aily:file:read","aily:file:write","contact:user.employee_id:readonly","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"]}}
这个配置包含了机器人必需的 8 项核心权限。
openclaw gateway restart，等 1-2 分钟再重试。im.message.receive_v1（接收消息事件）方式一：通过命令行配置
# 配置 App ID 和 App Secret（替换为实际值）
openclaw config set channels.feishu.appId "cli_xxxxx"
openclaw config set channels.feishu.appSecret "your_app_secret"
# 重启网关
openclaw gateway restart
方式二：通过 Web UI 配置
http://127.0.0.1:18789/复制这个配对码，在 OpenClaw 控制台中执行：
openclaw pairing approve feishu 配对码
或者通过 Web UI 输入配对码完成绑定
配对成功后，你就可以在飞书中与 OpenClaw 愉快交流了！也可以把机器人添加到公司群里，让所有小伙伴都能用。
在配置过程中遇到问题，优先使用以下命令自查：
| 命令 | 作用 |
|---|---|
openclaw gateway status | 查看网关服务运行状态 |
openclaw gateway restart | 重启网关（修改配置后必须执行） |
openclaw doctor | 全面诊断系统环境，给出修复建议 |
openclaw logs follow | 实时查看日志，出 bug 基本靠它定位 |
openclaw config | 交互式修改配置 |
openclaw --version | 查看版本，验证安装是否成功 |
A：先执行 openclaw gateway restart 重启网关，再重试安装。如果仍失败，查看日志 openclaw logs follow 定位具体原因。
A：这通常是 OpenClaw 网关未正常运行或网络不通。按顺序检查：
openclaw gateway status 确认网关运行中A：检查三点：
im.message.receive_v1 事件A：OpenClaw 要求 Node.js 22+，执行 node --version 查看版本。如版本过低，用 nvm 切换：nvm install 22 → nvm use 22.22.0。
OpenClaw 默认的 message 工具在飞书上发送本地图片时可能存在问题（飞书收到的是文件路径而非图片）。解决方法是利用 OpenClaw 的 TOOLS.md 机制：
在 OpenClaw 工作区的 TOOLS.md 文件中，加入以下内容（可直接在对话中发给 OpenClaw）：
# 飞书发图片方法
用 exec 工具执行 curl 调飞书 API，分三步：
1. 获取 tenant_access_token
2. 上传图片获取 image_key
3. 发送图片消息
具体命令参考飞书开放平台文档。
OpenClaw 的 AI 助手每次启动都会读取 TOOLS.md，学会这个新技能。这就是 OpenClaw 的设计哲学：用自然语言给 AI 写"说明书"。
通过本文的详细步骤，你应该已经成功在 Windows 上安装了 OpenClaw，并接入了飞书机器人。整个过程虽然步骤较多，但只要按顺序操作，就能顺利实现"飞书聊天窗口下达指令，OpenClaw 自动执行任务"的高效协作模式。
如果在配置过程中遇到问题，记得善用 openclaw logs follow 查看日志，它能帮你定位 90% 的问题。祝你在自动化办公的道路上一路畅通！
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online