跳到主要内容Windows 下安装 OpenClaw 并接入飞书机器人指南 | 极客日志JavaScriptNode.jsAI
Windows 下安装 OpenClaw 并接入飞书机器人指南
在 Windows 环境下安装 OpenClaw 开源 AI Agent 框架并接入飞书机器人的完整流程。主要步骤包括：使用 nvm 安装 Node.js 22.x 环境；通过 PowerShell 脚本一键安装 OpenClaw 并进行初始化配置；配置阿里云百炼等大模型 API 密钥；在飞书开放平台创建企业自建应用，配置权限、事件订阅及凭证；最后在 OpenClaw 中完成飞书通道配置与配对。文中还提供了常用排错命令及常见问题解决方案，帮助用户快速部署自动化办公场景。
咸鱼开飞机11 浏览 前言
OpenClaw 是一个强大的开源 AI Agent 框架，与飞书结合可提升办公效率。本文介绍如何在 Windows 系统上完成 OpenClaw 的安装，并成功接入飞书机器人。
⚠️ 重要提示：隐私安全优先
由于 OpenClaw 这类自动化工具会深度接触系统和数据，如果电脑存有重要的商业资料或个人隐私信息，强烈建议使用一台干净的备用电脑，或者在阿里云、腾讯云等平台租用一个云端虚拟机（VPS）来运行。这样既能保护隐私，也能避免环境冲突。
第一部分：Windows 环境准备
1.1 系统要求
- 操作系统：Windows 10/11 64 位（专业版或企业版更佳）
- 权限要求：全程需使用管理员权限运行 PowerShell
- 网络要求：确保网络通畅，能访问 GitHub 和 npm 源
1.2 安装 nvm for Windows（推荐）
使用 nvm 可以方便地管理 Node.js 版本，避免版本冲突。
1.3 安装 Node.js 22.x 版本
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
第二部分：安装 OpenClaw
2.1 一键安装脚本（推荐）
# 如果遇到执行策略报错，先解除限制
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 分钟。
2.2 初始化配置
安装完成后会自动进入配置流程。如果意外关闭，可以重新执行：
openclaw onboard --flow quickstart
- 风险提示：
I understand this is powerful and inherently risky. Continue? → 输入 Yes
- 初始化模式：选择
QuickStart（直接回车）
- 模型提供商：建议先选择
Skip for now 跳过，后续再配置
- 通讯渠道：同样选择
Skip for now 跳过（飞书稍后单独配置）
- 技能配置：选择
No 跳过，后续可根据需要安装
⚠️ 常见问题：如果执行 openclaw 命令提示无法识别，只需关闭当前 PowerShell，重新用管理员权限打开一个新窗口即可。这是因为环境变量还未刷新。
2.3 启动服务并验证
# 启动网关服务
openclaw gateway start
# 访问 Web 控制台（会自动打开浏览器）
openclaw dashboard
浏览器会自动打开控制台地址：http://127.0.0.1:18789/。发一条消息测试，有回复就说明安装成功。
第三部分：配置大模型 API（核心前提）
OpenClaw 的自然语言理解能力依赖大模型，需要先配置 API 密钥。这里以阿里云百炼为例：
- 访问 阿里云百炼控制台，进入密钥管理页面
- 点击创建 API-Key，复制生成的密钥
# 配置百炼 API-Key（替换为你的实际密钥）
openclaw config set models.providers.bailian.apiKey "你的百炼 API-Key"
# 设置默认模型
openclaw config set agents.defaults.model.primary "bailian/qwen3-plus"
# 重启网关使配置生效
openclaw gateway restart
第四部分：飞书机器人配置（核心步骤）
4.1 安装飞书插件
openclaw plugins install @m1heng-clawd/feishu
插件安装可能需要几分钟，期间可以继续后续的飞书开放平台配置。
4.2 创建飞书企业自建应用
- 登录 飞书开放平台，进入开发者后台
- 点击创建企业自建应用，填写基本信息：
- 应用名称：如 OpenClaw 智能助手
- 应用描述：简要说明用途
- 应用图标：上传一个图标（可选）
- 点击创建
4.3 添加机器人能力
在应用详情页左侧导航栏，找到添加应用能力 → 选择机器人 → 点击添加。
4.4 获取核心凭证
进入凭证与基础信息页面，复制以下信息并妥善保存（后续配置需要使用）：
- App ID：应用的唯一标识
- App Secret：应用的安全凭证
4.5 批量导入权限
进入权限管理页面，点击批量导入/导出权限，粘贴以下 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"]}}
4.6 配置事件订阅
- 进入事件与回调页面 → 事件配置页签
- 订阅方式：选择使用长连接接收事件 → 点击保存
- ⚠️ 注意：如果报错未建立长连接，说明 OpenClaw 网关未正常运行。返回 PowerShell 执行
openclaw gateway restart，等 1-2 分钟再重试。
- 保存成功后，点击添加事件，搜索并添加
im.message.receive_v1（接收消息事件）
- 如果不添加此事件，机器人将无法收到任何消息
4.7 在 OpenClaw 中配置飞书凭证
# 配置 App ID 和 App Secret（替换为实际值）
openclaw config set channels.feishu.appId "cli_xxxxx"
openclaw config set channels.feishu.appSecret "your_app_secret"
# 重启网关
openclaw gateway restart
- 访问 OpenClaw 控制台
http://127.0.0.1:18789/
- 进入 Channels 或通道设置页面
- 找到飞书配置，填入 App ID 和 App Secret
4.8 发布应用版本
- 回到飞书开放平台，进入版本管理与发布页面
- 点击创建版本
- 填写版本号（如 v1.0.0）和更新说明
- 选择应用可见范围（可先选指定部门用于测试）
- 点击保存并提交审批
- 若自己就是管理员，可直接审批通过
4.9 配对操作
- 在飞书客户端（电脑端或手机端）搜索并添加刚刚创建的机器人
- 向机器人发送任意消息（如你好）
- 机器人会自动回复一个配对码
复制这个配对码，在 OpenClaw 控制台中执行：
openclaw pairing approve feishu 配对码
配对成功后，你就可以在飞书中与 OpenClaw 愉快交流了！也可以把机器人添加到公司群里，让所有小伙伴都能用。
第五部分：常用排错命令
| 命令 | 作用 |
|---|
openclaw gateway status | 查看网关服务运行状态 |
openclaw gateway restart | 重启网关（修改配置后必须执行） |
openclaw doctor | 全面诊断系统环境，给出修复建议 |
openclaw logs follow | 实时查看日志，出 bug 基本靠它定位 |
openclaw config | 交互式修改配置 |
openclaw --version | 查看版本，验证安装是否成功 |
常见问题及解决方案
Q1：安装插件时报错怎么办？
A：先执行 openclaw gateway restart 重启网关，再重试安装。如果仍失败，查看日志 openclaw logs follow 定位具体原因。
Q2：飞书配置时报未建立长连接？
A：这通常是 OpenClaw 网关未正常运行或网络不通。按顺序检查：
openclaw gateway status 确认网关运行中- 18789 端口是否被防火墙阻止
- 在飞书开放平台等待 1-2 分钟后重试保存
Q3：机器人收不到消息？
- 是否已添加
im.message.receive_v1 事件
- 应用版本是否已成功发布
- 是否已完成配对操作
Q4：Node.js 版本不兼容？
A：OpenClaw 要求 Node.js 22+，执行 node --version 查看版本。如版本过低，用 nvm 切换：nvm install 22 → nvm use 22.22.0。
进阶技巧：让 AI 学会发图片
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密钥对生成器
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
- Mermaid 预览与可视化编辑
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
- Keycode 信息
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
- Escape 与 Native 编解码
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
- JavaScript / HTML 格式化
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
- JavaScript 压缩与混淆
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
