5676a6b38d
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
138 lines
2.8 KiB
Markdown
138 lines
2.8 KiB
Markdown
---
|
||
read_when:
|
||
- 开发 Tlon/Urbit 渠道功能时
|
||
summary: Tlon/Urbit 支持状态、功能和配置
|
||
title: Tlon
|
||
x-i18n:
|
||
generated_at: "2026-02-01T19:58:15Z"
|
||
model: claude-opus-4-5
|
||
provider: pi
|
||
source_hash: 19d7ffe23e82239fd2a2e35913e0d52c809b2c2b939dd39184e6c27a539ed97d
|
||
source_path: channels/tlon.md
|
||
workflow: 14
|
||
---
|
||
|
||
# Tlon（插件）
|
||
|
||
Tlon 是一个基于 Urbit 构建的去中心化通讯工具。OpenClaw 连接到你的 Urbit ship，可以
|
||
回复私信和群聊消息。群聊回复默认需要 @ 提及，并可通过白名单进一步限制。
|
||
|
||
状态：通过插件支持。支持私信、群组提及、线程回复和纯文本媒体回退
|
||
（URL 附加到标题）。不支持反应、投票和原生媒体上传。
|
||
|
||
## 需要插件
|
||
|
||
Tlon 以插件形式提供，不包含在核心安装包中。
|
||
|
||
通过 CLI 安装（npm 注册表）：
|
||
|
||
```bash
|
||
openclaw plugins install @openclaw/tlon
|
||
```
|
||
|
||
本地签出（从 git 仓库运行时）：
|
||
|
||
```bash
|
||
openclaw plugins install ./extensions/tlon
|
||
```
|
||
|
||
详情：[插件](/plugin)
|
||
|
||
## 设置
|
||
|
||
1. 安装 Tlon 插件。
|
||
2. 获取你的 ship URL 和登录代码。
|
||
3. 配置 `channels.tlon`。
|
||
4. 重启 Gateway网关。
|
||
5. 向机器人发送私信或在群组渠道中提及它。
|
||
|
||
最小配置（单账户）：
|
||
|
||
```json5
|
||
{
|
||
channels: {
|
||
tlon: {
|
||
enabled: true,
|
||
ship: "~sampel-palnet",
|
||
url: "https://your-ship-host",
|
||
code: "lidlut-tabwed-pillex-ridrup",
|
||
},
|
||
},
|
||
}
|
||
```
|
||
|
||
## 群组渠道
|
||
|
||
默认启用自动发现。你也可以手动固定渠道：
|
||
|
||
```json5
|
||
{
|
||
channels: {
|
||
tlon: {
|
||
groupChannels: ["chat/~host-ship/general", "chat/~host-ship/support"],
|
||
},
|
||
},
|
||
}
|
||
```
|
||
|
||
禁用自动发现：
|
||
|
||
```json5
|
||
{
|
||
channels: {
|
||
tlon: {
|
||
autoDiscoverChannels: false,
|
||
},
|
||
},
|
||
}
|
||
```
|
||
|
||
## 访问控制
|
||
|
||
私信白名单（为空 = 允许所有）：
|
||
|
||
```json5
|
||
{
|
||
channels: {
|
||
tlon: {
|
||
dmAllowlist: ["~zod", "~nec"],
|
||
},
|
||
},
|
||
}
|
||
```
|
||
|
||
群组授权（默认为受限模式）：
|
||
|
||
```json5
|
||
{
|
||
channels: {
|
||
tlon: {
|
||
defaultAuthorizedShips: ["~zod"],
|
||
authorization: {
|
||
channelRules: {
|
||
"chat/~host-ship/general": {
|
||
mode: "restricted",
|
||
allowedShips: ["~zod", "~nec"],
|
||
},
|
||
"chat/~host-ship/announcements": {
|
||
mode: "open",
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
}
|
||
```
|
||
|
||
## 投递目标（CLI/定时任务）
|
||
|
||
与 `openclaw message send` 或定时投递配合使用：
|
||
|
||
- 私信：`~sampel-palnet` 或 `dm/~sampel-palnet`
|
||
- 群组：`chat/~host-ship/channel` 或 `group:~host-ship/channel`
|
||
|
||
## 备注
|
||
|
||
- 群聊回复需要提及（例如 `~your-bot-ship`）才会响应。
|
||
- 线程回复：如果收到的消息在线程中，OpenClaw 会在线程内回复。
|
||
- 媒体：`sendMedia` 回退为文本 + URL（不支持原生上传）。
|