AI创想

标题: OpenClaw【Windows版】安装、配置、API接入、卸载全流程小白指南 [打印本页]
作者: AI小编    时间: 5 天前
标题: OpenClaw【Windows版】安装、配置、API接入、卸载全流程小白指南
作者：LeeeX!
文章目录


前言

在安装之前，请确保您的设备满足以下基础要求：
(, 下载次数: 1)


一、openclaw安装步骤

安装方式一：Windows专用

  1. Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
复制代码
  1. iwr -useb https://openclaw.ai/install.ps1 | iex
复制代码
(, 下载次数: 1)


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

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

(, 下载次数: 0)

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

(, 下载次数: 1)

(, 下载次数: 1)

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

(, 下载次数: 0)

4.验证Node.js安装
  1. # CMD输入指令node-v
复制代码
输出以下node版本后，此时node 环境配置成功

(, 下载次数: 0)

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

(, 下载次数: 1)

  1. npminstall-g openclaw@2026.03.13
  2. #2026.0328更新：目前最新版本03.24进行了bug修复，可直接如下安装npminstall-g openclaw@latest
复制代码
安装完成后，可通过 openclaw --version 验证是否成功

(, 下载次数: 1)


(, 下载次数: 1)


二、openclaw初始化配置

安装完成后，通过初始化向导来生成对应的配置文件。
  1. openclaw onboard
复制代码
(, 下载次数: 1)

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

(, 下载次数: 1)

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

(, 下载次数: 1)

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

(, 下载次数: 1)

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

(, 下载次数: 1)

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

(, 下载次数: 1)

(, 下载次数: 1)

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

(, 下载次数: 1)

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

(, 下载次数: 1)

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

(, 下载次数: 1)

Enable hooks?
表示：启用钩子？
空格键将跳过选择进行选择，然后回车跳过。
(, 下载次数: 0)

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

(, 下载次数: 1)

(, 下载次数: 1)

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

(, 下载次数: 0)

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

(, 下载次数: 1)

  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)


五、常见问题

1、401 无效的令牌？

在apiKey填写对的情况下，有可能是openclaw缓存导致加载以前的，可以重配置一下。
交互式配置
  1. openclaw configure
复制代码
在向导中，选择配置模型（models）相关的部分，然后找到 modelstudio 提供商，按照提示将您的 API Key 准确无误地输入进去。
然后再重启
  1. openclaw gateway restart
复制代码
原文地址：https://blog.csdn.net/weixin_45791151/article/details/159430198



欢迎光临 AI创想 (https://llms-ai.com/) Powered by Discuz! X3.4