OpenClaw Easy 是 OpenClaw 的桌面版一键安装包，专为非技术用户设计。原版 OpenClaw 需要 Node.js、命令行、手动配置 — 对于不熟悉终端的用户门槛较高。OpenClaw Easy 把这些步骤打包成一个签名的桌面应用，5 分钟内即可在 macOS 或 Windows 上运行完整的 OpenClaw AI 助手，并接入 WhatsApp、Telegram、Slack、Discord、飞书、Line 等聊天通道。

本教程包含完整的 macOS 和 Windows 安装步骤、系统要求、常见问题，以及中国大陆用户的注意事项。

OpenClaw Easy 的特点

  • 零配置 — 无需 Node.js、无需 WSL2、无需手动编辑配置文件
  • 一键安装 — macOS 拖动到 Applications，Windows 双击 .exe 安装
  • 图形界面 — 所有功能可视化操作，告别命令行
  • 多通道支持 — WhatsApp、Telegram、Slack、Discord、飞书、Line 全部内置
  • 多模型支持 — Claude（Anthropic）、ChatGPT（OpenAI）、Gemini（Google）、DeepSeek，以及本地 Ollama 模型
  • 本地运行 — 你的 API 密钥、对话历史、配置信息全部保存在本机
  • 开源免费 — Apache-2.0 协议，源代码在 GitHub 公开

系统要求

  • macOS：macOS 12 (Monterey) 或更高版本。支持 Apple Silicon（M1/M2/M3/M4）和 Intel 双架构
  • Windows：Windows 10 或 Windows 11，64-bit
  • 内存：至少 8GB；如需运行本地 Ollama 大模型，推荐 16GB 或更高
  • 硬盘：1GB 可用空间（仅安装包）；本地大模型另需 4–20GB
  • 网络：使用云端 AI 提供商需要互联网；使用本地 Ollama 完全离线

macOS 安装步骤

1 下载 .dmg 安装包

访问 openclaw-easy.com 下载页面，根据 Mac 芯片选择安装包：

  • Apple Silicon（M1 / M2 / M3 / M4 芯片）— 下载 OpenclawEasy-arm64.dmg
  • Intel Mac — 下载 OpenclawEasy-x64.dmg

不确定 Mac 类型？点击屏幕左上角 Apple 图标 → 关于本机。芯片一栏会显示 "Apple M1 / M2 / M3 / M4" 或 "Intel"。

2 拖到 Applications

双击下载的 .dmg 文件，会弹出一个安装窗口。将 Openclaw Easy 图标拖动到旁边的 Applications 文件夹。

关闭窗口，弹出（推出）已挂载的 .dmg 镜像。

3 首次启动

打开 Launchpad 或 Finder → Applications，双击 Openclaw Easy。

如果 macOS Gatekeeper 弹出 "无法验证开发者" 警告：

  1. 前往 系统设置 → 隐私与安全性
  2. 向下滚动找到 "Openclaw Easy 已被阻止"
  3. 点击 "仍要打开"

OpenClaw Easy 是经过 Apple 公证（notarized）的签名应用，只是因为下载量还在积累，初次启动 Gatekeeper 会保守提示。

4 完成配置向导

桌面应用启动后会引导你完成三步配置：

  • 选择 AI 提供商 — Claude、ChatGPT、Gemini、DeepSeek，或本地 Ollama
  • 粘贴 API 密钥（云端模型）或选择本地模型（Ollama）
  • 连接聊天通道（可选）— WhatsApp 扫码、Telegram 粘贴 BotFather 令牌等

5 验证安装

点击侧边栏的 Chat，发送一条测试消息（例如 "你好"）。如果 AI 正常回复，说明安装完成。

Windows 安装步骤

1 下载 .exe 安装包

从 openclaw-easy.com 下载页面 下载 OpenclawEasy-Setup.exe。安装包约 80MB，已用 SignTool 数字签名。

2 运行安装程序

双击下载的 .exe。如果 Windows SmartScreen 弹出 "Windows 已保护你的电脑" 警告：

  1. 点击 "更多信息"
  2. 点击 "仍要运行"

这是因为 OpenClaw Easy 的下载量还未达到 SmartScreen 的信誉阈值。应用是签名的合法软件。

3 选择安装路径

默认安装到当前用户目录（C:\Users\<你的用户名>\AppData\Local\Programs\Openclaw Easy），不需要管理员权限。点击 "安装"，约 30 秒完成。

4 启动应用

安装完成后从开始菜单或桌面快捷方式启动 Openclaw Easy。

5 完成配置向导

与 macOS 相同 — 选择 AI 提供商、粘贴 API 密钥、连接通道，然后在 Chat 发送测试消息验证。

下一步配置

安装完成后，常见的配置场景包括：

  • 连接飞书 AI 机器人 — 在 OpenClaw Easy 的 Channels 标签选择飞书，按提示配置应用凭证
  • 连接 WhatsApp AI 机器人 — Channels → WhatsApp，用手机 WhatsApp 扫描二维码即可
  • 连接 Telegram 机器人 — 从 BotFather 获取 token，粘贴到 OpenClaw Easy
  • 使用本地 Ollama 大模型 — 安装 Ollama，运行 ollama pull llama3.2 或 qwen2.5，在 OpenClaw Easy 选择本地 LLM 提供商并指向 http://localhost:11434

常见问题（FAQ）

OpenClaw Easy 是什么？跟原版 OpenClaw 什么区别？

OpenClaw Easy 是 OpenClaw 的桌面版安装包。原版 OpenClaw 需要 Node.js、npm 和命令行配置 — 适合开发者。OpenClaw Easy 把这些打包成一键安装的桌面应用，附带图形化的 Control UI 和配置向导，适合非技术用户。底层运行的是同一个 OpenClaw 网关。

OpenClaw Easy 免费吗？

桌面应用本身完全免费，源代码以 Apache-2.0 协议开源。AI 调用的费用取决于使用的提供商：使用自己的 API 密钥（Claude / ChatGPT / Gemini）按提供商的标准计费；使用本地 Ollama 模型零费用。

中国大陆可以使用 OpenClaw Easy 吗？

桌面应用本身可以正常下载和运行。访问 Claude / ChatGPT / Gemini 等海外 API 时，网络层面可能需要额外配置。如果选择本地 Ollama 部署（Llama 3、Qwen 2.5、DeepSeek 等），则完全无需访问外网，所有推理在本机完成。

需要管理员权限吗？

macOS 不需要 — 直接拖到 Applications 即可。Windows 默认安装到当前用户目录，也不需要管理员权限。

如何卸载？

  • macOS：将 Applications 中的 Openclaw Easy 拖到废纸篓即可。配置文件位于 ~/.openclaw/，如果想完全清理可一并删除
  • Windows：设置 → 应用 → Openclaw Easy → 卸载。配置文件位于 %USERPROFILE%\.openclaw\

支持 Linux 吗？

目前 OpenClaw Easy 桌面版支持 macOS 和 Windows。Linux 用户建议直接使用原版 OpenClaw（npm install -g @openclaw/openclaw），命令行配置更原生。

如何更新到新版本？

OpenClaw Easy 内置自动更新机制 — 启动时会检查新版本并提示。也可以手动从下载页面获取最新版本，安装时直接覆盖旧版本即可。

提示：遇到 "openclaw gateway connect failed: error: pairing required" 错误？这是网关首次启动时需要的设备授权，详见 OpenClaw Gateway pairing required 错误修复。

相关资源