Windows环境下OpenClaw一键安装脚本

OpenClaw Windows 一键安装脚本

这个脚本涵盖了从环境检查、依赖安装、配置设置到服务启动的完整流程，专门为Windows环境设计。它帮你绕过了那些常见的坑，比如命令不兼容、配置迁移繁琐等问题，让部署过程变得顺畅。

1. 检查并设置执行策略

首先，脚本会检查当前用户的PowerShell执行策略。如果策略不是“RemoteSigned”，别担心，它会自动帮你设置好。这一步是为了确保后续的脚本能够顺利运行，算是给后续操作铺平道路。

2. 检查Node.js版本

接下来是关键一步：检查Node.js。OpenClaw的运行依赖Node.js环境，并且要求版本在22.0.0以上。

如果系统里压根没装Node.js，脚本会贴心地自动为你下载并安装22.11.0版本。如果检测到已安装的版本太旧，它会给出明确提示，并引导你前往官网下载最新版。这一步把版本依赖问题安排得明明白白。

3. 配置国内镜像源（加速下载）

为了提升后续的包安装速度，脚本会主动将npm的注册表源切换到国内的镜像地址。这个小改动，对于国内用户来说，下载体验的提升是立竿见影的。

4. 全局安装OpenClaw

环境准备就绪，现在开始安装主角。通过npm的全局安装命令，脚本会拉取并安装最新版的OpenClaw。这里使用了`--force`参数，确保安装过程覆盖任何可能存在的旧版本，保证环境干净。

5. 检查安装结果

安装完成，总要验验货。脚本会尝试运行`openclaw -v`来获取版本号，以此验证安装是否真正成功。如果这一步失败了，它会明确告诉你，并建议检查网络后重试。

6. 创建配置文件目录

OpenClaw需要一个地方来存放它的配置。脚本会在当前用户目录下创建名为`.openclaw`的隐藏文件夹，所有相关的配置文件都将归置于此。

7. 生成随机令牌

安全不能忽视。脚本会生成一个由大小写字母和数字组成的24位随机字符串，作为网关访问的认证令牌。这个令牌是后续访问Dashboard的钥匙。

8. 创建配置文件

有了目录和令牌，现在来生成核心配置文件`openclaw.json`。文件内容已经预设好：网关运行在本地模式，端口为18789，并嵌入了刚才生成的令牌。同时，也预置了一些常用插件（如钉钉、飞书）的配置结构，开箱即用。

9. 显示安装结果

大功告成！脚本会清晰地展示本次安装的所有关键信息：OpenClaw和Node.js的版本号、网关端口、生成的认证令牌以及配置文件的具体位置。

最后，它还会贴心地列出几个最常用的后续操作命令，比如如何启动网关、查看状态以及最重要的——访问Web控制面板（Dashboard）的完整链接，里面已经包含了你的专属令牌。

OpenClaw网关令牌管理脚本

令牌是访问网关的关键，这个脚本就是你的令牌管家。它提供了一个清晰的菜单界面，让你能方便地查看、更换、备份令牌，并一键打开控制面板。

定义配置文件路径

脚本一开始就定义了两个核心路径：主配置文件的位置和用于存放历史配置备份的目录。备份目录如果不存在，会自动创建，为数据安全加了一道保险。

显示菜单

一个清晰的功能菜单是交互的基础。脚本会展示六个选项，从查看令牌到退出程序，功能一目了然。

显示当前令牌

选择第一个功能，脚本会直接调用OpenClaw命令，从配置文件中读取并显示当前的网关认证令牌。

生成新的随机令牌

如果你觉得旧令牌可能泄露，或者想定期更新，这个功能就派上用场了。脚本会生成一个新的24位随机令牌，并自动更新到配置文件中。为了生效，它还会在短暂等待后，自动重启网关服务。

手动设置令牌

有时你可能想使用自己指定的令牌。这个功能会提示你输入新令牌，验证非空后，同样会完成配置更新和服务重启这一套流程。

备份当前配置

在修改关键配置（如令牌）前进行备份是个好习惯。此功能会将当前的`openclaw.json`文件复制到备份目录，并在文件名上加上时间戳，方便你追溯和回滚。

打开带令牌的Dashboard

这是最便捷的功能之一。脚本会自动获取当前的令牌，拼接成完整的Dashboard访问URL，然后调用默认浏览器为你打开它，省去了手动复制粘贴的麻烦。

主程序

脚本的主体是一个循环，持续显示菜单并等待你的输入。根据你选择的数字（1-6），它会调用对应的功能函数。只有选择“6. 退出”时，循环才会结束，脚本随之终止。

OpenClaw开机自启动配置脚本（官方推荐方案）

如果你希望OpenClaw网关能在电脑开机登录后自动运行，这个脚本提供了官方推荐的配置方案。其核心原理是利用Windows计划任务来创建一个系统服务。

1. 配置Gateway模式为本地（本地部署必填）

首先，明确设置网关的运行模式为“local”（本地模式），这是单机部署的标准配置。

2. 安装Gateway服务（创建Windows计划任务，实现登录自动启动）

关键的一步。通过运行OpenClaw自带的`gateway install`命令，会在Windows计划任务中创建一个名为“OpenClaw Gateway”的任务。这个任务被设置为“当用户登录时触发”，从而实现开机自启。

3. 验证服务安装

安装完成后，立刻使用PowerShell命令查询一下同名的计划任务是否存在，以确认安装操作已成功执行。

4. 启动服务

光创建了任务还不够，现在需要手动启动它一次。这个命令会立即运行刚才创建的计划任务，相当于首次启动了网关服务。

5. 验证服务状态

再次检查计划任务的状态，确认其是否处于正常的“就绪”或“正在运行”状态，确保自启动机制已就位。

6. 显示安装结果

配置完成！脚本会汇总展示服务的关键信息：任务名称、触发条件以及实际执行的命令。同时，它也提供了后续管理这个服务所需的命令，比如如何停止、重启或彻底卸载该自启动服务，让你拥有完整的控制权。

环境要求：

在开始所有操作之前，请确保你的系统满足以下基础要求：

1. Node.js 运行环境：版本需 ≥ 22.0.0。
2. npm 包管理器：通常随 Node.js 自动安装。若需单独安装或下载Node.js，请点击此处：https://nodejs.org/。
3. 国内大模型平台的 API Key：例如来自智谱GLM、Minimax、月之暗面（Kimi）、通义千问等平台的密钥，这是OpenClaw连接AI能力的凭证。
4. Git 版本控制工具：安装过程中的某些步骤必需。若未安装，请点击此处下载：https://git-scm.com/。
5. Windows 操作系统版本：建议为 22H2 及以上版本，内部版本号不低于 19045.6456，以获得最佳的兼容性和稳定性。