mirror of https://github.com/openclaw/openclaw.git synced 2026-02-19 18:39:20 -05:00

Files

Josh Palmer a3ec2d0734 Docs: update zh-CN translations and pipeline

What:
- update zh-CN glossary, TM, and translator prompt
- regenerate zh-CN docs and apply targeted fixes
- add zh-CN AGENTS pipeline guidance

Why:
- address terminology/spacing feedback from #6995

Tests:
- pnpm build && pnpm check && pnpm test

2026-02-03 13:23:00 -08:00

5.3 KiB

Raw Permalink Blame History

read_when, summary, title, x-i18n

read_when

summary

title

x-i18n

配对或重新连接 Android 节点

调试 Android Gateway 网关发现或认证

验证跨客户端的聊天历史一致性

Android 应用（节点）：连接操作手册 + Canvas/Chat/Camera

Android 应用

generated_at	model	provider	source_hash	source_path	workflow
2026-02-03T07:51:34Z	claude-opus-4-5	pi	9cd02f12065ce2bc483379c9afd7537489d9076094f4a412cf9f21ccc47f0e38	platforms/android.md	15

Android 应用（节点）

支持概览

角色：配套节点应用（Android 不托管 Gateway 网关）。
需要 Gateway 网关：是（在 macOS、Linux 或通过 WSL2 的 Windows 上运行）。
安装：入门指南 + 配对。
Gateway 网关：操作手册 + 配置。
- 协议：Gateway 网关协议（节点 + 控制平面）。

系统控制

系统控制（launchd/systemd）位于 Gateway 网关主机上。参见 Gateway 网关。

连接操作手册

Android 节点应用 ⇄（mDNS/NSD + WebSocket）⇄ Gateway 网关

Android 直接连接到 Gateway 网关 WebSocket（默认 ws://<host>:18789）并使用 Gateway 网关拥有的配对。

前置条件

你可以在"主"机器上运行 Gateway 网关。
Android 设备/模拟器可以访问 Gateway 网关 WebSocket：
- 使用 mDNS/NSD 的同一局域网，或
- 使用 Wide-Area Bonjour / unicast DNS-SD 的同一 Tailscale tailnet（见下文），或
- 手动 Gateway 网关主机/端口（回退方案）
你可以在 Gateway 网关机器上运行 CLI（openclaw）（或通过 SSH）。

1）启动 Gateway 网关

openclaw gateway --port 18789 --verbose

在日志中确认你看到类似内容：

listening on ws://0.0.0.0:18789

对于仅 tailnet 设置（推荐用于维也纳 ⇄ 伦敦），将 Gateway 网关绑定到 tailnet IP：

在 Gateway 网关主机的 ~/.openclaw/openclaw.json 中设置 gateway.bind: "tailnet"。
重启 Gateway 网关 / macOS 菜单栏应用。

2）验证发现（可选）

从 Gateway 网关机器：

dns-sd -B _openclaw-gw._tcp local.

更多调试说明：Bonjour。

通过 unicast DNS-SD 的 Tailnet（维也纳 ⇄ 伦敦）发现

Android NSD/mDNS 发现无法跨网络。如果你的 Android 节点和 Gateway 网关在不同网络但通过 Tailscale 连接，请改用 Wide-Area Bonjour / unicast DNS-SD：

在 Gateway 网关主机上设置 DNS-SD 区域（示例 openclaw.internal.）并发布 _openclaw-gw._tcp 记录。
配置 Tailscale split DNS，将你选择的域指向该 DNS 服务器。

详情和示例 CoreDNS 配置：Bonjour。

3）从 Android 连接

在 Android 应用中：

应用通过前台服务（持久通知）保持 Gateway 网关连接活动。
打开设置。
在发现的 Gateway 网关下，选择你的 Gateway 网关并点击连接。
如果 mDNS 被阻止，使用高级 → 手动 Gateway 网关（主机 + 端口）并连接（手动）。

首次成功配对后，Android 在启动时自动重连：

手动端点（如果启用），否则
上次发现的 Gateway 网关（尽力而为）。

4）批准配对（CLI）

在 Gateway 网关机器上：

openclaw nodes pending
openclaw nodes approve <requestId>

配对详情：Gateway 网关配对。

5）验证节点已连接

通过节点状态：
```
openclaw nodes status
```

通过 Gateway 网关：

openclaw gateway call node.list --params "{}"

6）聊天 + 历史

Android 节点的 Chat 面板使用 Gateway 网关的主会话键（main），因此历史和回复与 WebChat 和其他客户端共享：

历史：chat.history
发送：chat.send
推送更新（尽力而为）：chat.subscribe → event:"chat"

7）Canvas + 摄像头

Gateway 网关 Canvas 主机（推荐用于 web 内容）

如果你想让节点显示智能体可以在磁盘上编辑的真实 HTML/CSS/JS，请将节点指向 Gateway 网关 canvas 主机。

注意：节点使用 canvasHost.port（默认 18793）上的独立 canvas 主机。

在 Gateway 网关主机上创建 ~/.openclaw/workspace/canvas/index.html。
将节点导航到它（局域网）：

openclaw nodes invoke --node "<Android Node>" --command canvas.navigate --params '{"url":"http://<gateway-hostname>.local:18793/__openclaw__/canvas/"}'

Tailnet（可选）：如果两个设备都在 Tailscale 上，使用 MagicDNS 名称或 tailnet IP 而不是 .local，例如 http://<gateway-magicdns>:18793/__openclaw__/canvas/。

此服务器将实时重载客户端注入 HTML 并在文件更改时重新加载。 A2UI 主机位于 http://<gateway-host>:18793/__openclaw__/a2ui/。

Canvas 命令（仅前台）：

canvas.eval、canvas.snapshot、canvas.navigate（使用 {"url":""} 或 {"url":"/"} 返回默认脚手架）。canvas.snapshot 返回 { format, base64 }（默认 format="jpeg"）。
A2UI：canvas.a2ui.push、canvas.a2ui.reset（canvas.a2ui.pushJSONL 遗留别名）

摄像头命令（仅前台；权限限制）：

camera.snap（jpg）
camera.clip（mp4）

参见 Camera 节点了解参数和 CLI 助手。

5.3 KiB Raw Permalink Blame History Unescape Escape