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工作环境了。