年Windows部署OpenClaw推荐榜单

2026-06-17阅读 0热度 0

OpenClaw

在 Windows 环境部署 OpenClaw 有多种方式，包括 Docker 容器、WSL + Linux 子系统，以及原生 Windows 安装。本文聚焦于原生 Windows 路径，提供详细步骤。

一、系统要求

Windows 10 / 11（64 位系统）
Node.js 22 或更高版本
PowerShell 5.1 以上（Windows 10/11 默认预装）

二、软件安装

2.1 安装

以管理员身份启动 Windows 终端——权限不足会导致后续操作失败，务必先提权。

全局安装 OpenClaw 最新稳定版：

npm install -g openclaw@latest

安装完成后验证版本，确认组件就绪：

openclaw –version

2.2 设置权限

Windows 默认限制脚本执行，需手动调整策略。先查询当前执行策略：

Get-ExecutionPolicy

若返回 Restricted，则允许当前用户执行本地脚本：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

三、配置

3.1 Token 配置

生成随机认证 Token 并写入配置。直接复制粘贴以下命令即可：

$token = "openclaw-gateway-$(Get-Random -Minimum 100000 -Maximum 999999)"
openclaw config set gateway.auth.token $token
openclaw config set gateway.port 18789

配置文件位于 C:\Users\<用户名>\.openclaw\openclaw.json，后续所有修改均基于此文件。

3.2 启动测试

将生成的 Token 设为环境变量，然后启动网关：

$env:OPENCLAW_GATEWAY_TOKEN="前一个步骤生成的TOKEN"
openclaw gateway --port 18789 --verbose --allow-unconfigured

启动成功后，浏览器访问以下地址（或执行 openclaw dashboard --no-open 也可获取相同 URL）：

http://127.0.0.1:18789/#token=openclaw-gateway-504467

3.3 更换大模型提供者

切换大模型引擎有两种途径。方法一：直接编辑 openclaw.json 配置文件（通过 openclaw config 命令），修改后先用 openclaw gateway stop 停止网关，再重新启动。执行 openclaw models status 可确认当前模型是否生效。

方法二：使用交互式命令行，操作更直观：

openclaw onboard

列出所有可用模型：

openclaw models list

四、增加钉钉渠道

4.1 钉钉开发者后台配置

登录钉钉开放平台（https://open-dev.dingtalk.com/），选择具备管理员权限的组织。创建新应用，随后在应用内添加机器人能力。

创建新版本并发布，此步骤不可跳过。

配置必要的权限范围，然后复制应用的凭证信息（Client ID、Client Secret 等基础字段）。

4.2 安装配置 openclaw-channel-dingtalk 插件

从 GitHub 克隆插件源码：

git clone https://github.com/soimy/openclaw-channel-dingtalk.git
cd openclaw-channel-dingtalk
npm install
openclaw plugins install -l .

安装后使用 openclaw plugins list 确认插件已载入。

编辑 openclaw.json，在 channels 段落添加钉钉配置，填入开发者后台获取的参数：

"dingtalk": {
  "enabled": true,
  "clientId": "dingsmnhfu0y6ycz00bk",
  "clientSecret": "XXXX",
  "robotCode": "dingsmnhfu0y6ycz00bk",
  "corpId": "XXX",
  "agentId": "XXX",
  "groupPolicy": "open",
  "messageType": "markdown",
  "debug": false
}

OpenClaw 控制台界面同样展示这些配置项。

4.3 钉钉测试

在钉钉内搜索已发布的机器人应用，发送一条测试消息。OpenClaw 后台会记录交互日志，表明连接正常。

五、增加飞书渠道

在 Windows 下通过源码部署飞书渠道：

git clone https://github.com/m1heng/clawdbot-feishu.git .
npm init -y
npm install @larksuiteoapi/node-sdk
openclaw plugins enable feishu

通过 Web UI 或执行 openclaw plugins list 验证插件已启用。

发布最新的机器人应用后，在 openclaw.json 的 channels 段添加飞书配置：

"channels": {
  "feishu": {
    "enabled": true,
    "appId": "cli_XXX",
    "appSecret": "XXXX",
    "domain": "feishu",
    "groupPolicy": "allowlist",
    "groupAllowFrom": ["oc_mygroup"]
  }
}

根据 OpenClaw 后台的提示，点击超链接进入飞书开发者后台完成权限配置。

保存后，在飞书左上角搜索框中搜索发布的机器人应用。首次交互时会提示“未配置”，此时需在 OpenClaw 控制台手动执行配对：

openclaw pairing approve feishu NEPJVMUG

配对成功后，再次发送消息即可获得正常回复。

若遇到类似 [tools] browser failed: Error: Chrome extension relay is running, but no tab is connected. 的错误，通常是浏览器插件或 relay 连接异常，检查相关依赖是否完整即可。