ClawLensXR
菜单
简体中文

终端用户文档

ClawLensXR 用户指南。

设置 Android 配套应用与兼容的 Rokid 眼镜,然后选择服务商:你自己的私密 OpenClaw Gateway,或受支持的 Hermes Agent HTTPS API。Hermes 功能取决于应用版本和服务器;下方较早的截图展示的是 OpenClaw 流程。

Android 伴侣应用Rokid HUDOpenClaw / Hermes Agent
已连接 Rokid 和 OpenClaw 的 ClawLensXR Android 设置概览

已于 2026 年 9 月 26 日更新为 Build 159 截图 · 私密文字已模糊处理

截图目前显示英文界面;本地化截图将在稍后替换。

快速开始

从安装到第一个答案。

Android 手机是所选后端与眼镜之间的桥梁,请先在手机上完成设置。Hermes Agent 需要带有 Hermes 设置的版本;仅从 Google Play 安装并不能确认支持 Hermes。

登录

打开“设置 → 账户”,使用提供下载访问权限的 ClawLensXR 会员资格登录。

连接 OpenClaw 或 Hermes Agent

OpenClaw:扫描可信 Gateway 的二维码或设置码,或输入其私密 TLS 主机和端口,然后批准设备。Hermes Agent:在 AI 服务商中选择 Hermes,输入准确的受支持 HTTPS/配置档 URL 和 Hermes API 令牌,然后保存连接 → 使用连接 → 刷新状态。仪表板登录与 API 访问相互独立。

连接 Rokid

选择 Hi Rokid 或 Direct,出现请求时授权,扫描眼镜并连接。

安装 HUD

打开“设置 → 更新”,安装或更新随附的眼镜应用。传输期间保持两个设备唤醒。

开始会话

OpenClaw:选择会话、智能体和模型。Hermes:在手机上选择配置档并创建会话;HUD 可浏览现有会话。使用受支持的文字、照片或语音转写功能;Hermes 不支持远程音频。

连接安全性: OpenClaw 需要私密 TLS/wss:// Gateway 及设备批准。Tailscale 可提供私密访问,无需 Funnel 或公开暴露。Hermes Agent 则需要受支持的 HTTPS API/配置档 URL 和 Hermes API 令牌,不使用 Gateway 二维码配对、wss:// 地址或 OpenClaw 令牌。功能取决于应用版本及服务器权限。

示例提示词:通过 Tailscale 连接 ClawLensXR Android

了解该看哪里

手机设置与 HUD 控件不同。

Android 手机应用

配置和管理。

手机负责账户访问、Gateway 和 Rokid 连接、语言、语音提供商、字幕、通知、软件更新和恢复。

  • 仅在手机上输入凭据
  • 安装/更新眼镜伴侣应用
  • 管理所有高级设置与故障排除
Rokid 眼镜 HUD

在当下阅读并操作。

HUD 显示当前对话,并提供快速触控板控件用于照片、目录、布局、语音和活动运行。

  • 阅读流式回复
  • 切换智能体、会话和模型
  • 控制照片、对话模式、字幕和语音输出

Android 伴侣应用

您的连接、对话和控制中心。

下方打码截图来自当前应用,拍摄时 Rokid 与 OpenClaw 均已连接。

ClawLensXR Android 聊天,显示在罗马晚餐时的虚构对话
聊天:两个连接卡均在线,并通过不含私密数据的虚构对话演示菜单翻译。
ClawLensXR Android 连接设置,私密 Gateway 主机名已模糊
连接:设置和传输控件仍可见;私密 Gateway 主机名已模糊。
  • 连接卡眼镜和 OpenClaw 卡显示已连接、正在连接或需要注意状态。需要恢复时点按相应卡或打开设置。
  • 聊天上下文展开上下文行以切换当前会话、智能体和已配置模型,无需离开聊天。
  • 编辑器输入消息、暂存选定的照片、使用麦克风/对话模式控件,发送或停止当前运行。
  • 照片最多四张拍摄照片可为下一条消息暂存。仅在提交或使用立即发送命令时发送选定的照片。
  • 视频语音命令启动和停止眼镜原生录制。片段最长 60 秒,保留在眼镜存储并在 Hi Rokid 查看;ClawLensXR 不上传或分析它们。
  • 对话模式点按显著控件启用免手持后续对话或始终聆听行为。它与字幕和录制共享麦克风控制权。

