chore(i18n): refresh zh-CN translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-05-03 22:20:57 +00:00
parent dd6e089ac5
commit 2dd2a3a482

View File

@ -4,27 +4,27 @@ read_when:
summary: Tlon/Urbit 支持状态、能力和配置
title: Tlon
x-i18n:
generated_at: "2026-05-02T21:57:10Z"
generated_at: "2026-05-03T22:20:27Z"
model: gpt-5.5
provider: openai
source_hash: 30915170786fc1ee8b84fb8be2ea42280262923064cfa9ca7107036096a13add
source_hash: 1718044541b431ff2437508e7e6659c14206f4aa84ab8b207e0d791dea2a48c5
source_path: channels/tlon.md
workflow: 16
---
Tlon 是构建在 Urbit 上的去中心化消息应用。OpenClaw 会连接到你的 Urbit ship可以
Tlon 是构建在 Urbit 上的去中心化消息应用。OpenClaw 会连接到你的 Urbit ship并可以
回复私信和群聊消息。默认情况下,群组回复需要 @ 提及,也可以
通过 allowlist 进一步限制。
通过允许列表进一步限制。
Status: 内置插件。支持私信、群组提及、thread 回复、富文本格式以及
图片上传。尚不支持 Reactions 和投票。
Status:内置插件。支持私信、群组提及、线程回复、富文本格式和
图片上传。暂不支持表情回应和投票。
## 内置插件
Tlon 在当前 OpenClaw 版本中作为内置插件发布,因此常规打包
在当前 OpenClaw 版本中Tlon 作为内置插件随附,因此普通打包
构建不需要单独安装。
如果你使用的是较旧构建,或是不包含 Tlon 的自定义安装,请安装
如果你使用的是旧版本构建,或排除了 Tlon 的自定义安装,请安装
当前 npm 包:
通过 CLI 安装npm registry
@ -33,10 +33,10 @@ Tlon 在当前 OpenClaw 版本中作为内置插件发布,因此常规打包
openclaw plugins install @openclaw/tlon
```
使用裸包名以跟随当前官方发布标签。只有在需要可复现安装时,
才固定到精确版本。
使用裸包名可跟随当前官方发布标签。仅在需要可复现安装时才固定精确
版本。
本地 checkout从 git repo 运行时):
本地检出(从 git 仓库运行时):
```bash
openclaw plugins install ./path/to/local/tlon-plugin
@ -48,13 +48,13 @@ openclaw plugins install ./path/to/local/tlon-plugin
1. 确保 Tlon 插件可用。
- 当前打包的 OpenClaw 版本已内置它。
- 旧/自定义安装可以使用上面的命令手动添加。
2. 收集你的 ship URL 和登录 code
- 旧/自定义安装可以使用上面的命令手动添加
2. 收集你的 ship URL 和登录
3. 配置 `channels.tlon`
4. 重启 Gateway 网关。
5. 给机器人发送私信,或在群组 channel 中提及它。
5. 给机器人发私信,或在群组频道中提及它。
最小配置(单账
最小配置(单账
```json5
{
@ -72,7 +72,7 @@ openclaw plugins install ./path/to/local/tlon-plugin
## 私有/LAN ships
默认情况下OpenClaw 会阻止私有/内部主机名和 IP 范围,以提供 SSRF 防护。
默认情况下OpenClaw 会阻止私有/内部主机名和 IP 范围以提供 SSRF 保护。
如果你的 ship 运行在私有网络上localhost、LAN IP 或内部主机名),
你必须显式选择启用:
@ -93,12 +93,12 @@ openclaw plugins install ./path/to/local/tlon-plugin
- `http://192.168.x.x:8080`
- `http://my-ship.local:8080`
⚠️ 只有在你信任本地网络时才启用此项。此设置会对发往你的 ship URL 的请求
禁用 SSRF 护。
⚠️ 仅在你信任本地网络时启用此项。该设置会对发送到你的 ship URL 的请求
禁用 SSRF 护。
## 群组 channels
## 群组频道
默认启用自动发现。你也可以手动固定 channels
默认启用自动发现。你也可以手动固定频道
```json5
{
@ -124,7 +124,7 @@ openclaw plugins install ./path/to/local/tlon-plugin
## 访问控制
私信 allowlist空 = 不允许私信,使用 `ownerShip` 走审批流程):
私信允许列表(空 = 不允许私信,使用 `ownerShip` 进行批准流程):
```json5
{
@ -159,9 +159,9 @@ openclaw plugins install ./path/to/local/tlon-plugin
}
```
## 所有者和批系统
## 所有者和批系统
设置 owner ship以便在未授权用户尝试交互时接收批请求:
设置所有者 ship以便在未授权用户尝试交互时接收批请求:
```json5
{
@ -173,19 +173,19 @@ openclaw plugins install ./path/to/local/tlon-plugin
}
```
owner ship 会**在所有位置自动获得授权** — 私信邀请会自动接受,
channel 消息始终允许。你不需要把 owner 添加到 `dmAllowlist`
所有者 ship 会**自动在所有位置获得授权**——私信邀请会自动接受,
频道消息始终允许。你不需要将所有者添加到 `dmAllowlist`
`defaultAuthorizedShips`
设置后,owner 会收到以下私信通知:
设置后,所有者会收到以下私信通知:
- 来自未在 allowlist 中的 ships 的私信请求
- 未经授权的 channels 中的提及
- 来自不在允许列表中的 ships 的私信请求
- 未授权频道中的提及
- 群组邀请请求
## 自动接受设置
自动接受私信邀请(针对 dmAllowlist 中的 ships
自动接受私信邀请(针对 `dmAllowlist` 中的 ships
```json5
{
@ -197,55 +197,59 @@ channel 消息始终允许。你不需要把 owner 添加到 `dmAllowlist` 或
}
```
自动接受群组邀请:
自动接受来自受信任 ships 的群组邀请:
```json5
{
channels: {
tlon: {
autoAcceptGroupInvites: true,
groupInviteAllowlist: ["~zod"],
},
},
}
```
## 投递目标CLI/cron
`groupInviteAllowlist` 为空时,`autoAcceptGroupInvites` 会默认拒绝。将
允许列表设置为应自动接受其群组邀请的 ships。
将这些目标与 `openclaw message send` 或 cron 投递一起使用:
## 递送目标CLI/cron
将这些目标与 `openclaw message send` 或 cron 递送一起使用:
- 私信:`~sampel-palnet` 或 `dm/~sampel-palnet`
- 群组:`chat/~host-ship/channel` 或 `group:~host-ship/channel`
## 内置 skill
## 内置 Skills
Tlon 插件包含一个内置 skill[`@tloncorp/tlon-skill`](https://github.com/tloncorp/tlon-skill)
提供对 Tlon 操作的 CLI 访问:
Tlon 插件包含一个内置 Skills[`@tloncorp/tlon-skill`](https://github.com/tloncorp/tlon-skill)
提供对 Tlon 操作的 CLI 访问:
- **联系人**:获取/更新资料,列出联系人
- **Channels**:列出、创建、发布消息、获取历史记录
- **频道**:列出、创建、发布消息、获取历史记录
- **群组**:列出、创建、管理成员
- **私信**:发送消息、对消息作出
- **Reactions**:为帖子和私信添加/移除 emoji reactions
- **私信**:发送消息、对消息作出
- **表情回应**:向帖子和私信添加/移除 emoji 表情回应
- **设置**:通过 slash commands 管理插件权限
插件安装后,该 skill 会自动可用。
安装插件后,该 Skills 会自动可用。
## 能力
| 功能 | Status |
| 功能 | Status |
| --------------- | --------------------------------------- |
| 直接消息 | ✅ 支持 |
| 群组/channels | ✅ 支持(默认需要提及) |
| Threads | ✅ 支持(在 thread 中自动回复) |
| 富文本 | ✅ Markdown 转换为 Tlon 格式 |
| 图片 | ✅ 上传到 Tlon storage |
| Reactions | ✅ 通过[内置 skill](#bundled-skill) |
| 投票 | ❌ 尚不支持 |
| 原生命令 | ✅ 支持(默认仅限 owner |
| 直接消息 | ✅ 支持 |
| 群组/频道 | ✅ 支持(默认需要提及) |
| 线程 | ✅ 支持(在线程中自动回复) |
| 富文本 | ✅ Markdown 转换为 Tlon 格式 |
| 图片 | ✅ 上传到 Tlon 存储 |
| 表情回应 | ✅ 通过[内置 Skills](#bundled-skill) |
| 投票 | ❌ 暂不支持 |
| 原生命令 | ✅ 支持(默认仅所有者可用) |
## 故障排除
先运行这个排查阶梯
先运行这个排查步骤
```bash
openclaw status
@ -256,10 +260,10 @@ openclaw doctor
常见故障:
- **私信被忽略**:发送者不在 `dmAllowlist` 中,并且没有为审批流程配置 `ownerShip`
- **群组消息被忽略**channel 未被发现,或发送者未获授权。
- **忽略私信**:发送者不在 `dmAllowlist` 中,且未配置用于批准流程的 `ownerShip`
- **忽略群组消息**:频道未被发现,或发送者未授权。
- **连接错误**:检查 ship URL 是否可访问;对本地 ships 启用 `allowPrivateNetwork`
- **认证错误**验证登录 code 是否为当前有效 codecodes 会轮换)。
- **认证错误**确认登录码是当前有效的(代码会轮换)。
## 配置参考
@ -267,32 +271,33 @@ openclaw doctor
提供商选项:
- `channels.tlon.enabled`:启用/禁用 channel 启动。
- `channels.tlon.enabled`:启用/禁用渠道启动。
- `channels.tlon.ship`:机器人的 Urbit ship 名称(例如 `~sampel-palnet`)。
- `channels.tlon.url`ship URL例如 `https://sampel-palnet.tlon.network`)。
- `channels.tlon.code`ship 登录 code。
- `channels.tlon.allowPrivateNetwork`:允许 localhost/LAN URLs绕过 SSRF
- `channels.tlon.ownerShip`:审批系统的 owner ship始终授权
- `channels.tlon.dmAllowlist`:允许发送私信的 ships空 = 无)。
- `channels.tlon.autoAcceptDmInvites`:自动接受 allowlisted ships 的私信。
- `channels.tlon.autoAcceptGroupInvites`:自动接受所有群组邀请。
- `channels.tlon.autoDiscoverChannels`:自动发现群组 channels默认true
- `channels.tlon.groupChannels`:手动固定的 channel nests。
- `channels.tlon.defaultAuthorizedShips`:对所有 channels 授权的 ships。
- `channels.tlon.authorization.channelRules`:按 channel 配置的 auth rules。
- `channels.tlon.code`ship 登录码。
- `channels.tlon.allowPrivateNetwork`:允许 localhost/LAN URLSSRF 绕过)。
- `channels.tlon.ownerShip`:批准系统的所有者 ship始终授权
- `channels.tlon.dmAllowlist`:允许发私信的 ships空 = 无)。
- `channels.tlon.autoAcceptDmInvites`:自动接受来自允许列表中 ships 的私信。
- `channels.tlon.autoAcceptGroupInvites`:自动接受来自允许列表中 ships 的群组邀请。
- `channels.tlon.groupInviteAllowlist`:其群组邀请可以被自动接受的 ships。
- `channels.tlon.autoDiscoverChannels`自动发现群组频道默认true
- `channels.tlon.groupChannels`:手动固定的频道 nests。
- `channels.tlon.defaultAuthorizedShips`:对所有频道授权的 ships。
- `channels.tlon.authorization.channelRules`:按频道设置的认证规则。
- `channels.tlon.showModelSignature`:在消息后附加模型名称。
## 备注
- 群组回复需要提及(例如 `~your-bot-ship`)才会响应。
- Thread 回复:如果传入消息位于 thread 中OpenClaw 会在同一 thread 中回复。
- 富文本Markdown 格式(粗体、斜体、code、headers、列表)会转换为 Tlon 的原生格式。
- 图片URLs 会上传到 Tlon storage并作为 image blocks 嵌入。
- 线程回复如果传入消息在线程中OpenClaw 会在线程内回复。
- 富文本Markdown 格式(粗体、斜体、代码、标题、列表)会转换为 Tlon 的原生格式。
- 图片URL 会上传到 Tlon 存储,并作为图片块嵌入。
## 相关
## 相关内容
- [Channels 概览](/zh-CN/channels) — 所有支持的 channels
- [渠道概览](/zh-CN/channels) — 所有支持的渠道
- [配对](/zh-CN/channels/pairing) — 私信认证和配对流程
- [群组](/zh-CN/channels/groups) — 群聊行为和提及门控
- [Channel Routing](/zh-CN/channels/channel-routing) — 消息的会话路由
- [渠道路由](/zh-CN/channels/channel-routing) — 消息的会话路由
- [安全](/zh-CN/gateway/security) — 访问模型和加固