windows下安装openclaw
运行代码" iwr -useb https://openclaw.ai/install.ps1 | iex" 知道安装成功。当然还可以通过openclaw相关命令对其进行模型的配置,以及相关app启动工具套件的配置,请自行查阅相关资料。使用 openclaw gateway install 打开浏览器访问模式。如果有这两张图中的情形,openclaw算是安装成功了。1.打开powershell (
·
1.打开powershell (使用管理员打开)
运行代码" iwr -useb https://openclaw.ai/install.ps1 | iex" 知道安装成功
使用 openclaw -v检查是否安装成功
使用 openclaw gateway install 打开浏览器访问模式

如果有这两张图中的情形,openclaw算是安装成功了。
当然还可以通过openclaw相关命令对其进行模型的配置,以及相关app启动工具套件的配置,请自行查阅相关资料。
OpenClaw 与本地应用连接,核心是通过 Gateway(网关)+ Node(节点) 架构,用 WebSocket/MCP/命令行/插件 四种方式打通通信,让 AI 控制本地软件。下面按场景给你最实用的连接方案。
一、核心架构(必看)
- Gateway(网关):运行在本地电脑(Windows/macOS/Linux),负责消息路由、节点管理、AI 调度,默认端口 18789。
- Node(节点):本地应用/设备/脚本,通过 WebSocket/MCP/命令行 连接 Gateway,执行本地操作。
- 通信协议:
- WebSocket:远程/跨设备连接(默认
ws://localhost:18789)。 - MCP(Model Control Protocol):本地直连(低延迟,适合开发)。
- 命令行/Shell:直接执行本地应用(最通用)。
- WebSocket:远程/跨设备连接(默认
二、方式1:本地应用直连 Gateway(WebSocket,最通用)
1. 启动 OpenClaw Gateway(Windows)
# 安装(已安装可跳过)
npm install -g openclaw-cn
# 启动网关(默认端口18789)
openclaw-cn gateway
# 查看网关状态
openclaw-cn gateway status
2. 本地应用连接 Gateway(WebSocket 示例)
以 Node.js 脚本/本地客户端 为例:
const WebSocket = require('ws');
const ws = new WebSocket('ws://localhost:18789');
// 连接成功
ws.on('open', () => {
console.log('已连接 OpenClaw Gateway');
// 发送配对请求
ws.send(JSON.stringify({
type: 'pairing',
nodeId: 'my-local-app-001',
name: '本地控制应用'
}));
});
// 接收指令(控制本地应用)
ws.on('message', (data) => {
const msg = JSON.parse(data);
if (msg.type === 'command') {
// 执行本地操作:打开软件、执行脚本、控制硬件
if (msg.payload === 'open-vscode') {
require('child_process').exec('code'); // Windows/macOS 打开 VS Code
}
}
});
3. 批准配对(Gateway 终端)
# 查看待配对节点
openclaw-cn nodes pending
# 批准配对(替换 <nodeId>)
openclaw-cn nodes approve <nodeId>
三、方式2:MCP 直连(本地开发,低延迟)
适合 本地 IDE/编辑器/桌面应用(如 VS Code、Unity、Cursor),无需公网,延迟最低。
1. 启用 MCP Bridge(Gateway)
openclaw-cn gateway --mcp
2. 本地应用连接 MCP(默认 tcp://localhost:18790)
- Unity:安装
openclaw-unity-plugin,菜单Window > OpenClaw > Start MCP Bridge。 - VS Code:安装 OpenClaw 插件,配置 MCP 地址
localhost:18790。 - 自定义应用:用 MCP 客户端库连接,直接接收 AI 指令。
四、方式3:命令行/Shell 控制(最直接,无需编码)
OpenClaw 可直接生成 PowerShell/Bash 命令,控制本地应用。
1. 启用命令行能力
# 安装命令行插件
openclaw-cn plugins enable shell
# 重启网关
openclaw-cn gateway restart
2. 控制本地应用(示例)
- 打开软件:
open -a "Google Chrome"(macOS)、start chrome(Windows)。 - 执行脚本:
node script.js、python app.py。 - 文件操作:
mkdir project、copy file.txt D:\backup。
五、方式4:接入 IM 平台(飞书/钉钉/微信,远程控制本地)
通过 IM 机器人发消息,让 OpenClaw 控制本地应用(最常用)。
以飞书为例(Windows 完整步骤)
- 飞书开放平台创建应用
- 访问 https://open.feishu.cn/app,创建自定义应用。
- 复制 App ID 和 App Secret。
- 配置事件订阅:选择 WebSocket 长连接,添加
im.message.receive_v1。
- OpenClaw 配置飞书渠道
# 安装飞书插件 openclaw-cn plugins enable feishu # 添加飞书渠道 openclaw-cn channels add --channel feishu # 输入 App ID、App Secret,完成配置 - 启动网关并配对
openclaw-cn gateway # 批准飞书配对(替换 <配对码>) openclaw-cn pairing approve feishu <配对码> - 测试:在飞书给机器人发消息(如“打开 VS Code”),本地应用自动启动。
六、Windows 常见问题与排查
- 端口被占用:修改 Gateway 端口
openclaw-cn gateway --port 18790 - 防火墙拦截:放行 18789(WebSocket)、18790(MCP) 端口。
- 权限不足:以管理员身份运行终端,或给 OpenClaw 授权“辅助功能/自动化”。
- 连接失败:
- 检查 Gateway 是否运行:
openclaw-cn gateway status。 - 确认地址:
ws://localhost:18789。 - 查看日志:
openclaw-cn logs。
- 检查 Gateway 是否运行:
七、快速选择方案
- 本地开发/IDE 集成 → MCP 直连(低延迟)。
- 远程控制/跨设备 → WebSocket + IM 机器人(飞书/钉钉)。
- 简单脚本/命令行 → Shell 插件(无需编码)。
- 自定义应用 → WebSocket 客户端(灵活扩展)。
更多推荐

所有评论(0)