完整 Android 设置参考

按类别列出的每项终端用户设置。

一些控件仅在受支持、已连接或相关时出现。生产环境中高级诊断可能在有证据前隐藏。

账户 手机

会员资格控制 Android 应用所用的受保护应用下载和权益。

登录 / 已保存账户使用 ClawLensXR 用户名或邮箱验证。Android Credential Manager 可提供已保存账户。
刷新立即重新检查会员状态。
订阅账户没有有效权益时打开购买页面。
账户打开网页会员账户以管理账单、取消和受保护下载。
退出登录从此手机移除应用会话;不会取消订阅。
应用语言 手机 + HUD

选择英语、简体中文、日语、德语、法语或西班牙语。手机会将此界面语言发送到兼容 HUD。

应用语言更改手机和眼镜上的产品 UI 标签。不会更改语音识别语言、字幕目标语言或与助手交谈所用语言。
连接 手机

此类别包含独立的 OpenClaw Gateway 与 Rokid 眼镜部分。

扫描 QR / 粘贴设置代码与您信任的 Gateway 配对,无需复制共享令牌。提示时在 Gateway Devices 中批准 ClawLensXR。
主机 / 端口手动私密 Gateway 端点。使用 TLS 和 wss://;支持 Tailscale 以私密访问。
共享令牌旧版可选兼容字段。请隐藏,且不要包含在支持截图中。
Hi Rokid使用官方应用的公共传输。授权是临时的,媒体或语音采集可能再次请求。
Direct使用您的 Rokid 开发者 Access Key 和 32 字符 Client Secret。值在手机上加密,不发送至 OpenClaw。
获取 Rokid API 密钥打开 Rokid 开发者门户并创建账户或登录。在开发者控制台中创建或选择您的应用,获取其 Access Key 和 32 位 Client Secret。在 ClawLensXR 中打开“设置 → 连接 → Rokid 眼镜”,选择 Direct,输入这两个值并保存,然后扫描并连接眼镜。请妥善保管 Client Secret。如果未显示凭据,请完成 Rokid 要求的开发者验证。 打开 Rokid 开发者门户
扫描 / 连接 / 断开发现和管理蓝牙眼镜连接。提供时可取消或重试重连。
流式唤醒待机期间新流式或主动内容到达时唤醒 HUD。
始终就绪保持显示/CXR 无线电唤醒以更快可用,会消耗更多眼镜电量。
立即唤醒眼镜发送手动唤醒探测,不删除配对。
恢复 ClawLensXR恢复眼镜聊天应用,并在支持时保留暂存文字、照片、配对和设置。
保存照片在 Pictures/ClawLensXR 中保存额外的拍摄图像副本。
清除配对移除已保存配对数据。仅在普通唤醒/重试恢复失败时使用;之后必须重新配对。
重启眼镜确认后重启眼镜。重启期间显示和连接不可用。
切换到 Hi Rokid打开官方 Hi Rokid 应用前断开 ClawLensXR。
Hermes 设置 手机

适用于显示“Hermes 设置”的版本。上方旧截图和 OpenClaw 说明仅针对 OpenClaw;Hermes 不使用 Gateway QR 配对或 wss://。是否可用取决于已安装版本;此处并非 Google Play 发布公告。

