未名手记

在原生Windows 上安装 OpenClaw

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

6,149字
26–39 分钟

blog.t725.cn/?p=2022

本文目录 隐藏
1 本文目标
2 安装前准备工作
2.1 [可选] Model API Key 准备
2.1.1 阿里云百炼
2.1.2 火山引擎
2.2 基础环境软件安装
2.3 配置安装前的 PowerShell 环境
2.4 NPM 改为国内源镜像
3 安装 OpenClaw
3.1 启动安装程序
3.2 OpenClaw 初始化配置
3.2.1 安装后观察
4 OpenClaw 网关的控制
4.1 手工安装网关方法
4.1.1 $Env:USERPROFILE.openclaw\gateway.cmd
4.2 安装为Windows系统服务
4.3 其他基本操作
5 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
# 此为默认路径，您可根据业务所在地域进行配置
base_url="https://ark.cn-beijing.volces.com/api/v3"
# 指定您创建的方舟推理接入点 ID，此处已帮您修改为您的推理接入点 ID
model="glm-4-7-251222"

基础环境软件安装

  1. 先下载 Node.js & NPM(选择22.16+的LTS版本)、Git for Windows、Visual C++ v14 Redistributable安装包，再进行安装。
  2. 在安装过程中，要注意：Node.js与Git要勾选类似Add to PATH，且Git还需要安装Git Bash。
  3. 安装后，打开 PowerShell 验证：
node -v
npm -v
git --version
Get-ChildItem -path c:\windows\system32\vcruntime140.dll

输出示例：

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:\> Get-ChildItem -path c:\windows\system32\vcruntime140.dll

    Directory: C:\windows\system32

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---          2025/11/21    22:56         123472 vcruntime140.dll

配置安装前的 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

NPM 改为国内源镜像

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

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

安装 OpenClaw

启动安装程序

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

# cd ~ 这步可能没有变化，因为默认启动就是这个目录。  $Env:USERPROFILE
cd ~
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按空格键选中选项，按回车键进入下一步。

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

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

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

成功：看安装为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 关闭。

$Env:USERPROFILE.openclaw\gateway.cmd

@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 核心服务 的启动/停止/查看：无需要管理员权限，以窗口方式运行
openclaw gateway start/stop/status
# OpenClaw 的诊断工具：用于检查当前环境的配置和各个组件的运行状态是否健康
openclaw doctor

初始化配置向导

与 openclaw config 有区别，但如果熟悉的话，可以忽略这个区别。

# 重置 onboard 配置（首次安装推荐）
openclaw onboard --reset
# 完整安装向导并配置为系统服务（开机自启），免去每次手动启动：原生 Windows 无效。
openclaw onboard --install-daemon
# 仅运行配置向导（如已重置或需修改配置）
openclaw onboard

安装插件：OpenClaw 支持丰富的插件扩展

# 安装企业微信插件
openclaw plugins install @wecom/wecom-openclaw-plugin

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
pnpm remove -g openclaw
bun remove -g openclaw

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注


更多文章与分类

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