Tlon(插件)
适用范围
在以下情况使用本页:
- 开发 Tlon/Urbit 渠道功能
Tlon 是基于 Urbit 构建的去中心化消息传递应用。Clawdbot 连接到您的 Urbit ship, 可以响应私信和群组聊天消息。默认情况下,群组回复需要 @ 提及,并可以通过白名单进一步限制。
状态:通过插件支持。支持私信、群组提及、主题串回复和纯文本媒体回退 (URL 附加到标题)。不支持反应、投票和原生媒体上传。
需要插件
Tlon 以插件形式提供,不包含在核心安装中。
通过 CLI 安装(npm 注册表):
clawdbot plugins install @clawdbot/tlon本地检出(从 git 仓库运行时):
clawdbot plugins install ./extensions/tlon详情:插件
设置
- 安装 Tlon 插件。
- 准备您的 ship URL 和登录代码。
- 配置
channels.tlon。 - 重启 gateway。
- 向机器人发送私信或在群组频道中提及它。
最小配置(单账号):
{
channels: {
tlon: {
enabled: true,
ship: "~sampel-palnet",
url: "https://your-ship-host",
code: "lidlut-tabwed-pillex-ridrup"
}
}
}群组频道
默认启用自动发现。您也可以手动固定频道:
{
channels: {
tlon: {
groupChannels: [
"chat/~host-ship/general",
"chat/~host-ship/support"
]
}
}
}禁用自动发现:
{
channels: {
tlon: {
autoDiscoverChannels: false
}
}
}访问控制
私信白名单(空 = 允许所有):
{
channels: {
tlon: {
dmAllowlist: ["~zod", "~nec"]
}
}
}群组授权(默认受限):
{
channels: {
tlon: {
defaultAuthorizedShips: ["~zod"],
authorization: {
channelRules: {
"chat/~host-ship/general": {
mode: "restricted",
allowedShips: ["~zod", "~nec"]
},
"chat/~host-ship/announcements": {
mode: "open"
}
}
}
}
}
}投递目标(CLI/定时任务)
与 clawdbot message send 或定时任务投递一起使用:
- 私信:
~sampel-palnet或dm/~sampel-palnet - 群组:
chat/~host-ship/channel或group:~host-ship/channel
注意事项
- 群组回复需要提及(例如
~your-bot-ship)才能响应。 - 主题串回复:如果入站消息在主题串中,Clawdbot 在主题串内回复。
- 媒体:
sendMedia回退到文本 + URL(无原生上传)。