OpenClaw macOS 配套应用程序：菜单栏指南

简介

虽然 OpenClaw 主要作为连接聊天应用程序的命令行工具运行，但 macOS 用户可以访问菜单栏中功能强大的配套应用程序。这款原生 macOS 应用程序提供对 OpenClaw 的快速访问、桌面通知以及与 Mac 系统的无缝集成。

配套应用程序补充了 CLI 版本，为您提供两全其美的功能：聊天应用程序集成和本机 macOS 便利性。本指南涵盖了您需要了解的有关安装、配置和使用 OpenClaw macOS 配套应用程序的所有信息。

什么是配套应用程序？

OpenClaw macOS 配套应用程序是一个本机应用程序，它：

• 存在于您的菜单栏中 — 无需打开终端即可快速访问
• 提供桌面通知 — 获取重要消息提醒
• 提供快速查询界面 - 无需打开聊天应用程序即可提出问题
• 与 macOS 集成 — 可与系统服务和快捷方式配合使用
• 补充 CLI — 与命令行版本一起使用

将其视为基于聊天的 OpenClaw 实例的桌面伴侣，提供本机 macOS 集成和便利功能。

安装

方法一：直接下载

1. 访问OpenClaw发布页面
2. 下载适用于 macOS 的最新 .dmg 文件
3. 打开下载的.dmg文件
4. 将 OpenClaw 拖至您的应用程序文件夹
5. 从应用程序或 Spotlight 启动

方法 2：自制桶

brew install --cask openclaw

方法 3：从源代码构建

如果您想要最新的开发版本：

git clone https://github.com/openclaw/openclaw.git
cd openclaw/companion-app
npm install
npm run build
npm run dist

首次启动设置

当您首次启动配套应用程序时：

第 1 步：连接到您的 OpenClaw 实例

该应用程序需要连接到您正在运行的 OpenClaw CLI 实例：

1. 启动 OpenClaw CLI — 确保您的 CLI 实例正在运行
2. 输入 API 端点 — 默认为 http://localhost:3000
3. 验证连接 — 应用程序将测试连接

第 2 步：配置首选项

通过菜单栏图标访问首选项：

• 常规 — 启动行为、通知
• 外观 — 主题、图标样式
• 高级 — API 端点、调试

第 3 步：授予权限

该应用程序可能会请求：

• 辅助功能 — 用于系统集成
• 通知 — 用于桌面警报
• 完整磁盘访问 — 用于文件操作（如果需要）

在“系统设置”>“隐私和安全”中授予这些权限。

菜单栏功能

快速访问菜单

单击菜单栏图标访问：

• 快速查询 — 直接提问
• 最近对话 — 查看聊天记录
• 技能 — 访问已安装的技能
• 设置 — 配置首选项
• 状态 — 检查连接状态

状态指示器

菜单栏图标显示：

• 绿色 — 已连接并准备就绪
• 黄色 — 已连接但有警告
• 红色 — 已断开连接或发生错误
• 灰色 — 正在启动

键盘快捷键

配置全局快捷键：

• Cmd+Shift+C — 打开快速查询
• Cmd+Shift+A — 切换助手
• Cmd+Shift+S — 显示状态

快速查询接口

配套应用程序的快速查询功能让您无需打开 WhatsApp、Telegram 或 Discord 即可与 OpenClaw 进行交互。

打开快速查询

1. 单击菜单栏图标
2. 选择“快速查询”或使用键盘快捷键
3. 输入您的问题
4. 按 Enter 发送

用例

快速信息：

• “今天我的日历上有什么？”
• “检查我的电子邮件中是否有紧急消息”
• “天气怎么样？”

快速行动：

• “添加任务：审核项目提案”
• “设置提醒：下午 3 点给莎拉打电话”
• “检查 GitHub PR 状态”系统查询：
• “我今天修改了哪些文件？”
• “显示最近的终端命令”
• “我的系统状态是什么？”

桌面通知

配套应用程序可以发送桌面通知：

消息提醒

当 OpenClaw 收到以下消息时收到通知：

• WhatsApp
• 电报
• Discord
• 其他连接平台

任务提醒

设置触发桌面通知的提醒：

• 日历事件
• 任务期限
• 自定义提醒

系统事件

通知：

• OpenClaw状态变化
• 技能执行结果
• 错误警报
• 更新通知

配置通知

1. 打开偏好设置
2. 转到通知部分
3. 启用/禁用通知类型
4. 自定义通知声音
5. 设置请勿打扰时间

与 CLI 集成

配套应用程序与您的 CLI 实例一起工作：

共享配置

两者使用相同的：

