← 返回主页

🦞 OpenClaw Windows 安装指南

Windows 7 / Windows 11 · Personal AI Assistant · ⭐ 381k+ GitHub Stars
📋 目录
  1. 下载安装包
  2. 安装步骤（Win7 & Win11）
  3. 首次运行与配置
  4. 接入消息平台
  5. 升级
  6. 卸载
  7. 常见问题

📥 下载安装包

OpenClaw 为 Windows 提供了官方 GUI 安装程序（Companion），装好后后台 Gateway 会自动运行。当前最新版本：v2026.6.10

版本 适用系统 下载 大小
x64（标准版） Windows 11 / 10 / 7 SP1（64位） OpenClawCompanion-Setup-x64.exe 179 MB
arm64（ARM版） Surface Pro X 等 ARM Windows OpenClawCompanion-Setup-arm64.exe 162 MB
🔍 SHA256 校验：下载后可以用 PowerShell 验证文件完整性。
Get-FileHash .\OpenClawCompanion-Setup-x64.exe
# 对比 https://github.com/openclaw/openclaw/releases/tag/v2026.6.10 # 下方的 OpenClawCompanion-SHA256SUMS.txt
⚠️ Win7 注意：Windows 7 SP1 需要先安装：
  • KB3063858 — SHA-2 代码签名更新
  • .NET Framework 4.8（如未安装）
  • Node.js 24 不支持 Win7，但 OpenClaw Companion 自带了运行时，无需额外装 Node

⚙️ 安装步骤

1

双击运行安装包

右键 OpenClawCompanion-Setup-x64.exe → 以管理员身份运行（推荐）。

2

选择安装目录

默认路径：C:\Program Files\OpenClawCompanion。也可以点 Browse 改到 D 盘或你想要的目录。

3

等待安装完成

安装过程约 1-2 分钟。安装结束后勾选 「Run OpenClaw Companion」，点 Finish。

4

检查系统托盘

安装完成后 OpenClaw 图标会出现在 系统托盘（右下角任务栏通知区域）—— 一只 🦞小龙虾图标。

💡 在系统托盘图标上右键可以：启动/停止 Gateway、打开 WebChat、查看日志、退出 Companion。
5

验证安装

打开命令提示符或 PowerShell，运行：

openclaw --version # 显示版本号 openclaw gateway status # 显示 Gateway 运行状态
🔗 也可以打开浏览器访问 http://localhost:18789 查看 Gateway Web 控制台。

🎯 首次运行配置

安装完成后，在系统托盘图标上右键 → 「Open WebChat」，浏览器会打开配置向导。或者你也可以用命令行配置：

方式一：GUI 配置（推荐）

  1. 右键托盘 🦞 → 「Open WebChat」
  2. 按照页面提示选择 AI 模型（需要你有 OpenAI / Anthropic / 其他提供商的 API Key）
  3. 配置消息渠道（下面第4节有详细说明）
  4. 选择 Skills

方式二：命令行配置

# 打开 PowerShell / CMD，运行： openclaw onboard # 交互式向导，按提示操作即可 # 完成后 Gateway 会自动重启

最小配置文件

onboard 会在 %USERPROFILE%\.openclaw\openclaw.json 生成配置：

{ "agent": { "model": "openai/gpt-4o" // 换成你的模型 } }
💡 配置文件位置：C:\Users\你的用户名\.openclaw\openclaw.json

📱 接入消息平台

OpenClaw 支持 20+ 消息平台。以下列出 Windows 上常用的：

Telegram

  1. 在 Telegram 中找 @BotFather，发 /newbot 创建 Bot，获得 Token
  2. 在系统托盘右键 → 「Settings」 → Channels → 添加 Telegram
  3. 填入 Token，保存后 Gateway 自动重启

Discord

  1. 在 Discord Developer Portal 创建应用，生成 Bot Token
  2. 在 Settings → Channels → Discord 中填入 Token
  3. 用生成的邀请链接把 Bot 拉进你的服务器

微信 / QQ

微信需要 iLink 个人号桥接，QQ 用 QQ Bot API（q.qq.com）。这两者需要额外配置，详见官方渠道文档。

🌐 其他支持平台：WhatsApp、Slack、Google Chat、Signal、iMessage、IRC、Teams、飞书、LINE、Mattermost、Nostr、Twitch、Zalo 等。

🔄 升级

自动更新

系统托盘右键 → 「Check for Updates」 → 如果发现新版本会提示下载。

手动下载安装包

去 GitHub Releases 页 下载最新的 OpenClawCompanion-Setup-x64.exe，直接覆盖安装即可。

npm 方式升级（如果你也装了 Node.js）

npm update -g openclaw@latest

🗑️ 卸载

两种方式：

卸载后如果需要彻底清除配置数据，手动删除：

# 删除用户配置（如果不需要保留） rmdir /s /q %USERPROFILE%\\.openclaw # 删除缓存 rmdir /s /q %APPDATA%\\OpenClaw

❓ 常见问题

Win7 下运行报错"无法启动此程序"？

确保已安装 KB3063858（SHA-2 更新）和 .NET Framework 4.8。如果还不行，右键 exe → 属性 → 兼容性 → 勾选「以 Windows 7 兼容模式运行」。

下载很慢怎么办？

安装包 179MB，GitHub Release 在中国大陆下载可能会慢。可以用 IDM 或多试几次。

提示"Windows 已保护你的电脑"（SmartScreen）？

点击 「更多信息」→「仍要运行」 即可。OpenClaw 是 GitHub 上 38 万 Star 的开源项目，安全无毒。

需要 Node.js 吗？

Companion 安装包自带运行时，无需提前装 Node.js。如果你是开发者想用 CLI 模式，可以在装完 Companion 后再装 Node.js 24+。

需要付费吗？

OpenClaw 本身是 MIT 协议的开源项目，免费。但用的 AI 模型（GPT-4o、Claude 等）需要你自己有 API Key。

更多帮助