win11部署OpenClaw实测
Win11 部署OpenClaw
1、依赖准备
Node.js>=22
第一步很简单,去Node.js官网下载并安装最新稳定版就行:https://nodejs.org/。不过这里有个小提示,安装时最好选择默认路径。为什么?因为实测下来,如果路径非默认,OpenClaw在调用node程序时,偶尔会报一些找不到路径的错误,从源头避免最省心。
Git
Git是必不可少的,同样从官网下载安装即可:https://git-scm.com/。
参考文档与教程
动手前,备好这几份资料会让你事半功倍:
中文手册:https://docs.openclaw.ai/zh-CN
一份非常详细的实操博客:《Windows 11 安装小龙虾OpenClaw入门笔记》
如果遇到npm error code 128,通常跟SSH密钥有关,多数情况下,只执行相关解决方案的第一步——检查SSH密钥配置——就能搞定。
最后,如果你部署后发现Tools工具权限被禁用了,别慌,看看这篇《OpenClaw部署后Tools工具权限被禁用?一行配置解决》。
2、本机环境参考
为了确保复现顺利,这里提供一下成功部署时的环境版本供你对照:
Node.js:v24.14.0
Git:git version 2.53.0.windows.1
3、安装与配置OpenClaw
第一步:全局安装
打开终端,执行下面的全局安装命令:
npm install -g openclaw@latest
第二步:进入初始化配置
安装完别急着关终端,紧接着运行配置向导:
openclaw onboard --install-daemon
这时候,命令行会交互式地引导你。首先,它会提示是否继续,输入大写字母Y,然后回车:
接下来会让你选择模型,我这边选的是千问。如果你有GitHub账号,系统会弹出一个授权页面,按照提示完成登录验证就行。至于后续的其他配置选项,如果不太确定,可以先选择跳过。
完成这步后,浏览器可能会自动弹出一个OpenClaw的网页,但界面显示可能不全。别担心,这不是安装失败。回到终端,执行下面这条指令:
openclaw gateway --port 18789 --verbose
执行后,再刷新刚才的浏览器页面,你就能看到完整的OpenClaw WebChat界面了:

第三步:解决工具权限问题
如果你进入界面后,发现很多操作选项是灰色不可用的,就像下图这样:
问题出在哪?其实,这是OpenClaw出于安全考虑做的默认设置。它遵循最小权限原则,初始配置像文件操作、命令执行这类敏感工具都是默认关闭的。
解决办法就是修改配置文件,把权限级别调高。
首先,找到OpenClaw的配置文件。在Windows 11上,它的位置通常在:C:\Users\你的用户名\.openclaw目录下,文件名叫openclaw.json。
用VS Code或者其他文本编辑器打开它。找到配置文件里的tools部分,添加或者修改profile这个字段。修改前,它的值可能是messaging或其他:
我们只需要把它改成full即可:

改完保存。接下来,需要重启OpenClaw Gateway服务让配置生效。在终端里执行:
openclaw gateway restart
重启后,再次运行网关命令(或者直接刷新网页可能也行):
openclaw gateway --port 18789 --verbose
你可以在浏览器中直接访问这个地址进入管理界面:
http://127.0.0.1:18789/overview
有时候,再次打开WebChat可能会看到一个安全告警。这时候,你需要去刚才的“概览”(Overview)页面,将openclaw.json文件里token字段的内容复制出来,粘贴到WebChat的对应链接或验证框中,然后点击链接。
完成这一步,你应该就能获得一个功能完整、权限全开的OpenClaw工作环境了。
