使用 Homebrew 安装（最简单）

目前最常见的 OpenClaw 主要用于以下启动器：

1. Alfred（macOS）：这是最主流的版本。
2. PowerToys Run（Windows）：微软官方工具集的一部分。
3. Wox（Windows）：另一个流行的开源启动器。

下面我将分别介绍这三种平台的安装方法。

---

在 Alfred（macOS）上安装 OpenClaw 技能插件

这是最成熟的使用方式，OpenClaw 以 Alfred Workflow 的形式存在。

安装前提

1. 确保已安装 Alfred 5（推荐）或 Alfred 4，并且已购买 Powerpack 许可（免费版无法使用 Workflow）。
2. 确保 macOS 上已安装 Python 3（通常系统自带，但建议通过 Homebrew 安装最新版）。

安装步骤

方法 A：通过文件安装（推荐，稳定）

1. 下载插件：前往 OpenClaw 的官方 GitHub 发布页面下载最新的 .alfredworkflow 文件。

   • 开源地址：https://github.com/wong2/openclaw
   • 在 Releases 页面找到并下载最新版本的 .alfredworkflow 文件。

2. 双击安装：下载完成后，双击 OpenClaw.alfredworkflow 文件，Alfred 会自动弹出导入窗口。

3. 配置安装：

   • 在导入窗口中，Alfred 会提示你选择插件的安装位置和权限,通常保持默认即可。
   • 点击 Import 按钮。
   • 首次使用时，Alfred 可能会提示“Workflow 包含需要运行命令行脚本的操作”，请选择 Allow 或 始终允许。

4. 使用：激活 Alfred（默认为 Option + Space），输入 oc + 空格，即可进入 OpenClaw 模式，然后输入技能关键字（如 gh Alfred 搜索 GitHub 上关于 Alfred 的项目）。

方法 B：通过命令行安装（适合开发者）

# 或者使用 npm 安装
npm install -g alfred-openclaw
# 安装后，在 Alfred 中搜索 `openclaw` 进行配置。

安装技能（插件）

OpenClaw 本身自带了一些基础技能（如 g 谷歌搜索、gh GitHub 搜索等）,社区有更多技能插件：

1. 查找技能：技能通常是独立的 Python 脚本，你可以在 OpenClaw 的 GitHub Wiki 或社区论坛中找到。
2. 安装技能：
   • 找到你想要的技能文件（通常是一个 .py 文件）。
   • 将其复制到 OpenClaw 的技能目录中，目录路径通常为： ~/Library/Application Support/Alfred/Workflow Data/com.wong2.openclaw/scripts/
   • 或者，在 Alfred 中进入 OpenClaw Workflow 的配置，找到 Skills 环境变量指定的目录。
3. 刷新技能列表：安装后，在 Alfred 中输入 oc reload 命令来重新加载技能。

---

在 PowerToys Run（Windows）上安装

OpenClaw 作为 PowerToys Run 的一个插件集成。

安装前提

1. 从 Microsoft Store 或 GitHub 安装最新版 PowerToys。
2. 确保已启用 PowerToys Run 模块。

安装步骤

1. 获取插件：OpenClaw for PowerToys 通常是一个 DLL 文件,你需要从其发布页面下载。

   • 相关项目地址：https://github.com/bcxx/PT-OpenClaw（这是社区移植版，请以最新项目为准）。

2. 安装插件：

   • 打开 PowerToys 设置 -> PowerToys Run -> 插件。
   • 点击 添加插件 或 打开插件目录。
   • 将下载的 .dll 文件复制到弹出的插件目录中。
   • 回到 PowerToys Run 设置，在插件列表中找到 “OpenClaw” 并确保其已启用。

3. 配置与使用：

   • 你通常需要配置一个激活关键字，oc。
   • 激活 PowerToys Run（默认 Alt + Space），输入你的激活关键字（如 oc），然后按空格，即可开始使用 OpenClaw 技能。

---

在 Wox（Windows）上安装

这是 OpenClaw 的原始版本之一。

安装前提

1. 安装 Wox 和 Everything（用于本地文件搜索，Wox 依赖它）。
2. 确保已安装 Python 3，并将其添加到系统环境变量 PATH 中。

安装步骤

1. 下载插件：从 OpenClaw 的 GitHub 页面下载 Wox 插件包，通常是一个包含 plugin.json 和 .py 文件的文件夹。

2. 安装插件：

   • 打开 Wox，输入 wpm install OpenClaw（Wox 插件市场支持）。
   • 或者，手动安装：将下载的插件文件夹复制到 Wox 的插件目录： %APPDATA%\Wox\Plugins\
   • 重启 Wox。

3. 使用：在 Wox 中（默认 Alt + Space）输入 oc + 空格,即可使用。

---

通用提示与故障排除

1. Python 环境问题（macOS/Windows 通用）：这是最常见的问题,请确保：

   • Python 3 已正确安装，在终端输入 python3 --version 检查。
   • 必要时，在 OpenClaw/Alfred 的 Workflow 环境变量中，将 python_bin 设置为你的 Python 3 可执行文件的具体路径（/usr/local/bin/python3）。

2. 网络问题：许多技能需要访问网络 API（如谷歌、GitHub），请检查网络连接,特别是如果使用了代理。

3. 权限问题：首次运行时，系统可能会阻止插件运行，请在系统偏好设置（macOS）的“安全性与隐私”中，或在 Alfred 的提示中,允许其运行。

4. 更新插件：定期检查 GitHub 发布页面,获取新版本以修复错误和增加新功能。

5. 技能开发：如果你想创建自己的技能，请参考 OpenClaw 项目中的 skill.py 模板和现有技能示例。

对于大多数用户，如果你在 macOS 上使用 Alfred，请直接下载 .alfredworkflow 文件双击安装，在 Windows 上，根据你使用的启动器（PowerToys Run 或 Wox），找到对应的社区移植版本进行安装。

标签： Homebrew 软件安装