• API端点
• 认证
• 技能和整合
• 记忆和背景

补充功能

CLI 提供：

• 聊天应用程序桥梁
• 完整的命令行访问
• 服务器能力
• 高级配置

配套应用程序提供：

• 原生 macOS 集成
• 桌面通知
• 快速访问界面
• 系统服务

一起运行

您可以同时运行两者：

1. 启动CLI实例：npm start
2. 启动配套应用程序
3. 两者都连接到同一个后端
4. 使用方便的接口

高级功能

系统服务集成

配套应用程序可以与 macOS 服务集成：

文本选择：

1. 在任何应用程序中选择文本
2. 右键→服务→“询问OpenClaw”
3. 在通知中获取AI响应

文件操作：

1. 在 Finder 中选择文件
2. 右键单击→服务→“使用OpenClaw分析”
3. 获取文件分析

聚光灯集成

通过 Spotlight 搜索 OpenClaw 命令：

• 输入“OpenClaw”打开应用程序
• 搜索“Ask OpenClaw”即可触发查询
• 快速访问最近的对话

快捷方式应用程序集成

在 macOS 快捷方式中创建自动化：

1. 打开快捷方式应用程序
2. 创建新的快捷方式
3. 添加“运行Shell脚本”操作
4. 调用OpenClaw API端点
5. 从 Siri 或小部件触发

定制

外观

自定义应用程序的外观：

• 图标样式 — 从可用图标中选择
• 主题 — 浅色、深色或自动
• 菜单样式 — 紧凑或扩展

行为

配置应用程序行为：

• 登录时启动 — 自动启动
• 不活动时隐藏 — 最小化菜单栏图标
• 退出行为 — 继续运行或退出应用程序

高级设置

高级用户选项：

• 自定义 API 端点 — 指向远程实例
• 调试模式 — 启用详细日志记录
• 代理设置 — 配置网络代理
• 更新频道 — Beta 版或稳定版

故障排除

应用程序无法连接

问题： 配套应用程序无法连接到 CLI

解决方案：

1. 验证 CLI 正在运行：ps aux | grep openclaw
2. 检查API端点是否与CLI端口匹配
3. 验证防火墙没有阻止本地主机
4. 检查 CLI 日志是否有错误

通知不起作用

问题： 桌面通知不显示

解决方案：

1. 检查macOS通知设置
2. 验证应用是否有通知权限
3. 检查请勿打扰状态
4. 重新启动应用程序

菜单栏图标丢失

问题： 图标未出现在菜单栏中

解决方案：

1. 检查图标是否隐藏（macOS可能会隐藏图标）
2. 重置菜单栏：killall SystemUIServer
3. 重新安装应用程序
4. 检查 macOS 兼容性

性能问题

问题： 应用程序缓慢或无响应解决方案：

1. 检查系统资源
2. 减少通知频率
3. 清除应用程序缓存
4. 重新启动应用程序

最佳实践

日常工作流程

1. 启动 CLI — 在启动时运行 OpenClaw CLI
2. 启动 Companion — 保持伴侣应用程序运行
3. 使用快速查询 — 用于快速提问
4. 使用聊天应用程序 — 进行较长时间的对话
5. 监控通知 — 随时了解情况

资源管理

• 监控内存使用情况
• 如果不需要，请关闭配套应用程序
• 对服务器使用仅 CLI 模式
• 优化通知设置

安全

• 保持应用程序更新
• 使用安全的API端点
• 不要公开暴露API
• 审查通知权限

比较：配套应用程序与 CLI

何时使用配套应用程序

• 快速桌面查询
• 桌面通知
• macOS系统集成
• 视觉状态监控

何时仅使用 CLI

• 服务器部署
• 无头设置
• 高级配置
• 资源受限的系统

两者同时使用

两全其美：

• 用于核心功能的 CLI
• 方便的配套应用程序
• 共享后端和配置
• 灵活的接入方式

未来的增强

配套应用程序不断发展，具有以下功能：

• 对 macOS 的小部件支持
• Siri 集成
• 更多系统服务
• 增强的通知
• 更好的性能

结论

OpenClaw macOS 配套应用程序提供本机桌面集成，完美补充了 CLI 版本。无论您想要快速查询、桌面通知还是系统集成，配套应用程序都能增强您在 macOS 上的 OpenClaw 体验。

将其与 CLI 实例一起安装以获得最佳体验。使用快速查询来快速提问，依靠通知来获取重要警报，并享受无缝的 macOS 集成。

有关更多信息，请查看我们的安装指南 和macOS 特定设置。如果您有疑问，请访问我们的常见问题解答 或浏览其他教程。