第一步、安装 Nodejs
-
为减少后续报错,建议先安装 Node.js。下载地址:https://nodejs.org/zh-cn/download,选择对应操作系统版本。24 版本较新可能存在依赖不适配问题,本文推荐选择 22.22.0 版本(node-v22.22.0-x64.msi),直接双击安装即可。
-
安装完成后,使用管理员权限打开 Windows PowerShell 查看版本信息。
-
执行命令验证:
node -v
第二步、安装 Git
-
访问 https://git-scm.com/install/windows 下载安装文件 Git-2.53.0-64-bit.exe。
-
选择默认选项安装,完成后检查版本信息是否生效。
第三步、安装 OpenClaw
- 设置脚本执行权限,依次执行以下命令,键盘输入 y 确认:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
- 以管理员权限打开 PowerShell,执行一键安装脚本:
iwr -useb https://openclaw.ai/install.ps1 | iex
等待安装完成无报错提示。
-
进行新手设置,执行命令
openclaw onboard --install-daemon,选择 QuickStart。默认 gateway 端口为 18789,bind 地址为 127.0.0.1。下一步选择模型,此处选择 Qwen,随后弹出千问登录认证页面。注册登录成功后继续。 -
远程控制渠道选择飞书,选择下载安装 plugin。
-
登录飞书开放平台:https://open.feishu.cn/app/cli_a93a790fdeb89cc9/baseinfo
获取 Secret,复制后在 cmd 中右键粘贴 Enter,再输入 App ID。provider、skills、hooks 可跳过,后续单独配置。之后会弹出 gateway 的 cmd 前台信息。
找到默认安装路径 C:\Users\xxx.openclaw 中的 openclaw.json 文件,查找 token 用于验证登录。在 json 中找到 gateway 模块下的 token。
OpenClaw 界面访问:输入访问地址 http://127.0.0.1:18789#token=你的 token 即可查看后台界面。
打开 OpenClaw 后台可以进行对话,使用千问模型。如需重新配置大模型 token,可使用命令 openclaw onboard,输入对应的 API key 即可。
若未配置大模型 API,可输入命令 openclaw configure 进行配置。使用 openclaw models list 查看已配置模型。登录国内大厂获取免费 token 额度或付费订阅。
常用检查命令:
# 检查 OpenClaw 版本
openclaw --version
# 检查系统健康状态
openclaw doctor
# 检查 Gateway 状态
openclaw gateway status


