chore(i18n): refresh zh-CN translations
This commit is contained in:
parent
dd6e089ac5
commit
2dd2a3a482
@ -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 是否为当前有效 code(codes 会轮换)。
|
||||
- **认证错误**:确认登录码是当前有效的(代码会轮换)。
|
||||
|
||||
## 配置参考
|
||||
|
||||
@ -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 URL(SSRF 绕过)。
|
||||
- `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) — 访问模型和加固
|
||||
|
||||
Loading…
Reference in New Issue
Block a user