SC-2026-26039_OpenClaw Windows 安装配置手册

 

适用系统：Windows 10 / Windows 11适用版本：OpenClaw 2026.3.x 及以上

 

---

 

 

一、安装前准备

1. 确认系统要求

·       操作系统：Windows 10 或 Windows 11

·       内存：建议 4GB 以上

·       网络：需要能够访问国际互联网

·       本地端口：确保 18789 端口未被占用

2. 以管理员身份打开 PowerShell

后续所有命令都需要在管理员权限的 PowerShell 中执行。

操作方法：

1.       按键盘 Win 键，输入 PowerShell

2.       在搜索结果中右键点击 Windows PowerShell

3.       选择 "以管理员身份运行"

 

---

 

 

二、修改 PowerShell 脚本执行策略

Windows 默认禁止运行外部脚本，需要先修改此限制。

在管理员 PowerShell 中输入以下命令并回车：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

系统弹出确认提示后，输入 Y 并回车确认。

✅ 此操作只需执行一次，永久生效。

 

---

 

 

三、安装 Git

OpenClaw 的部分依赖包需要调用 Git 来下载代码，必须提前安装。

在管理员 PowerShell 中输入以下命令：

winget install --id Git.Git -e --source winget

按照提示输入 Y 同意安装协议，等待安装完成。

✅ 安装完成后必须关闭当前 PowerShell 窗口，重新以管理员身份打开一个新窗口，否则系统识别不到新安装的 Git。

 

---

 

 

四、安装 Node.js（如果系统未自动安装）

在新的管理员 PowerShell 窗口中输入：

winget install --id OpenJS.NodeJS.LTS -e --source winget

等待安装完成后，验证是否安装成功：

node --versionnpm --version

如果两个命令都输出了版本号（例如 v24.14.0 和 10.x.x），说明安装成功。

✅ 同样需要关闭并重新打开 PowerShell 窗口后再继续。

 

---

 

 

五、安装 OpenClaw

在管理员 PowerShell 中输入以下命令：

npm install -g openclaw@latest

等待安装进度完成，没有红色报错即为成功。

验证是否安装成功：

openclaw --version

如果输出版本号（例如 2026.3.1），说明安装成功。

 

---

 

 

六、初始化配置

运行交互式配置向导：

openclaw configure

按照向导提示完成以下配置：

1.       选择大模型：选择你要接入的 AI 模型（如 OpenAI、DeepSeek、Claude 等）

2.       输入 API Key：填入从对应平台获取的 API 密钥

3.       设置网关 Token：设置一个访问凭证，请务必记住

 

---

 

 

七、启动网关服务

配置完成后，启动 OpenClaw 的网关服务：

openclaw gateway --port 18789

看到类似以下输出说明启动成功：

✅ Gateway listening on ws://127.0.0.1:18789

⚠️ 重要：不要关闭这个 PowerShell 窗口，关闭后服务会立即停止。

 

---

 

 

八、打开控制台

新开一个 PowerShell 窗口，输入以下命令：

openclaw dashboard

系统会自动用浏览器打开控制台页面，并自动携带 Token 完成身份验证，无需手动输入任何内容。

✅ 以后每次使用都只需要运行这一条命令即可打开控制台。

 

---

 

 

九、设置开机自启（推荐）

为了避免每次开机都需要手动启动网关，可以将 OpenClaw 注册为系统后台服务：

openclaw daemon install

安装完成后，OpenClaw 会在后台静默运行，开机自动启动。

 

---

 

 

十、日常使用

每次使用只需要：

openclaw dashboard

浏览器会自动打开控制台，直接开始使用。

常用命令速查表：

命令	说明
openclaw dashboard	打开控制台（日常使用）
openclaw gateway --port 18789	手动启动网关服务
openclaw health	查看网关健康状态
openclaw status	查看各渠道连接状态
openclaw logs	实时查看运行日志
openclaw configure	重新进行配置向导
openclaw daemon install	安装为系统后台服务
openclaw daemon uninstall	卸载系统后台服务
openclaw update	更新到最新版本
openclaw --help	查看所有可用命令

 

---

 

 

十一、可选配置

绑定聊天渠道

在控制台的 Channels 菜单中，可以将 OpenClaw 绑定到以下聊天软件：

·       Telegram：需要提供 Telegram Bot Token

·       Discord：需要提供 Discord Bot Token

·       WhatsApp：扫描二维码登录

配置大模型

在控制台的 Models 菜单中，可以随时切换或添加新的大模型 API。

 

---

 

 

十二、常见问题排查

问题	原因	解决方法
无法加载 .ps1 脚本	PowerShell 执行策略限制	执行 Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
npm error code ENOENT	Git 未安装	执行 winget install --id Git.Git -e --source winget
localhost 拒绝连接	网关服务未启动	执行 openclaw gateway --port 18789
unauthorized: gateway token missing	Token 未验证	执行 openclaw dashboard 自动完成验证
error: unknown command 'xxx'	命令名称不正确	执行 openclaw --help 查看正确命令
安装后命令无法识别	环境变量未刷新	关闭并重新打开 PowerShell 窗口

 

---

 

 

安全建议

⚠️ OpenClaw 拥有较高的本地系统执行权限，请注意以下事项：

1.       不要将 18789 端口暴露到公网

2.       妥善保管你的 Gateway Token，不要泄露给他人

3.       建议开启同意模式（Consent Mode），让每次敏感操作都需要你手动确认

4.       定期执行 openclaw update 保持版本更新以获得安全补丁

 

---

 

 

文档版本：v1.0整理日期：2026年3月参考文档：docs.openclaw.ai/cli

 

---