打开 Hermes 设置在“设置 → AI 提供商”选择 Hermes 用于后续请求,再打开“Hermes 设置”。打开设置或保存连接不会切换提供商。原有 OpenClaw 配置会保留;选择提供商不会取消进行中的工作。
新建连接填写“连接名称”、“私有 HTTPS 服务器网址(包括配置文件路径)”和“Hermes API 令牌”。向 Hermes 管理员获取准确网址及 API 凭据;不能使用 ClawLensXR 密码、OpenClaw 共享令牌或控制面板登录令牌代替。
HTTPS 地址与配置路径仅为示例:https://hermes.example/profile-path/。保留管理员提供的基础/配置路径;应用会追加 API 路由。使用有效 HTTPS,不含内嵌用户名密码、查询、片段或点路径段;不要填写 wss:// Gateway 地址。
保存连接 → 使用连接 → 刷新状态保存只存储本地条目;使用仅在本地选择连接;刷新状态检查当前就绪情况。这些操作不会授予会话、模型或发送权限。在“会话”选择已验证的现有会话,并在发送前检查状态。
编辑连接打开已保存条目的操作菜单。密钥留空会保留原密钥;新密钥或不同网址需要确认。条目过期请关闭后重新打开;忙碌时等待任务完成。受保护存储失败不代表保存成功;原始工作未解决可能阻止连接更改。
控制面板登录独立如部署提供控制面板,填写“控制面板HTTPS基础网址”,选择“发现登录提供商”,再使用提供的登录操作打开浏览器并完成登录。此身份与 Hermes API 凭据及 ClawLensXR 会员身份独立。
读取控制面板配置文件 → 关联API连接 → 使用配置档案读取仅列出此次返回的配置。关联操作明确绑定已保存的 API 连接,不会从配置推断网址、路径、端口或密钥。确认关联后选择“使用配置档案”。登录及关联不验证 REST 服务,也不授予发送权限。
后续请求使用的模型选择“模型”或“使用服务器默认值”。列表来自已配置的原生提供商/模型;即使已在本地选择,限制及价格状态仍可阻止发送。“刷新模型目录”位于选择器或“高级”。下次模型选择不证明实际服务模型;可用时查看实际运行信息。
恢复与限制地址或认证错误时检查准确 HTTPS 路径及 API 密钥,或在控制面板登录需续期时重新登录,再“刷新状态”。不要仅因会话存在就重试未确认的新建会话或重复发送不确定工作。原始 Create 检查及“高级”显示限定范围的恢复信息;读取不能替代缺失的 Create 回执。Hermes 支持原生文本、照片及转写,不支持远程音频。
眼镜上的 HermesBuild 230 参考版本中,配置选择及新建会话由手机完成。HUD 只读显示手机已确认的配置,并可浏览、选择现有会话。OpenClaw HUD 流程不变。
语音与对话 手机 + HUD
ClawLensXR 语音与对话设置
对话模式、字幕和 OpenAI 识别;已保存密钥被遮盖。
对话模式从概览、手机详情页或 HUD“更多”菜单启用或停用免手持对话。
Hey Rokid 后续默认模式:用眼镜唤醒词或 AI 键激活,在语音回答后再听一次,静音时停止。
始终聆听只要选定音频源可用便持续重启识别,使用更多麦克风/电池时间。
识别语言选择语音识别所用语言,独立于应用语言。
实时字幕在 HUD 上显示连续短语音片段。
翻译 / 目标语言使用已配置 OpenAI 密钥翻译字幕。可能产生提供商费用;失败时仍可查看原文。
OpenAI 语音识别启用高精度 OpenAI 转写,并保存/显示/删除其 API 密钥。不可用时应用回退到 Android 设备识别。
长篇听写仅手机麦克风:点按一次录制、再次点按转写,最长五分钟。对话模式和眼镜音频保持实时路径。
实验性本地唤醒词可选的本地“HEY CLAWLENSXR”检测器。其他音频功能占用麦克风时暂停,可能影响电池续航。
语音回复启用助手语音回复,选择 OpenAI 或 ElevenLabs,保存提供商密钥、选择声音、停止/重播语音并调整速度。
显示与媒体 手机
聊天文字大小将手机消息和编辑器文字从 14 调至 26 sp;重置回到 18 sp。Android 系统字体缩放仍生效。
通知卡片默认关闭。将选定 Android 通知中继到 HUD。
允许的软件包名称以逗号分隔的精确 Android 软件包 ID,例如 com.google.android.gm。
授予通知访问权打开 Android 系统设置并明确授权 ClawLensXR。持续通知、群组摘要和 ClawLensXR 自己的通知会被忽略。
更新 手机 → HUD
版本信息显示手机版本/构建/分发轨道以及随附眼镜应用版本/构建。
安装或更新眼镜应用将匹配的随附 HUD 传输到已连接眼镜。保持两个设备唤醒,上传/安装期间不要断开。
验证已安装构建确认已连接 HUD 报告预期匹配构建。
取消 / 再试 / 再次安装受支持安装器状态会显示操作。重试前阅读屏幕提示。
高级 支持
调试诊断记录经过隐私过滤的输入、音频和连接事件以供排障。不记录语音、聊天内容或凭据。测试后请关闭。
证据面板可用时显示最新语音尝试、公共眼镜中断或公共音频入口摘要以供支持。
开发者调试模式仅限模拟器/调试构建。以回环 WebSocket 传输替代蓝牙,非终端用户生产设置。

