简介
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 版本可避免冲突。
- 访问 nvm-windows GitHub 发布页下载
nvm-setup.exe - 一路点击 Next 完成安装
1.3 安装 Node.js 22.x
以管理员身份打开 PowerShell,执行:
nvm install 22
nvm use 22.22.0
看到 Now using node v22.22.0 即成功。若下载失败,可手动前往 Node.js 官网下载安装。
验证安装:
node --version
npm --version
二、安装 OpenClaw
2.1 一键安装脚本
在管理员 PowerShell 中执行以下命令。如遇执行策略报错,先解除限制:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
执行安装脚本(推荐官方源,网络不稳可用镜像):
iwr -UseBasicParsing https://openclaw.ai/install.ps1 | iex
# 或使用国内镜像
# iwr -UseBasicParsing https://clawd.org.cn/install.ps1 | iex
过程自动下载配置 Node.js 和核心文件,耗时约 5-10 分钟。
2.2 初始化配置
安装完成后会自动进入流程。若意外关闭,重新执行:
openclaw onboard --flow quickstart
交互配置:
- 风险提示输入
Yes - 初始化模式选
QuickStart(直接回车) - 模型提供商选
Skip for now(后续配置) - 通讯渠道选
Skip for now(飞书稍后配) - 技能配置选
No
若 openclaw 命令提示无法识别,关闭当前窗口重开即可,环境变量需刷新。
2.3 启动服务
openclaw gateway start
openclaw dashboard
浏览器自动打开 http://127.0.0.1:18789/,发送消息测试有回复即成功。
三、配置大模型 API
OpenClaw 依赖大模型理解自然语言,需配置 API 密钥。以阿里云百炼为例:

