未名手记

在原生 Windows 上安装 OpenClaw

如果你没有云服务器，也不是Mac用户，那原生Windows也是一个不错的选择。

6,157字
26–39 分钟
blog.t725.cn/?p=2022
本文目录 隐藏
1 本文目标
2 安装前准备工作
2.1 Model API Key 准备
2.1.1 阿里云百炼
2.1.2 火山引擎
2.2 AI基础环境三件套
2.2.1 改为国内源镜像
2.3 配置安装前的 PowerShell 环境
3 安装 OpenClaw
3.1 使用npm包管理工具安装，需要手工启动初始化配置
3.2 使用install.ps1安装程序，会自动下载与进入到初始化配置
4 OpenClaw 初始化配置
4.1 安装后观察
5 OpenClaw 网关的控制
5.1 手工安装网关方法
5.1.1 gateway.cmd
5.2 安装为Windows系统服务尝试
5.3 网关基本控制操作
6 OpenClaw 自身的卸载

本文目标

在原生 Windows 11 上，完成快速配置，启动网关成功，进入控制台，也可以聊上几句。

  • 在命令行中对话：openclaw tui，进入 TUI 界面，使用 /model <模型名称> 在当前会话中切换模型。
  • 在 Web 中对话：openclaw dashboard，或在浏览口访问 http://127.0.0.1:18789 。
  • 官方文档：中文
  • 当然，这些安装配置步骤，在其他平台，也适用的。

安装前准备工作

提示：没有特殊说明，所有命令都在PowerShell中执行。

Model API Key 准备

建议提前准备，因为是必须品，安装时在 Model/auth provider 步骤选择 Skip for now，安装后，还得补上来。

在 OpenClaw 中：

  1. 智谱的 GLM 模型是以 Z.AI (GLM Coding Plan / Global / CN)这个名字出现的。
  2. Alibaba Cloud Model Studio (Coding Plan API key (CN / Global))的选项，是使用阿里云官方的、可能更原生的 SDK 或协议。
  3. OpenAI (Codex OAuth + API key)的选项，是专为OpenAI官方服务设计的专用选项。
  4. BytePlus选项，是字节跳动面向海外市场，为国际客户提供服务。
  5. 火山引擎 (Volcano Engine)选项，是字节跳动面向中国市场，为国内客户提供服务。

注意：如果你的应用与工具（比如：OpenClaw）原本就是为 OpenAI 设计的时，现在想无缝切换模型，选 Custom Provider (Any OpenAI or Anthropic compatible endpoint)这个最方便，只需改一下接口地址和 Key。

  • 所以，都使用 Custom Provider 这个选项吧。

阿里云百炼

2026/3/14 注册 阿里云百炼 有100W免费Token（宣传总量是7KW）。

  • 先把免费额度用完即停开启，不然免费额度使用完了，就会自动转为按量付费了。
  • 目前，国内只有一个地域：华北2北京，所以也不用考虑选了。
  • Base URL 华北2（北京）：https://dashscope.aliyuncs.com/compatible-mode/v1
  • API Key：填写你在阿里云百炼平台创建的API Key。
  • Model ID：填写具体的模型Code，例如：glm-5、qwen3.5-plus、qwen3-coder-next 等。

重要提醒：配置~/.openclaw/openclaw.json时，需要关闭推理模式（"reasoning": false），否则可能导致回复为空。 — 260314 已经默认为false了。

火山引擎

2026/3/14 注册 火山引擎 有50W免费Token。

  • Base URL与Model ID查看方式：依次点击模型名链接 –> API接入 –> STEP 2快速接入测试 –> OpenAI SDK 调用示例 –> Chat
    • 可能在火山云里，Model ID是机密信息，所以放得这么深，不如阿里云方便。
# 此为默认路径，您可根据业务所在地域进行配置
base_url="https://ark.cn-beijing.volces.com/api/v3"
# 指定您创建的方舟推理接入点 ID，此处已帮您修改为您的推理接入点 ID
model="glm-4-7-251222"

AI基础环境三件套

这三个工具，不仅是openclaw，其他AI应用程序，在完成任务时都有可能会用到。

  1. 下载 Node.js(选择最新的LTS版本)、Python、Git for Windows安装包，再进行安装。
    • 在安装过程中，要注意：Node.js与Git要勾选类似Add to PATH，且Git还需要安装Git Bash。
  2. 安装后，打开 PowerShell 验证安装结果：
node -v
npm -v
git --version
python --version

输出示例：如果不是类似结果，请卸载重新安装对应的软件。

PS D:\> node -v
v24.13.0
PS D:\> npm -v
11.6.2
PS D:\> git --version
git version 2.52.0.windows.1
PS D:\> python --version
Python 3.14.2

改为国内源镜像

默认是国外的，速度很慢。

# NPM 改为国内源镜像，如果你是校园网络，请更换为各大学的镜像URL
npm config set registry https://registry.npmmirror.com/
# 修改结果确认
npm config get registry

# PIP 改为国内源镜像
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple
pip config set install.trusted-host mirrors.aliyun.com
# 修改结果确认
pip config get global.index-url

配置安装前的 PowerShell 环境

# 为当前用户设置执行策略为 RemoteSigned（允许脚本运行） 
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 
# [Win11可跳过] 临时为当前进程解除所有执行限制（避免脚本被拦截） 
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
# 确认结果
get-ExecutionPolicy -List

看倒数第3行Process与倒数第2行CurrentUser的值，是不是和下面一样；不一样，需要重新执行。

        Scope ExecutionPolicy
        ----- ---------------
MachinePolicy       Undefined
   UserPolicy       Undefined
      Process          Bypass
  CurrentUser    RemoteSigned
 LocalMachine       Undefined

安装 OpenClaw

有两种方式，任选其中一就是了。但无论哪一个，需要以管理员身份，启动 PowerShell，先执行cd ~ 命令，再执行后面的命令。

这步可能没有变化，因为没有改默认启动目录，就是这个目录。

使用npm包管理工具安装，需要手工启动初始化配置

# 下载与安装
npm install -g openclaw@latest clawhub@latest

# 验证
openclaw --version
clawhub -V

# 启动初始化配置
openclaw onboard

如果已经配置过，想重新做初始化配置，请使用openclaw onboard --reset

使用install.ps1安装程序，会自动下载与进入到初始化配置

irm -UseBasicParsing https://openclaw.ai/install.ps1 | iex

命令作用是先下载ps1，后执行ps1。

  • irm -> Invoke-RestMethod 将 HTTP 或 HTTPS 请求发送到 RESTful Web 服务，-UseBasicParsing参数在6.0已废弃，在之前是用于直接下载。
  • iex -> Invoke-Expression 在本地计算机上运行命令或表达式。

看到这个文字图案，表示安装完成，进入初始化配置了。

注意：没有以管理员身份启动 PowerShell，在执行初始化配置过程中：

  • 有 Node.js 弹出提升UAC权限点，点通过就可以。
  • 但在最后，会报错 Gateway service install failed: schtasks create failed: ����: �ܾ����ʡ� ，后面，需要手工以管理员权限去安装网关。

或许，这也是一种选择：你不想以管理员身份安装网关，这样可以选择每次手动启动网关。

OpenClaw 初始化配置

步骤顺序选择说明
I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?Yes 
Onboarding modeQuickStart 
Model/auth providerCustom Provider根据自己准备的API Key做选择；或者选择 Skip for now
⊢ API Base URLhttps://dashscope.aliyuncs.com/compatible-mode/v1子步骤由Model选择的项决定。
⊢ How do you want to provide this API key?Paste API key now 
⊢ API Keysk-xxxxxx 
⊢ Endpoint compatibilityOpenAI-compatible 
⊢ Model IDglm-5这一步回车后，会做API KEY验证，成功会有提示：Verification successful.
⊢ Endpoint IDaliyun-bailian-xxx一般默认值就可以了，所有Endpoint ID之间，不能重复。
⌞ Model alias (optional)bailian-xxx给自己看的
Select channel (QuickStart)Skip for now 
Search providerSkip for now 
Configure skills now? (recommended)No 
Enable hooks?Skip for now建议是4个全选，按空格键选中选项，按回车键进入下一步。

无论是不是以管理员权限安装，在网关安装成功或失败后，都会自动打开web控制台页面，区别是：

  • 有没有开新的终端窗口，来运行网关程序。
  • 浏览器是有内容，还是报错。

失败：看手工安装网关方法章节。

在Windows系统中，目前不支持安装为Windows系统服务，所以桌面有一个终端窗口始终开着。

安装后观察

  1. 网关运行后，在任务管理器里，看到2个直接相关进程：
    • node.exe %AppData%\npm\node_modules\openclaw\dist\index.js gateway –port 18789
    • cmd.exe %UserProfile%\.openclaw\gateway.cmd
  2. 在Web控制台的聊天界面，打了个招呼，回复了各自的昵称，消耗Token约5W。
  3. 无活动时，工作集内存占用不高，只有100M+。

OpenClaw 网关的控制

查看当前版本与安装确认：openclaw --version

手工安装网关方法

需要以管理员身份，启动 PowerShell，再执行：

cd ~
openclaw gateway install

会看到提示创建定时任务成功，以及弹出网关运行窗口。

  • 添加了一个名为OpenClaw Gateway，用户登录时启动$Env:USERPROFILE\.openclaw\gateway.cmd。
    • 查看：schtasks /query | findstr OpenClaw
    • 删除：schtasks /delete /tn "名称" /f，比如：schtasks /delete /tn "OpenClaw Gateway" /f
  • 手工关闭[网关运行窗口]，会自动重新打开。需要使用 openclaw gateway stop 关闭。

gateway.cmd

执行 type $Env:USERPROFILE\.openclaw\gateway.cmd查看内容，可以在这个文件里添加OPENCLAW的环境变量。

@echo off
rem OpenClaw Gateway (v2026.3.12)
set "TMPDIR=%Temp%"
set "OPENCLAW_GATEWAY_PORT=18789"
set "OPENCLAW_SYSTEMD_UNIT=openclaw-gateway.service"
set "OPENCLAW_WINDOWS_TASK_NAME=OpenClaw Gateway"
set "OPENCLAW_SERVICE_MARKER=openclaw"
set "OPENCLAW_SERVICE_KIND=gateway"
set "OPENCLAW_SERVICE_VERSION=2026.3.12"
"C:\Program Files\nodejs\node.exe" %AppData%\npm\node_modules\openclaw\dist\index.js gateway --port 18789

安装为Windows系统服务尝试

网关运行正常后，关闭openclaw gateway stop

  1. 以管理员权限运行 openclaw onboard --install-daemon 发现，并不能安装为Windows 系统服务。
    • openclaw onboard --install-daemon应该是用于Linux的，会重新进入初始化配置向导，但可以使用已经存在的配置内容，过程中有相关选项。
  2. 所以，可以禁用自动安装的计划任务里的触发器（实现禁止开机自启动），改为手工启动 openclaw gateway start，或在菜单启动中添加%USERPROFILE%\.openclaw\gateway.cmd快捷方式，来实现开机自启动。
    • 不要删除OpenClaw Gateway计划任务，内置卸载有问题。
    • 不要关闭“按需运行任务”，会导致 openclaw gateway start报错；此时，可以通过%USERPROFILE%\.openclaw\gateway.cmd快捷方式启动。
  3. 关闭，需要使用openclaw gateway stop；直接关闭桌面窗口，会自动重新打开。

网关基本控制操作

# OpenClaw Gateway 的启动/停止/查看：无需要管理员权限，以窗口方式运行
openclaw gateway start
openclaw gateway stop
openclaw gateway status

# OpenClaw 的诊断工具：用于检查当前环境的配置和各个组件的运行状态是否健康
openclaw doctor

OpenClaw 自身的卸载

OpenClaw 能使用的情况下卸载很简单，也是推荐卸载方式，以管理员权限运行：openclaw uninstall

手工卸载步骤

# 停止 Gateway 网关服务：
openclaw gateway stop

# 卸载 Gateway 网关服务（launchd/systemd/schtasks）：
openclaw gateway uninstall
# 手工：默认任务名称是 OpenClaw Gateway（或 OpenClaw Gateway (<profile>)）。 任务脚本位于你的状态目录下。
schtasks /Delete /F /TN "OpenClaw Gateway"
# 手工：如果你使用了配置文件，请删除匹配的任务名称和 ~\.openclaw-<profile>\gateway.cmd
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

# 删除状态 + 配置：（如果你将 OPENCLAW_CONFIG_PATH 设置为状态目录外的自定义位置，也请删除该文件。）
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
# 删除你的工作区（可选，移除智能体文件）：
rm -rf ~/.openclaw/workspace
# 移除 CLI 安装：
npm rm -g openclaw

更多文章与分类

Access Axure Cloud Axure RP Bash Bat CentOS crontab Excel FTP JMeter macOS MariaDB Markdown MS Office 2010 从入门到精通 Nginx Obsidian OpenClaw Oracle Outlook PHP Postman PowerPoint PowerShell Project Rclone RDMS Rest RustDesk SoapUI SQL SSH SVN Tomcat Ubuntu Vibe Coding Visio VMware WebDav Win-ACME Windows Word WordPress WPS Office XPath 正则表达式