Tlon 是基于 Urbit 构建的去中心化通讯平台，每个用户运行自己的「舰队」（Ship）作为个人服务器。OpenClaw 通过连接你的 Urbit 舰队，支持 DM 和群组频道消息回复，以及富文本、图片上传等能力。
安装插件
bash
openclaw plugins install @openclaw/tlon配置步骤
第一步：获取舰队信息
需要准备三项信息：
- 舰队名称：格式如
~sampel-palnet - 舰队 URL：你的 Urbit 舰队访问地址
- 登录码（Code）：在 Urbit 界面中获取，格式如
lidlut-tabwed-pillex-ridrup
第二步：配置 OpenClaw
最简配置：
json
{
"channels": {
"tlon": {
"enabled": true,
"ship": "~sampel-palnet",
"url": "https://your-ship-host",
"code": "lidlut-tabwed-pillex-ridrup",
"ownerShip": "~your-main-ship"
}
}
}配置字段说明：
| 字段 | 说明 | 默认值 |
|---|---|---|
ship | Bot 舰队名称（~ 开头） | 必填 |
url | 舰队访问 URL | 必填 |
code | 舰队登录码 | 必填 |
ownerShip | 主人舰队名称，始终允许发送 DM（推荐设置） | 可选 |
dmPolicy | DM 访问策略 | pairing |
ownerShip 为何重要：将你自己的舰队设为
ownerShip，无论 DM 策略如何，你始终可以与 Bot 对话——避免策略配置失误把自己锁在门外。
私有/内网舰队配置
默认情况下，OpenClaw 会阻止访问私有/内网地址（SSRF 防护）。若舰队运行在本地或内网：
json
{
"channels": {
"tlon": {
"url": "http://localhost:8080",
"allowPrivateNetwork": true
}
}
}适用地址：localhost、192.168.x.x、my-ship.local 等。
⚠️ 仅在信任本地网络时开启，此设置会禁用对舰队 URL 的 SSRF 防护。
群组频道配置
自动发现（默认开启）
Bot 自动扫描并加入你的舰队所在的所有群组频道。
手动指定频道
json
{
"channels": {
"tlon": {
"groupChannels": [
"chat/~host-ship/general",
"chat/~host-ship/support"
]
}
}
}关闭自动发现
json
{
"channels": {
"tlon": {
"autoDiscoverChannels": false
}
}
}访问控制
DM 访问策略
| 策略 | 说明 |
|---|---|
pairing | 默认，未知舰队需配对审批 |
open | 允许所有 Urbit 舰队发 DM |
allowlist | 仅允许 allowFrom 中的舰队名称 |
自动审批设置
json
{
"channels": {
"tlon": {
"autoAccept": true
}
}
}开启后自动批准所有配对请求（适合公开 Bot 场景）。
群组访问控制
群组默认需要 @提及 才响应：
json
{
"channels": {
"tlon": {
"groups": {
"*": { "requireMention": true }
}
}
}
}功能支持
| 功能 | 支持情况 | 备注 |
|---|---|---|
| 私信（DM） | ✅ | — |
| 群组 @提及 | ✅ | 默认必须 @提及才响应 |
| 线程回复 | ✅ | — |
| 富文本格式 | ✅ | — |
| 图片上传 | ✅ | — |
| 消息反应 | ❌ | 暂不支持 |
| 投票 | ❌ | 暂不支持 |
内置 Skill
Tlon 插件附带一个 /tlon:dm Skill，可以让 Bot 主动发起 DM：
bash
/tlon:dm ~target-ship "Hello from OpenClaw!"主动发送消息（CLI/Cron）
bash
openclaw message send --channel tlon --target "~target-ship" --text "Hello"群组频道：
bash
openclaw message send --channel tlon --target "chat/~host/general" --text "公告内容"常见问题
连接失败？ 检查舰队 URL 是否可访问，登录码是否有效（登录码会过期，需重新生成）。
群组中不响应？
确认 requireMention 设置，在群组中必须 @Bot 舰队名称。
内网舰队收不到消息？
确认已设置 allowPrivateNetwork: true，且 OpenClaw Gateway 和舰队在同一网络。
原文：Tlon - OpenClaw | 来源：OpenClaw 官方文档