OpenClaw 是一个能帮你自动执行任务的强大 AI 助理框架,但在 Windows 上配置它确实需要一些特别的步骤。别担心,我为你整理了一份详细且经过验证的教程,跟着做就能顺利跑起来。
整个安装流程可以分为五个主要阶段,我将逐一为你讲解。
📝 第一步:准备工作 (关键!)
在正式安装前,有几项准备工作需要完成,这能帮你避开大部分新手容易遇到的坑。
- ⚠️ 重要安全提示:OpenClaw 是一个功能强大的自动化工具,可能会操作你的文件系统。为了保护个人隐私和重要数据,强烈建议你使用一台干净的备用电脑,或者考虑租用一个云端虚拟机来进行安装和测试。
- 确认系统要求:
- 操作系统:Windows 10 或 11(64位)。
- 网络:能够顺利访问 GitHub 和 Node.js 官网,用于下载必要的组件。
🛠️ 第二步:安装 Node.js 环境 (OpenClaw 的运行基础)
OpenClaw 要求 Node.js 版本在 22 或以上。为了避免版本冲突,强烈推荐使用nvm (Node Version Manager)来安装和管理 Node.js 版本。
安装 nvm for Windows:
- 访问 nvm-windows 的 GitHub Releases 页面,下载
nvm-setup.exe文件。 - 双击运行,一路点击 “Next” 即可完成安装。
- 访问 nvm-windows 的 GitHub Releases 页面,下载
以管理员身份打开 PowerShell:
- 按下
Win + S键,搜索 “PowerShell”。 - 在搜索结果上右键点击,选择“以管理员身份运行”。后续的所有命令都建议在此窗口中执行,以避免权限问题。
- 按下
安装并使用 Node.js 22.x:
- 在 PowerShell 中依次输入以下命令:
# 安装 Node.js 22 的最新版本nvm install 22# 使用刚刚安装的 Node.js 22.x 版本nvm use 22.22.0 - 如果看到类似
Now using node v22.22.0的提示,说明环境安装成功。如果下载失败,也可以手动访问 Node.js 官网 下载 22.x 版本的安装包进行安装。
- 在 PowerShell 中依次输入以下命令:
🚀 第三步:一键安装 OpenClaw
环境准备好后,就可以开始安装 OpenClaw 本体了。
执行安装命令:在刚才的管理员 PowerShell 中,复制并粘贴以下命令,然后按回车:
iwr-useb https://openclaw.ai/install.ps1|iex这是官方的一键安装脚本,会自动下载并安装 OpenClaw。
处理执行策略报错(如果遇到):首次运行脚本可能会遇到权限错误。如果安装命令报错,可以先运行下面这行命令解除脚本执行限制,然后再重新运行安装命令:
Set-ExecutionPolicy-ExecutionPolicy RemoteSigned-Scope CurrentUser
⚙️ 第四步:初始化配置 (Onboarding Wizard)
安装完成后,安装程序通常会自动启动配置向导。如果中途关闭了,可以随时在 PowerShell 中输入openclaw onboard --flow quickstart重新启动。
根据向导的提示,你需要做出以下选择:
- 风险提示:会出现一个关于工具强大功能与风险的提示,输入
Yes确认继续。 - 安装模式:选择
QuickStart(快速开始),这是为新手准备的模式。 - 选择 AI 模型 (大脑):
- 新手推荐:可以选择
Google Gemini,在国内网络环境下相对更稳定。或者选择Qwen(通义千问)进行授权。 - 向导会要求你提供API Key。你需要提前去相应平台的官网(如 OpenAI、Google AI Studio、阿里云百炼等)注册账号并创建一个 API Key。请妥善保管你的 API Key,它就像密码一样重要。
- 新手推荐:可以选择
- 选择通讯渠道 (Channels):为了先确保 OpenClaw 能正常运行,这里请选择
Skip for now(暂不配置)。 - 配置技能 (Skills):为了让你的 AI 助理一开始就具备文件操作、联网搜索等基础能力,这里请选择
Yes,安装推荐的技能。 - 守护进程 (Daemon):选择
Yes,这样即使关闭 PowerShell 窗口,OpenClaw 的核心服务也能在后台继续运行。
✅ 第五步:验证安装并开始使用
配置完成后,我们就可以检验成果了。
启动 Gateway 服务:Gateway 是 OpenClaw 的心脏,负责所有核心功能。在 PowerShell 中运行以下命令来启动它:
openclaw gatewaystart打开 Web 控制台 (Dashboard):启动成功后,在浏览器中访问
http://127.0.0.1:18789/。你应该能看到 OpenClaw 的 Web 管理界面。- 你也可以直接在 PowerShell 中输入
openclaw dashboard,系统会自动在浏览器中打开这个地址。
- 你也可以直接在 PowerShell 中输入
发送一条消息试试:在 Web 控制台的聊天框里输入 “你好”,如果能收到回复,就恭喜你,OpenClaw 已经成功在你的 Windows 电脑上运行起来了!
💬 进阶:将 OpenClaw 接入飞书
如果你想让这个 AI 助理进入你的飞书工作群,可以按照以下步骤进行扩展。
1. 在 OpenClaw 中安装飞书插件
在 PowerShell 中执行以下命令:
openclaw plugins install @m1heng-clawd/feishu安装过程可能需要一点时间,请耐心等待。
2. 在飞书开放平台创建应用
- 登录 飞书开放平台,创建一个企业自建应用。
- 创建成功后,进入应用详情页,复制出App ID和App Secret,稍后要用。
- 在“权限管理”中,点击“批量导入导出权限”,将教程提供的 JSON 权限代码粘贴进去,并确认新增权限。
- 进入“事件与回调”页面,将“订阅方式”选择为“使用长连接接收事件”并保存。然后点击“添加事件”,搜索并添加
im.message.receive_v1事件,这样机器人才能收到消息。 - 最后,进入“版本管理与发布”页面,创建一个版本并发布。只有发布后,前面的配置才会生效。
3. 在 OpenClaw 中完成绑定
- 回到 OpenClaw 的 Web 控制台 (
http://127.0.0.1:18789/),在飞书配置页面填入刚才复制的 App ID 和 App Secret。 - 在飞书客户端中找到你刚刚创建的机器人,给它发送任意消息。它会自动回复一个配对码。
- 将这个配对码复制,发送给 OpenClaw 的 Web 控制台(或根据界面提示输入),即可完成绑定。之后,你就可以在飞书里和你的 AI 助理对话了。
🔧 常用命令速查
在配置和使用过程中,这几个命令可能会帮上大忙:
- 启动 Gateway 服务:
openclaw gateway start - 重启 Gateway 服务:
openclaw gateway restart - 查看服务状态:
openclaw gateway status或openclaw status - 运行健康检查:
openclaw doctor(遇到问题时首选) - 查看实时日志:
openclaw logs follow(排查错误的关键) - 打开 Web 控制台:
openclaw dashboard - 重新运行配置向导:
openclaw onboard
希望这份教程能帮助你顺利完成 OpenClaw 的安装。如果在某个步骤卡住,随时可以再来问我。祝你玩得开心!