OpenClaw【Windows版】安装、配置、API接入、卸载全流程小白指南

作者：LeeeX!
文章目录

前言一、openclaw安装步骤

安装方式一：Windows专用安装方式二：NPM 安装（需要配置Node.js环境，也是常用的一种安装方式）

二、openclaw初始化配置三、openclaw使用

1. 访问Web界面2. 常用管理指令

四、彻底卸载openclaw五、常见问题

1、401 无效的令牌？

---

前言

在安装之前，请确保您的设备满足以下基础要求：

操作系统：
Windows：Windows 10/11核心依赖软件：
Node.js：必须版本 ≥ v22（推荐 v24 LTS）
Git：拉取项目依赖

---

一、openclaw安装步骤

安装方式一：Windows专用

以管理员身份打开PowerShell，执行以下命令，之后输入 Y 确认，以允许运行脚本：

1. Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

复制代码

执行安装脚本：在 PowerShell 中粘贴并运行以下命令，从指定地址下载安装脚本，并在本地运行：

1. iwr -useb https://openclaw.ai/install.ps1 | iex

复制代码

安装方式二：NPM 安装（需要配置Node.js环境，也是常用的一种安装方式）

1. 首先安装Node.js
1. 访问 Node.js下载页面 ，根据自己的系统选择合适的 Windows 版本进行下载，推荐下载v24.14版本。

2. 安装程序，双击安装包，点【Next】按钮，此处可根据个人需求修改安装路径，修改完毕后继续点击【Next】按钮

3. 不选中，直接点击【Next】按钮，之后直接点击install，进行安装

4.验证Node.js安装

1. # CMD输入指令node-v

复制代码

输出以下node版本后，此时node 环境配置成功

2. 首先安装Node.js
打开PowerShell直接通过 npm 全局安装：
注意：目前openclaw@latest最新版本（2026.03.23）前端界面存在如下问题，作者正在修正，我们可以使用历史版本

1. npminstall-g openclaw@2026.03.13
2. #2026.0328更新：目前最新版本03.24进行了bug修复，可直接如下安装npminstall-g openclaw@latest

复制代码

安装完成后，可通过 openclaw --version 验证是否成功

二、openclaw初始化配置

安装完成后，通过初始化向导来生成对应的配置文件。

1. openclaw onboard

复制代码

点击yes回车即可，表示默认个人使用，若要共享/多用户使用则需要锁定。是否继续？

选择QuickStart快速开始(稍后通过 openclaw 配置详细信息)，

Model/auth provider
表示：模型/认证提供者
我这里选择了阿里云百炼，之后选择第一个API密钥，填写阿里云就百炼API Key即可。

阿里云百炼：登录入口，注册个人账户领取免费Token额度即可，复制API Key密钥，填写到上面即可。

FIlter models by provider
表示选择或过滤 AI 模型的提供者，默认全选即可

Select channel (QuickStart)
表示：选择频道（快速开始），用于和机器人对话的软件，因为安装在windows上，存在WebUI，直接跳过即可。

Search provider
表示：搜索提供者
也选择最后一项跳过即可，如图

Configure skills now?
表示：现在配置技能吗？
现在也不需要，主要熟悉过程，等后续使用哪个装哪个即可。

Enable hooks?
表示：启用钩子？
空格键将跳过选择进行选择，然后回车跳过。

走到这一步，可以看到OpenClaw启动了另一个Windows PowerShell窗口，是OpenClaw的网关服务，保持打开状态，同时当前窗口选择WebUI即可，会弹出来openclaw网页窗口。
之后可以正常进行对话

注意：如果在对话过程中出现以下401的问题，需要修改配置文件。

我们需要将C:\Users\path.openclaw\openclaw.json文件中的baseUrl路径更换掉（因为付费和免费的API接口是不一样的）以及新增apiKey参数，把你的API Key填写进去。

1. "baseUrl":"https://dashscope.aliyuncs.com/compatible-mode/v1","apiKey":"your Key",

复制代码

三、openclaw使用

1. 访问Web界面

打开浏览器访问 http://127.0.0.1:18789。
2. 常用管理指令

假设我们关闭了终端以及网页窗口，如何重启OpenClaw。
查看OpenClaw网关状态

1. openclaw gateway status

复制代码

启动网关

1. openclaw gateway run

复制代码

重启OpenClaw网关

1. openclaw gateway restart

复制代码

查看OpenClaw状态

1. openclaw status

复制代码

四、彻底卸载openclaw

如果之前开启了开机启动openclaw，则需要先停服务

1. openclaw gateway stop

复制代码

自动删除所有已安装的技能，并清理相关的配置数据

1. openclaw uninstall --all--yes --non-interactive

复制代码

全局卸载openclaw

1. npm uninstall -g openclaw

复制代码

如果还安装了ClawHub相关的包，也可以卸载

1. npm uninstall -g clawhub

复制代码

验证卸载是否成功，显示报错即为卸载成功：

1. openclaw --version

复制代码

手动将系统磁盘里安装openclaw的文件夹整体删除，但会将历史对话、API Key等完全删除掉，如果以后会到，想保留这些数据的话，可以将文件夹保留或者进行备份磁盘中。

五、常见问题

1、401 无效的令牌？

在apiKey填写对的情况下，有可能是openclaw缓存导致加载以前的，可以重配置一下。
交互式配置

1. openclaw configure

复制代码

在向导中，选择配置模型（models）相关的部分，然后找到 modelstudio 提供商，按照提示将您的 API Key 准确无误地输入进去。
然后再重启

1. openclaw gateway restart

复制代码

原文地址：https://blog.csdn.net/weixin_45791151/article/details/159430198