Rokid 眼镜 HUD

无需取出手机的快速控制。

此图遵循当前六项 HUD 菜单。手机仍负责凭据、提供商设置和软件管理。

ClawLensXR 抬头显示器插图
您的 OpenClaw 助手,始终在视野中。
  • 照片拍摄并暂存照片。最多可附加四张;输入暂存区会出现发送/清除。您还可以通过眼镜使用语音命令免手持拍照。
  • 智能体 / 会话 / 模型打开目录,滑动可用项目,点按选择,双击取消。
  • 大小在全屏、底部和顶部间循环 HUD 位置。
  • 更多选择紧凑、普通、舒适或大号文字;打开斜杠命令;切换对话模式、字幕或语音;停止/重播 TTS;停止活动运行。
向前/后滑动滚动聊天或在聚焦菜单/列表中移动。
单击跳至最新聊天文字或选择聚焦操作。TTS 期间会停止语音。
双击取消/关闭菜单。普通聊天中会打开退出确认。
长按 / AI 键开始语音输入或激活/中断对话模式行为。

语音相机命令

清晰说出操作。

命令可用性取决于当前语音路径和语言。照片命令可发送视觉上下文;视频保留在眼镜本地。

“拍照”

拍摄并为下一条消息暂存照片。

“拍摄并发送照片”

拍摄后立即发送到当前会话。

“读这个” / “翻译这个” / “识别这个”

拍摄选定的照片,并请当前助手执行请求的视觉任务。

“开始录像” / “停止录像”

控制眼镜原生录制。片段保留在眼镜存储中,可在 Hi Rokid 中查看。

故障排除

重置前先安全恢复。

Gateway 无法连接

检查私密路由、TLS 证书、wss:// 主机/端口和 Tailscale 状态。在 Gateway 中批准待处理的 ClawLensXR 设备。

眼镜已配对但休眠

保留蓝牙绑定。使用“立即唤醒眼镜”或恢复提示;如有指示,连续按三次眼镜按钮直至蓝色 LED 再次广播。

语音无法启动

确认麦克风权限和识别语言。停止竞争的字幕、对话模式、听写、视频或 TTS 活动,然后重试。

语音回复无声

检查手机上的提供商/密钥/声音,并确保 HUD“更多”菜单中已启用语音。仅当最新回复可用时使用重播。 要提高语音聊天回复的音量,请在语音聊天进行时调整 Android 的通话音量。语音聊天使用的是通话音量,而不是媒体音量。

照片未到达

等待拍摄完成,保持少于四张暂存照片,确认当前会话,并在请求时重新授权 Hi Rokid 媒体访问。

视频似乎丢失

检查 Hi Rokid 和眼镜原生媒体存储。ClawLensXR 不导入或上传视频,因此不会作为聊天附件出现。

分享支持截图前

模糊 Gateway 主机、账户详情、会话/智能体名称、聊天消息、设备标识符和所有凭据字段——即使密钥看起来已遮盖。

联系支持