win11部署OpenClaw实测

2026-05-06阅读 0热度 0
ai

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 WebChat主界面

第三步:解决工具权限问题

如果你进入界面后,发现很多操作选项是灰色不可用的,就像下图这样:
工具权限被禁用示意图
问题出在哪?其实,这是OpenClaw出于安全考虑做的默认设置。它遵循最小权限原则,初始配置像文件操作、命令执行这类敏感工具都是默认关闭的。

解决办法就是修改配置文件,把权限级别调高。

首先,找到OpenClaw的配置文件。在Windows 11上,它的位置通常在:C:\Users\你的用户名\.openclaw目录下,文件名叫openclaw.json

用VS Code或者其他文本编辑器打开它。找到配置文件里的tools部分,添加或者修改profile这个字段。修改前,它的值可能是messaging或其他:
配置文件修改前内容
我们只需要把它改成full即可:
将profile字段值改为full

改完保存。接下来,需要重启OpenClaw Gateway服务让配置生效。在终端里执行:

openclaw gateway restart

重启后,再次运行网关命令(或者直接刷新网页可能也行):

openclaw gateway --port 18789 --verbose

你可以在浏览器中直接访问这个地址进入管理界面:

http://127.0.0.1:18789/overview

有时候,再次打开WebChat可能会看到一个安全告警。这时候,你需要去刚才的“概览”(Overview)页面,将openclaw.json文件里token字段的内容复制出来,粘贴到WebChat的对应链接或验证框中,然后点击链接。
在概览页面填写token进行验证
完成这一步,你应该就能获得一个功能完整、权限全开的OpenClaw工作环境了。

免责声明

本网站新闻资讯均来自公开渠道,力求准确但不保证绝对无误,内容观点仅代表作者本人,与本站无关。若涉及侵权,请联系我们处理。本站保留对声明的修改权,最终解释权归本站所有。

相关阅读

更多
欢迎回来 登录或注册后,可保存提示词和历史记录
登录后可同步收藏、历史记录和常用模板
注册即表示同意服务条款与隐私政策