OpenClaw Windows 安装说明

概览

安装脚本会自动处理 Node.js、OpenClaw、Gateway 和 Dashboard 初始化。

安装 Node.js 运行时
下载并配置 OpenClaw
初始化 workspace
可选配置模型 provider
可选配置飞书机器人
启动本地 Gateway 与 Dashboard

下载 install-openclaw.ps1 下载 control-openclaw.ps1 下载 uninstall-openclaw.ps1

1. 准备一个安装目录

你可以自己选目录，不要假定用户名是 Administrator。

$destDir = Join-Path $env:USERPROFILE 'openclaw-install'
New-Item -ItemType Directory -Force -Path $destDir | Out-Null
Set-Location $destDir

也可以直接用你当前打开的目录。

2. 下载安装脚本

最少只下载安装脚本也可以：

iwr -UseBasicParsing 'https://pub-644ad95b9d504aa8a79aeb428f44c923.r2.dev/prod/windows/x64/scripts/latest/install-openclaw.ps1' -OutFile '.\install-openclaw.ps1'

如果你希望顺手把控制脚本、卸载脚本也一起下载：

iwr -UseBasicParsing 'https://pub-644ad95b9d504aa8a79aeb428f44c923.r2.dev/prod/windows/x64/scripts/latest/install-openclaw.ps1' -OutFile '.\install-openclaw.ps1'
iwr -UseBasicParsing 'https://pub-644ad95b9d504aa8a79aeb428f44c923.r2.dev/prod/windows/x64/scripts/latest/control-openclaw.ps1' -OutFile '.\control-openclaw.ps1'
iwr -UseBasicParsing 'https://pub-644ad95b9d504aa8a79aeb428f44c923.r2.dev/prod/windows/x64/scripts/latest/uninstall-openclaw.ps1' -OutFile '.\uninstall-openclaw.ps1'

3. 运行安装脚本

最简单的安装方式：

.\install-openclaw.ps1

4. 常见可选参数

4.1 走代理

.\install-openclaw.ps1 -Proxy http://127.0.0.1:7890

4.2 安装时直接写入自定义模型提供商

OpenAI 兼容接口示例：

.\install-openclaw.ps1 `
  -ProviderBaseUrl 'https://your-provider.example.com/v1' `
  -ProviderApiKey 'sk-xxx' `
  -ProviderModelId 'gpt-4.1' `
  -SkipProviderPrompt

当前安装脚本只支持 OpenAI 兼容接口。
-SkipProviderPrompt 表示不再交互提问，直接用你传入的参数。
如果你不传 provider 参数，脚本会按默认流程继续安装。

4.3 安装时直接接入 Feishu Bot

.\install-openclaw.ps1 `
  -FeishuAppId 'cli_xxx' `
  -FeishuAppSecret 'secret_xxx' `
  -SkipFeishuPrompt

这会把 channels.feishu 写进 OpenClaw 配置。
默认使用 websocket 模式，不要求你先配 webhook token / encrypt key。
默认打开 DM 直连：dmPolicy=open + allowFrom=["*"]。
默认关闭群聊触发：groupPolicy=disabled。

4.4 飞书后台最小创建步骤

登录飞书 / Lark 开发者后台。
创建一个当前租户可用的自建应用。
给应用添加机器人能力。
在应用凭证页复制 App ID 和 App Secret。
在权限配置里给机器人开通收发私聊消息所需权限。
完成应用发布 / 安装，让租户内用户能实际看到这个机器人。
安装 OpenClaw 时把 App ID / App Secret 传给脚本，或按提示手动输入。
安装完成后，直接在飞书里私聊这个 bot 做验证。

补充说明：

当前安装器走的是 websocket 模式，所以这里不要求先配置 Feishu webhook 的 Verification Token / Encrypt Key。
如果后面要开放群聊触发，不建议改安装脚本默认值，而是等安装完成后再单独改 OpenClaw 配置。
如果安装时先跳过了飞书配置，后面可以直接用控制脚本补配，不需要重装。

5. 安装后怎么控制 Gateway

如果你下载了控制脚本：

直接运行 .\control-openclaw.ps1 可以查看可用命令。

查看状态：

.\control-openclaw.ps1 status

启动：

.\control-openclaw.ps1 start

停止：

.\control-openclaw.ps1 stop

重启：

.\control-openclaw.ps1 restart

打开 Dashboard：

.\control-openclaw.ps1 dashboard

5.1 安装后补配 Feishu

交互式补配：

.\control-openclaw.ps1 configure-feishu

直接带参数补配：

.\control-openclaw.ps1 configure-feishu -FeishuAppId 'cli_xxx' -FeishuAppSecret 'secret_xxx'

这会把 channels.feishu 写进当前 OpenClaw 配置。
仍然使用 websocket 模式。
写入后脚本会自动重启 Gateway。
这一步不要求你重新跑安装脚本。

5.2 安装后切换 Provider / Model

交互式切换：

.\control-openclaw.ps1 configure-provider

直接带参数切换：

.\control-openclaw.ps1 configure-provider -ProviderBaseUrl 'https://your-provider.example.com/v1' -ProviderApiKey 'sk-xxx'

指定模型：

.\control-openclaw.ps1 configure-provider -ProviderBaseUrl 'https://your-provider.example.com/v1' -ProviderApiKey 'sk-xxx' -ProviderModelId 'gpt-4.1-mini'

这会写入 models.providers.*、agents.defaults.model.primary 和 agents.defaults.models[...]。
如果没传 ProviderModelId，脚本会尝试从 <baseUrl>/models 自动选一个模型。
写入后脚本会自动重启 Gateway。
如果你只是想换默认模型 / URL / key，不需要重装。

6. Dashboard 注意事项

不要手动打开裸地址：http://127.0.0.1:18789

应该使用脚本或命令生成的 tokenized dashboard URL。

如果需要手动取地址：

openclaw dashboard --no-open

7. 卸载

如果你下载了卸载脚本：

.\uninstall-openclaw.ps1

8. 默认运行时下载地址

Node.js MSI：

https://pub-644ad95b9d504aa8a79aeb428f44c923.r2.dev/prod/windows/x64/runtime/node/node-lts-x64.msi

OpenClaw 包：

https://pub-644ad95b9d504aa8a79aeb428f44c923.r2.dev/prod/windows/x64/runtime/openclaw/openclaw-latest.tgz

9. 已知说明

避免安装过程再走 openclaw onboard
改为 openclaw setup --workspace ... + openclaw config set --batch-file ...
前置处理 document-extract / pdfjs-dist
Dashboard 改成优先等待 tokenized URL 就绪后再打开

如果安装时仍然遇到问题，建议保留安装输出和日志，尤其是最后 50~100 行。