OpenClaw 安装与配置教程（Windows）

type

Post

status

Published

date

Mar 9, 2026

slug

openclaw-guide-for-windows

summary

本文介绍在 Windows 10/11 上安装 OpenClaw：以管理员 PowerShell 放开脚本权限并运行安装命令，完成 TUI 初始化后启动 Dashboard，在 Web UI 的 RAW 配置中粘贴并修改 DashScope Provider（API Key 等），保存并 Update 生效，并附常见故障排查。

适用范围

操作系统：Windows 10/11

目标：安装 OpenClaw，并通过 Web UI 配置一个自定义模型 Provider（示例：百炼 DashScope 兼容 OpenAI Completions 接口）

准备工作

准备 API Key

你需要一个可用的 API Key。

后续会把它填到配置中的 apiKey 字段（把 YOUR_API_KEY 替换为真实值）。

确保 PowerShell 可用

建议使用 Windows 自带 PowerShell。

需要以管理员身份运行，避免权限问题。

第 1 步：以管理员身份打开 PowerShell

在开始菜单搜索 PowerShell

右键选择 以管理员身份运行

第 2 步：允许执行脚本

在 PowerShell 中执行：

说明：这会允许当前用户运行本地脚本与签名脚本。如果你对策略不熟悉，建议执行完成后记录原值，必要时再改回去。

第 3 步：运行 OpenClaw 安装脚本

执行安装命令：

如果网络环境访问受限，可考虑使用代理或更换网络后再试。

如果安装过程报错，优先复制完整错误信息排查。

第 4 步：完成初始化向导（TUI）

安装完成后通常会进入初始化配置流程。下面是推荐选择（并补充了说明）：

配置项	推荐选择
I understand this is powerful and inherently risky. Continue?	选择 Yes（确认理解风险后继续）
Onboarding mode	选择 QuickStart（先跑通流程）
Model/auth provider	选择 Skip for now（后续在 Web UI 配置）
Filter models by provider	选择 All providers
Default model	保持默认
Select channel (QuickStart)	选择 Skip for now（后续可配）
Configure skills now? (recommended)	选择 No（先跑通，再逐步加技能）
Enable hooks?	按空格选中 Skip for now，回车进入下一步
How do you want to hatch your bot?	选择 Hatch in TUI

第 5 步：启动 Web UI（Dashboard）

在 PowerShell 或终端执行：

然后在浏览器打开：

http://127.0.0.1:18789

如果打不开：

确认命令是否在运行（不要关闭终端窗口）。

检查本机安全软件或防火墙是否拦截了端口访问。

第 6 步：在 Web UI 中打开 RAW 配置

在左侧菜单进入：

配置 > All Settings > RAW

在 Raw JSONS 输入框中：

全选当前内容

粘贴下方配置（会覆盖原内容）

第 7 步：粘贴配置并修改 API Key

把下面 JSON 中的 YOUR_API_KEY 替换为你的真实 Key：

说明：从 OpenClaw 3.2 版本开始，如果要开启全量功能，需要额外把 tools.profile 设置为 full（在 RAW 配置里添加或修改该字段）。另外，为了让不同 agents 之间可以互相通信，还需要补充 sessions.visibility 为 all。