OpenClaw快速安装与配置指南（2026最新版，Windows端）
目录
6.4 Windows 环境下 pnpm build 报 bash 或 WSL 相关错误
OpenClaw 安装与初始化指南
1. 环境准备
1.1 配置 PowerShell 执行策略
首次运行 PowerShell 脚本时，建议先执行以下命令：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
说明：
- 第一条命令用于允许当前用户执行本地脚本。
- 第二条命令仅对当前 PowerShell 会话生效，适合临时安装时使用。
1.2 安装基础软件
请先安装以下软件：
- Git
- Node.js
安装完成后，执行以下命令检查是否安装成功：
node --version
npm --version
git --version
1.3 配置 npm 国内镜像源
为提升依赖下载速度，建议配置国内镜像源：
npm config set registry https://registry.npmmirror.com
如需恢复官方源，可执行：
npm config set registry https://registry.npmjs.org
1.4 配置 Git
- 配置 Git 使用 HTTPS 替代 SSH：
git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"
- 配置 GitHub 镜像站（可选）：
如果直接访问 GitHub 不稳定，可执行：
git config --global url."https://ghfast.top/https://github.com/".insteadOf "https://github.com/"
- 取消 Git 代理（可选）：
如果之前配置过 Git 代理，可执行：
git config --global --unset https.proxy
2. 安装 OpenClaw
说明：
- 原版 OpenClaw 适合直接使用官方版本的用户。
- openclaw-cn 为国内社区优化版，更适合中国大陆网络环境。
2.1 方法一：使用安装脚本
2.1.1 安装原版 OpenClaw
iwr -useb https://openclaw.ai/install.ps1 | iex
2.1.2 安装国内加速版 OpenClaw CN
如果官方脚本下载较慢，可使用国内加速安装脚本：
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
安装完成后，执行以下命令验证：
openclaw --version
2.2 方法二：使用 npm 全局安装
2.2.1 安装原版 OpenClaw
npm install -g openclaw
2.2.2 安装国内优化版 OpenClaw CN
npm install -g openclaw-cn@latest
安装完成后，执行以下命令验证：
openclaw --version
说明：
- 安装 openclaw-cn 后，通常仍使用 openclaw 作为命令名称。
- 国内用户一般优先推荐使用 openclaw-cn。
3. 初始化配置
执行以下命令进入初始化向导：
openclaw onboard
3.1 风险提示
系统会提示使用 OpenClaw 可能存在一定风险。
操作方式如下：
- 按键盘左方向键 ←
- 选择 Yes
- 按 Enter 确认继续
3.2 选择初始化模式
请选择：
QuickStart
3.3 配置 AI 模型 API Key
以智谱 AI 为例，可配置 GLM-4.7 或 GLM-4.6。
操作说明如下：
- 输入智谱 AI 的 API Key。
- API Key 可在智谱开放平台获取。
- 获取路径一般为：注册 -> 登录 -> API 密钥管理 -> 创建密钥。
3.4 配置通讯平台
当系统询问要连接哪个通讯平台时，建议先选择：
skip for now
3.5 配置 Skills
当系统询问是否启用 Skills 时，建议选择：
No
3.6 配置 Hooks
当系统询问是否启用 Hooks 时，建议选择：
skip for now
完成上述步骤后，初始化配置基本完成。
4. 安装并启动网关
OpenClaw 需要网关服务才能正常运行。
4.1 安装网关
openclaw gateway install
4.2 获取 Dashboard 访问链接
openclaw dashboard --no-open
该命令通常会输出一个带有 token 的访问链接，例如：
Dashboard URL: http://127.0.0.1:18789/#token=xxxxxxxxxxxxx
注意：
- 请保存该链接或其中的 token。
- 后续访问控制面板时可能需要使用它。
4.3 设置网关令牌（如需要）
如果系统要求手动配置 token，可执行：
openclaw config set gateway.auth.token "你的token"
4.4 启动网关
openclaw gateway start
5. 访问控制面板
执行以下命令打开控制面板：
openclaw dashboard
如果控制面板提示缺少 token，请优先使用 openclaw dashboard --no-open 输出的完整链接访问，或将 token 手动填入 Control UI 设置中。
6. 常见问题
6.1 PowerShell 提示禁止运行脚本
请先执行以下命令：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
6.2 npm 下载速度较慢
建议切换国内镜像源：
npm config set registry https://registry.npmmirror.com
6.3 控制面板无法连接网关
请检查以下内容：
- 网关是否已经启动
- 是否使用了正确的 token
- 是否使用了
openclaw dashboard --no-open输出的完整链接
6.4 Windows 环境下 pnpm build 报 bash 或 WSL 相关错误
如果系统优先调用了 WSL 的 bash.exe，可能会提示未安装 Linux 分发。此时建议确认 Git Bash 已正确加入系统环境变量，并确保以下路径优先级高于 WindowsApps：
C:\Program Files\Git\binC:\Program Files\Git\cmd
7. 使用建议
对于中国大陆用户，建议优先采用以下方案：
- 使用 openclaw-cn
- 配置 npmmirror 国内镜像源
- 使用 Git 的 HTTPS 方式拉取或安装
- 在首次使用时保留 Dashboard 输出的 token 信息，便于后续配置 Control UI
附：常用命令汇总
node --version
npm --version
git --version
npm config set registry https://registry.npmmirror.com
npm config set registry https://registry.npmjs.org
iwr -useb https://openclaw.ai/install.ps1 | iex
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
npm install -g openclaw
npm install -g openclaw-cn@latest
openclaw --version
openclaw onboard
openclaw gateway install
openclaw dashboard --no-open
openclaw config set gateway.auth.token "你的token"
openclaw gateway start
openclaw dashboard
小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用
更多推荐
6
0- 0
已为社区贡献1条内容
所有评论(0)