mirror of
https://github.com/openclaw/openclaw.git
synced 2026-04-30 18:21:45 +00:00
Docs: normalize zh-CN terminology + tone
What: switch to 你/你的 tone; standardize Skills/Gateway网关/local loopback/私信 wording Why: align zh-CN docs with issue 6995 feedback + idiomatic tech style Tests: pnpm docs:build
This commit is contained in:
Josh Palmer
@@ -1,7 +1,7 @@
|
||||
---
|
||||
read_when:
|
||||
- 配对或重新连接 Android 节点
|
||||
- 调试 Android Gateway 发现或认证问题
|
||||
- 调试 Android Gateway网关发现或认证问题
|
||||
- 验证跨客户端的聊天历史一致性
|
||||
summary: Android 应用（节点）：连接运维手册 + Canvas/聊天/相机
|
||||
title: Android 应用
|
||||
@@ -18,32 +18,32 @@ x-i18n:
|
||||
|
||||
## 支持概览
|
||||
|
||||
- 角色：伴侣节点应用（Android 不托管 Gateway）。
|
||||
- 需要 Gateway：是（在 macOS、Linux 或通过 WSL2 的 Windows 上运行）。
|
||||
- 安装：[快速入门](/start/getting-started) + [配对](/gateway/pairing)。
|
||||
- Gateway：[运维手册](/gateway) + [配置](/gateway/configuration)。
|
||||
- 协议：[Gateway 协议](/gateway/protocol)（节点 + 控制平面）。
|
||||
- 角色：伴侣节点应用（Android 不托管 Gateway网关）。
|
||||
- 需要 Gateway网关：是（在 macOS、Linux 或通过 WSL2 的 Windows 上运行）。
|
||||
- 安装：[入门指南](/start/getting-started) + [配对](/gateway/pairing)。
|
||||
- Gateway网关：[运维手册](/gateway) + [配置](/gateway/configuration)。
|
||||
- 协议：[Gateway网关协议](/gateway/protocol)（节点 + 控制平面）。
|
||||
|
||||
## 系统控制
|
||||
|
||||
系统控制（launchd/systemd）在 Gateway 主机上。参见 [Gateway](/gateway)。
|
||||
系统控制（launchd/systemd）在 Gateway网关主机上。参见 [Gateway网关](/gateway)。
|
||||
|
||||
## 连接运维手册
|
||||
|
||||
Android 节点应用 ⇄（mDNS/NSD + WebSocket）⇄ **Gateway**
|
||||
Android 节点应用 ⇄（mDNS/NSD + WebSocket）⇄ **Gateway网关**
|
||||
|
||||
Android 直接连接到 Gateway WebSocket（默认 `ws://<host>:18789`）并使用 Gateway 管理的配对。
|
||||
Android 直接连接到 Gateway网关 WebSocket（默认 `ws://<host>:18789`）并使用 Gateway网关管理的配对。
|
||||
|
||||
### 前提条件
|
||||
|
||||
- 你可以在"主"机器上运行 Gateway。
|
||||
- Android 设备/模拟器可以访问 Gateway WebSocket：
|
||||
- 你可以在"主"机器上运行 Gateway网关。
|
||||
- Android 设备/模拟器可以访问 Gateway网关 WebSocket：
|
||||
- 同一局域网且支持 mDNS/NSD，**或**
|
||||
- 同一 Tailscale tailnet，使用 Wide-Area Bonjour / 单播 DNS-SD（见下文），**或**
|
||||
- 手动指定 Gateway 主机/端口（备用方案）
|
||||
- 你可以在 Gateway 机器上（或通过 SSH）运行 CLI（`openclaw`）。
|
||||
- 手动指定 Gateway网关主机/端口（备用方案）
|
||||
- 你可以在 Gateway网关机器上（或通过 SSH）运行 CLI（`openclaw`）。
|
||||
|
||||
### 1）启动 Gateway
|
||||
### 1）启动 Gateway网关
|
||||
|
||||
```bash
|
||||
openclaw gateway --port 18789 --verbose
|
||||
@@ -53,14 +53,14 @@ openclaw gateway --port 18789 --verbose
|
||||
|
||||
- `listening on ws://0.0.0.0:18789`
|
||||
|
||||
对于仅 tailnet 的设置（推荐用于 Vienna ⇄ London），将 Gateway 绑定到 tailnet IP：
|
||||
对于仅 tailnet 的设置（推荐用于 Vienna ⇄ London），将 Gateway网关绑定到 tailnet IP：
|
||||
|
||||
- 在 Gateway 主机的 `~/.openclaw/openclaw.json` 中设置 `gateway.bind: "tailnet"`。
|
||||
- 重启 Gateway / macOS 菜单栏应用。
|
||||
- 在 Gateway网关主机的 `~/.openclaw/openclaw.json` 中设置 `gateway.bind: "tailnet"`。
|
||||
- 重启 Gateway网关 / macOS 菜单栏应用。
|
||||
|
||||
### 2）验证发现（可选）
|
||||
|
||||
在 Gateway 机器上：
|
||||
在 Gateway网关机器上：
|
||||
|
||||
```bash
|
||||
dns-sd -B _openclaw-gw._tcp local.
|
||||
@@ -70,9 +70,9 @@ dns-sd -B _openclaw-gw._tcp local.
|
||||
|
||||
#### Tailnet（Vienna ⇄ London）通过单播 DNS-SD 发现
|
||||
|
||||
Android NSD/mDNS 发现无法跨网络工作。如果你的 Android 节点和 Gateway 在不同网络上但通过 Tailscale 连接，请改用 Wide-Area Bonjour / 单播 DNS-SD：
|
||||
Android NSD/mDNS 发现无法跨网络工作。如果你的 Android 节点和 Gateway网关在不同网络上但通过 Tailscale 连接，请改用 Wide-Area Bonjour / 单播 DNS-SD：
|
||||
|
||||
1. 在 Gateway 主机上设置 DNS-SD 区域（示例 `openclaw.internal.`）并发布 `_openclaw-gw._tcp` 记录。
|
||||
1. 在 Gateway网关主机上设置 DNS-SD 区域（示例 `openclaw.internal.`）并发布 `_openclaw-gw._tcp` 记录。
|
||||
2. 配置 Tailscale split DNS，将你选择的域名指向该 DNS 服务器。
|
||||
|
||||
详情和示例 CoreDNS 配置：[Bonjour](/gateway/bonjour)。
|
||||
@@ -81,26 +81,26 @@ Android NSD/mDNS 发现无法跨网络工作。如果你的 Android 节点和 Ga
|
||||
|
||||
在 Android 应用中：
|
||||
|
||||
- 应用通过**前台服务**（持久通知）保持 Gateway 连接活跃。
|
||||
- 应用通过**前台服务**（持久通知）保持 Gateway网关连接活跃。
|
||||
- 打开**设置**。
|
||||
- 在**已发现的 Gateway** 下，选择你的 Gateway 并点击**连接**。
|
||||
- 如果 mDNS 被阻止，使用**高级 → 手动 Gateway**（主机 + 端口）并点击**连接（手动）**。
|
||||
- 在**已发现的 Gateway网关** 下，选择你的 Gateway网关并点击**连接**。
|
||||
- 如果 mDNS 被阻止，使用**高级 → 手动 Gateway网关**（主机 + 端口）并点击**连接（手动）**。
|
||||
|
||||
首次成功配对后，Android 会在启动时自动重连：
|
||||
|
||||
- 手动端点（如已启用），否则
|
||||
- 上次发现的 Gateway（尽力而为）。
|
||||
- 上次发现的 Gateway网关（尽力而为）。
|
||||
|
||||
### 4）审批配对（CLI）
|
||||
|
||||
在 Gateway 机器上：
|
||||
在 Gateway网关机器上：
|
||||
|
||||
```bash
|
||||
openclaw nodes pending
|
||||
openclaw nodes approve <requestId>
|
||||
```
|
||||
|
||||
配对详情：[Gateway 配对](/gateway/pairing)。
|
||||
配对详情：[Gateway网关配对](/gateway/pairing)。
|
||||
|
||||
### 5）验证节点已连接
|
||||
|
||||
@@ -108,14 +108,14 @@ openclaw nodes approve <requestId>
|
||||
```bash
|
||||
openclaw nodes status
|
||||
```
|
||||
- 通过 Gateway：
|
||||
- 通过 Gateway网关：
|
||||
```bash
|
||||
openclaw gateway call node.list --params "{}"
|
||||
```
|
||||
|
||||
### 6）聊天 + 历史记录
|
||||
|
||||
Android 节点的聊天界面使用 Gateway 的**主会话键**（`main`），因此历史记录和回复与 WebChat 及其他客户端共享：
|
||||
Android 节点的聊天界面使用 Gateway网关的**主会话键**（`main`），因此历史记录和回复与 WebChat 及其他客户端共享：
|
||||
|
||||
- 历史记录：`chat.history`
|
||||
- 发送：`chat.send`
|
||||
@@ -123,13 +123,13 @@ Android 节点的聊天界面使用 Gateway 的**主会话键**（`main`），
|
||||
|
||||
### 7）Canvas + 相机
|
||||
|
||||
#### Gateway Canvas 主机（推荐用于 Web 内容）
|
||||
#### Gateway网关 Canvas 主机（推荐用于 Web 内容）
|
||||
|
||||
如果你希望节点显示智能体可以在磁盘上编辑的真实 HTML/CSS/JS，请将节点指向 Gateway canvas 主机。
|
||||
如果你希望节点显示智能体可以在磁盘上编辑的真实 HTML/CSS/JS，请将节点指向 Gateway网关 canvas 主机。
|
||||
|
||||
注意：节点使用 `canvasHost.port`（默认 `18793`）上的独立 canvas 主机。
|
||||
|
||||
1. 在 Gateway 主机上创建 `~/.openclaw/workspace/canvas/index.html`。
|
||||
1. 在 Gateway网关主机上创建 `~/.openclaw/workspace/canvas/index.html`。
|
||||
|
||||
2. 将节点导航到该地址（局域网）：
|
||||
|
||||
|
||||
Reference in New Issue
Block a user