OpenClaw 伴侣 App 完整指南：macOS 菜单栏 AI 助手一键呼出
文章概述：OpenClaw 官方发布了 macOS 原生伴侣应用（Companion App，Beta 版），它将 AI 助手以小龙虾图标的形式放在 macOS 菜单栏，支持全局热键（⌘⇧Space）随时呼出悬浮面板。本文是目前最完整的中文安装配置指南，从下载安装到高级自定义全部覆盖。注意：Companion App 需要配合 OpenClaw CLI 一起使用，并非独立产品。
Companion App 是什么？和 CLI 有什么区别
很多 Mac 用户使用 OpenClaw 的方式是这样的：打开终端，运行 openclaw start，然后打开 Telegram 发消息。虽然功能完整，但切换上下文很繁琐。
Companion App（伴侣应用）解决了这个问题。它是一个原生 macOS 应用，安装后会在菜单栏出现一个🦞（小龙虾）图标。你按下全局热键（默认 ⌘⇧Space），无论当前在做什么——写代码、看视频、浏览网页——都能立刻呼出一个悬浮聊天面板，与 AI 助理对话，任务结束后面板消失，完全不打断工作流。
| 工具 | 使用场景 | 是否必须 |
|---|---|---|
| OpenClaw CLI | 安装、配置、启动服务 | 必须安装 |
| Companion App | 菜单栏快速访问、状态监控 | 推荐安装 |
| Web 控制台 | 完整技能管理、日志查看 | 按需使用 |
前置条件：先确保 OpenClaw CLI 已安装并运行
Companion App 是 OpenClaw CLI 的图形界面前端，必须先安装并配置好 OpenClaw CLI，Companion App 才能连接到你的 AI 助理。如果你还没有安装 CLI，请先按以下步骤完成：
# 方法一：官方一键安装脚本（推荐）
curl -fsSL https://openclaw.ai/install.sh | bash
# 方法二：Homebrew 安装
brew install openclaw
# 方法三：npm 安装
npm i -g openclaw
# 完成后运行配置向导
openclaw onboard
# 启动 OpenClaw 服务
openclaw start
验证 CLI 已正常运行
运行 openclaw status，如果显示 ● running 或 gateway: online，说明 CLI 已就绪，可以安装 Companion App 了。
下载并安装 OpenClaw Companion App
Companion App 目前处于 Beta 阶段，通过 GitHub Releases 页面发布。下载和安装步骤如下：
访问 GitHub Releases 下载最新版
在浏览器访问 github.com/openclaw/openclaw/releases/latest，在 Assets 列表中找到 OpenClaw-macOS-arm64.dmg（Apple Silicon）或 OpenClaw-macOS-x64.dmg（Intel Mac）并下载。
# 或者通过命令行直接下载（Apple Silicon）
openclaw app install
# 等效于从 GitHub 下载最新 Companion App
安装 dmg 文件
双击下载的 .dmg 文件，将 OpenClaw 图标拖拽到 Applications（应用程序）文件夹。这与安装任何 macOS 应用的方式完全相同。
处理"无法验证开发者"提示
由于 Companion App 是 Beta 版，可能尚未完成 Apple 公证。首次打开时会弹出"无法验证开发者"提示，处理方法：
# 方法一：右键点击 App 图标 → 打开 → 点击"打开"按钮
# 方法二：在终端中移除隔离属性
xattr -cr /Applications/OpenClaw.app
设置登录时自动启动
打开 App 后，在菜单栏🦞图标的设置中勾选"Login Item（登录时启动）"，这样每次 Mac 开机后 Companion App 都会自动出现在菜单栏。
Companion App 核心功能详解
安装完成后，让我们来了解 Companion App 的每一项核心功能：
全局热键呼出（默认 ⌘⇧Space）
无论你在任何应用中工作，按下 ⌘⇧Space 即可在屏幕中央唤出一个悬浮聊天面板，输入指令后按 Enter 发送，AI 即时响应。任务完成后按 Esc 或再次按热键关闭面板，完全不打断工作流。
热键可在 App 设置中自定义，支持更改为你习惯的组合键。
实时状态面板
点击菜单栏的🦞图标，下方面板会显示：AI 助理的在线状态（绿点/红点）、当前正在执行的任务（带动态图标）、API 使用量统计以及最近一次活动时间。让你随时掌握 AI 的工作状态。
原生 macOS 通知
当 AI 助理完成长时间任务（如代码测试、邮件处理）或需要你确认某个操作时，Companion App 会发送 macOS 原生推送通知，无需一直盯着 Telegram 等待。支持通知中心历史记录。
任务状态图标标识
菜单栏的🦞图标会根据 AI 当前状态动态变化：🛠️ 表示正在执行任务、📎 表示文件操作、📝 表示正在写入、💻 表示运行命令。一眼即知 AI 在干什么。
进阶功能：远程模式（连接外部 OpenClaw 服务器）
Companion App 不仅能连接本机运行的 OpenClaw，还支持远程模式——连接到部署在 VPS、NAS 或家里旧电脑上的 OpenClaw 服务器。这意味着你的 MacBook Air 可以作为"控制端"，而真正的 AI 运算在远端服务器上进行，MacBook 只负责显示界面。
# 在远端 OpenClaw 服务器上，生成远程访问 token
openclaw gateway --remote-token generate
# 输出类似：
# Remote token: oclaw_rem_xxxxxxxxxxxxxxxxxxxxx
# 查看 gateway 监听地址
openclaw status # 查看 gateway.remote.url
然后在 Mac 上的 Companion App 中：
点击菜单栏🦞图标 → 点击右上角⚙️设置图标
找到"Remote Gateway"选项，将模式切换到"Remote"
填写远端服务器的 Gateway URL（如 https://your-server.tailscale.net:18789）
粘贴之前生成的 Remote Token，点击"连接"，连接成功后菜单栏图标变为绿色
Companion App 高级设置技巧
自定义全局热键
在设置中修改呼出热键为你习惯的组合。推荐避免与其他应用冲突，常见的好选择：
⌥Space⌘⇧A^⌥C悬浮面板尺寸和位置
默认悬浮面板在屏幕中央，可在设置中调整为"菜单栏下方弹出"（Popover 模式）或"固定在某角落"（Corner 模式）。对于小屏幕 MacBook Air（13寸），建议使用 Popover 模式避免遮挡内容。
深色模式适配
Companion App 完全支持 macOS 深色模式，会自动跟随系统外观切换。对于长时间在深色模式下工作的用户，悬浮面板的深色主题不会刺眼。
Talk 语音模式
在悬浮面板中点击麦克风图标，可启用"Talk 语音模式"——直接对着 Mac 说话，OpenClaw 将识别语音并转换为文字指令。静音超过设定时间后自动发送，适合双手忙碌时使用。
Companion App + CLI + Telegram 三端协同
Companion App 并不是要取代 Telegram 或 CLI，而是与它们形成互补的三端体系，覆盖所有使用场景：
Companion App
在 Mac 前工作时，快速发一条指令不需要切换窗口。适合"顺手"的小任务：查个资料、总结段落、执行脚本。
Telegram / WhatsApp
外出时用手机给 AI 发指令，或者用于需要文件附件、长对话记录的复杂任务。也适合接收 AI 主动推送的通知。
Web 控制台
需要管理技能（Skills）、查看完整日志、调整系统配置时使用。浏览器访问 localhost:18789 进入完整控制台。
常见问题与解决方案
❌ 问题：Companion App 打开后菜单栏没有图标
原因：macOS 菜单栏图标数量有限制，可能被隐藏。解决：安装 Bartender 或 Ice 等菜单栏管理工具，或者在 App 设置中检查"Show in Menu Bar"是否勾选。
⚠️ 问题：全局热键与其他 App 冲突（如 Raycast）
解决：在 OpenClaw Companion App 设置中更换热键，避免与 Raycast（⌘Space）、Alfred（⌥Space）等工具冲突。推荐使用三键组合如 ^⌥C（Control+Option+C）。
💡 问题：显示"无法连接到 OpenClaw Gateway"
解决：确认 CLI 服务已启动：在终端运行 openclaw status。若显示 offline，运行 openclaw start 后在 Companion App 中重新连接。
⚠️ 问题：AI 响应很慢，等待 30 秒以上
原因：Mac 正常运行 Companion App 调用 Claude API，但 API 响应慢通常是网络问题。解决：确保 VPN07 已连接，选择延迟最低的节点。VPN07 的 1000Mbps 千兆带宽能将 Claude API 响应时间从 5-10 秒降至 0.5-1 秒。
网络对 Companion App 体验的影响
Companion App 的核心体验——热键呼出后等待 AI 回复的时间——完全取决于网络速度。以下是我们对比测试的结果：
| 网络状况 | Claude API 响应 | 体验评价 |
|---|---|---|
| 国内直连（无 VPN） | 超时/失败 | 无法使用 |
| 普通 VPN（不稳定） | 3-10秒 | 体验较差 |
| VPN07（优质节点） | 0.5-1.5秒 | 流畅自然 |
| 海外直连（无限制） | 0.3-0.8秒 | 最佳 |
VPN07 — Companion App 的丝滑网络
macOS 原生客户端 · 热键呼出 AI 不卡顿
OpenClaw Companion App 的核心体验是"热键呼出，秒速回复"。要达到这个效果，网络延迟必须足够低。VPN07 运营超过十年，macOS 客户端与系统无缝集成，支持分流规则让 OpenClaw 专用高速通道。1000Mbps 千兆带宽，Claude API 响应快至 0.5 秒，让你感觉 AI 就在身边。覆盖全球 70+ 国家，月费 ¥9，比你用一次 Starbucks 还便宜。