1 打开OpenClaw官方网站 https://openclaw.ai/
2 打开Windows终端,注意是PowerShell终端,不是传统的cmd命令提示符
3 PowerShell终端一键安装命令(有网上教程要求是管理员身份运行PowerShell终端,我是普通用户身份,操作如下命令也是正常的)
powershell -c "irm https://openclaw.ai/install.ps1 | iex"4 如果检测到缺少Node.js版本则会自动下载,截止2026-4-22要求Node.js版本大于等于22,如果电脑版本较低,也会提示自动升级。
5 完成后关闭终端重开,验证:
PS C:\Users\ThinkPad> openclaw --versionOpenClaw 2026.4.21 (f788c88)6 初始化与配置(首次必做)
# 启动初始化向导(官方推荐)openclaw onboard --flow quickstart按提示:
同意风险 →
yes模式 →
quick start模型选择:推荐通义千问(免费额度)
其他配置
skip跳过
7 正常运行启动命令
PS C:\Users\ThinkPad> openclaw dashboard
🦞 OpenClaw 2026.4.21 (f788c88) — I don't sleep, I just enter low-power mode and dream of clean diffs.
Dashboard URL: http://127.0.0.1:18789/#token=91b49dd902b54ccf9cd3a53c6b51c4fdb2f68c91910ee513Copied to clipboard.Opened in your browser. Keep that tab to control OpenClaw.启动成功后,打开浏览器启动小龙虾http://127.0.0.1:18789/
------------------------------------------------------------------------
我在安装部署过程中也遇到了各种奇怪问题,分享出来供大家参考。
1 启动报错,Error: Cannot find module '@larksuiteoapi/node-sdk' Require stack: - D:\Software\nvm-noinstall\v24.9.0\node_modules\openclaw\dist\extensions\feishu\client-yWGpoGkZ.js
解决方案:
@larksuiteoapi/node-sdk是飞书集成依赖官方安装脚本偶尔漏装这个包
手动安装一下就恢复正常
cd D:\Software\nvm-noinstall\v24.9.0\node_modules\openclawnpm install @larksuiteoapi/node-sdk如果仍有报错,使用强制安装命令
npm install @larksuiteoapi/node-sdk --force2 手动配置模型的配置文件
Windows路径: %USERPROFILE%\.openclaw\openclaw.json手工修改参考如下(以阿里的通义千问大模型为例):
{
"models": {
"providers": {
"bailian": {
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"apiKey": "sk-你的真实apikey填写",
"api": "openai-completions",
"models": [
{
"id": "qwen-turbo",
"name": "通义千问Turbo",
"contextWindow": 128000,
"maxTokens": 8000
},
{
"id": "qwen-plus",
"name": "通义千问Plus",
"contextWindow": 128000,
"maxTokens": 16384
},
{
"id": "qwen3.5-plus",
"name": "通义千问3.5 Plus",
"contextWindow": 1000000,
"maxTokens": 65536
}
]
}
}
}
}配置完成后,进行服务检测
openclaw doctor --fix重启网关服务
openclaw gateway restart设置默认模型
openclaw models set bailian/qwen3.5-plus3 小龙虾启动时提示OpenClaw doctor │ ◇ Gateway ──────────────────────────────────────────────────────────╮ │ │ │ gateway.mode is unset; gateway start will be blocked. │ │ Fix: run openclaw configure and set Gateway mode (local/remote). │ │ Or set directly: openclaw config set gateway.mode loca
解决方案:
(1) 先设置网关模式(必须执行)
openclaw config set gateway.mode local(2)自动修复所有配置问题
openclaw doctor --fix(3)重启网关openclaw gateway restart