Omarchy 上的 OpenClaw¶

OpenClaw Omarchy 插件将代理、最近的会话和快速 Prompt 放入您的桌面栏中。其单色吉祥物跟随 shell 主题，会眨眼，并根据报告的代理活动进行动画。当 Linux 桌面应用运行时，该插件成为唯一的栏条目，并使用应用的主 Gateway。

本页介绍 OpenClaw 源代码树中的插件。请单独安装；不要假设较旧的桌面版本包含相应的集成。有关 Gateway 安装和桌面应用本身，请参阅 Linux。

要求¶

带有 Quickshell 栏和插件支持的 Omarchy 4。较早的基于 Waybar 的 Omarchy 版本不提供此插件宿主。
Python 3 和 PyGObject，用于桌面会话的 D-Bus 连接。
要么是已连接且带有 Omarchy 集成的 OpenClaw Linux 桌面应用，要么是拥有配置好且可达的 Gateway、并支持 openclaw gateway call --expect-url 的 openclaw CLI。请使用包含此集成的 CLI 构建；较旧的构建可能不支持该选项。

桌面应用是可选的。插件按顺序从 OPENCLAW_DESKTOP_CLI、~/.openclaw/bin/openclaw 和图形会话的 PATH 中解析 CLI。它不会在后台安装或启动 Gateway。请使用您现有的 OpenClaw 安装和身份验证。在独立模式下，插件通过 openclaw status --json 识别所选的 Gateway，并在每次请求前检查该目标。如果状态输出对端点 URL 进行了脱敏，独立模式将无法确定目标，并禁用请求。对于这种连接，请使用桌面应用。

安装栏插件¶

在包含 apps/linux/omarchy 的 OpenClaw 源代码检出中，运行：

bash apps/linux/omarchy/install.sh

安装程序会将插件放置在您的用户配置中。使用以下命令检查：

omarchy plugin validate ~/.config/omarchy/plugins/openclaw.desktop
omarchy plugin enable openclaw.desktop

点击 OpenClaw 吉祥物。在发送 Prompt 之前，确认面板显示预期的代理和会话。使用桌面应用时，请先将您的目标 Gateway 设为主 Gateway。

使用代理、会话和快速提示¶

选择一个代理，搜索会话，或使用全部、活跃和关注过滤器。会话卡片显示最近的消息或活动、状态，以及可用的模型和 token 详情。搜索和计数覆盖已加载的会话；打开仪表盘可查看完整历史。

点击一个会话以将其设为目标，然后使用 打开会话 在桌面应用中继续。如果没有桌面应用，插件会在 TUI 中打开该会话。选择 新会话 即可与所选代理开始一个独立的对话。

Ctrl+L 聚焦到 快速 Prompt。
Ctrl+Enter 发送。Enter 插入换行。
Esc 关闭面板。
中键点击吉祥物可刷新。

Prompt 限制为 8,000 个字符。发送被接受意味着 Gateway 接受了该任务；请留意会话以查看结果。如果某次发送的结果未知，请在再次发送前检查会话。插件不会自动重试不确定的发送。草稿保存在内存中，shell 重启后不会保留。

隐藏预览 会隐藏会话标题、活动和消息预览。代理名称、模型和渠道仍然可见。关注徽章汇总报告的会话活动；它不是一个审批收件箱。打开仪表盘以审查审批。

与桌面应用共用一个图标¶

运行情况	栏行为
仅插件	插件通过配置的 CLI 显示会话。
仅桌面应用	桌面应用显示其正常的托盘图标。
两者都运行，且集成匹配	插件保持可见，应用隐藏其重复的托盘图标。
没有集成的较旧应用	当插件识别到应用的会话总线注册时，它会让位。

当两者都连接时，会话操作和快速 Prompt 使用桌面应用的主 Gateway，包括远程连接。打开会话会聚焦或打开其主 Gateway 仪表盘窗口。将仪表盘切换到另一个已保存的 Gateway 不会改变此连接。如果应用断开连接，插件会显示连接问题并禁用发送，而不是切换到另一个 CLI Gateway。

如果 Gateway 发生变化，插件会清除之前的会话选择并保留您的草稿。发送前，选择 使用此 Gateway 以确认新的目标。已提交的 Prompt 保持绑定到其原始路由。

禁用插件以恢复应用的托盘图标：

omarchy plugin disable openclaw.desktop

在插件停止响应后，应用也会恢复其图标。应用检测到插件已消失可能需要一小段时间。

更新¶

请通过各自的安装来源更新每个组件：shell 使用 Omarchy 更新器，应用使用桌面应用支持的更新流程，CLI 和 Gateway 使用您现有的 OpenClaw 更新器。更新源代码检出后，重新运行插件安装程序以更新其已安装的副本。有关 Gateway 更新指南，请参阅更新。

故障排除与支持¶

症状	检查
没有插件图标	使用上面的命令验证并启用插件。一个较旧且正在运行的桌面应用可能占用可见的图标。

症状	检查
两个 OpenClaw 图标	将插件和桌面应用都更新到包含该集成的版本。它们必须在同一个桌面用户会话中运行。
未找到 CLI	检查 `OPENCLAW_DESKTOP_CLI`、`~/.openclaw/bin/openclaw` 或图形会话的 `PATH`。通过常规的 OpenClaw 安装路径安装。
桌面连接不可用	打开桌面应用并重新连接到其主 Gateway。在那里解决身份验证或配对问题。
会话看起来已过期或发送已禁用	刷新面板并检查连接错误。插件在刷新失败后会保留缓存结果。
可能已发送 Prompt	打开目标会话，并在重新提交前检查其最新消息。

该集成面向 Omarchy 4 的 Quickshell 环境。其他栏、较旧的 Omarchy 版本以及其他桌面会话需要各自的集成；通过 mock-Gateway 测试并不能证明与这些主机兼容。插件会采样 Gateway 活动，而不是流式传输每个事件。桌面应用的限制（包括 Wayland 全局快捷键）记录在 Linux 指南中。

如需设置帮助，请使用 OpenClaw 支持。对于可复现的插件或 handoff 缺陷，请提交 OpenClaw 缺陷报告，并附上 Omarchy、插件/来源、桌面应用和 Gateway 版本；Gateway 是本地还是远程；以及复现步骤。分享日志或截图前，请移除凭据和私有会话内容。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw