Tlon(插件)

适用范围

在以下情况使用本页:

  • 开发 Tlon/Urbit 渠道功能

Tlon 是基于 Urbit 构建的去中心化消息传递应用。Clawdbot 连接到您的 Urbit ship, 可以响应私信和群组聊天消息。默认情况下,群组回复需要 @ 提及,并可以通过白名单进一步限制。

状态:通过插件支持。支持私信、群组提及、主题串回复和纯文本媒体回退 (URL 附加到标题)。不支持反应、投票和原生媒体上传。

需要插件

Tlon 以插件形式提供,不包含在核心安装中。

通过 CLI 安装(npm 注册表):

clawdbot plugins install @clawdbot/tlon

本地检出(从 git 仓库运行时):

clawdbot plugins install ./extensions/tlon

详情:插件

设置

  1. 安装 Tlon 插件。
  2. 准备您的 ship URL 和登录代码。
  3. 配置 channels.tlon
  4. 重启 gateway。
  5. 向机器人发送私信或在群组频道中提及它。

最小配置(单账号):

{
  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-palnetdm/~sampel-palnet
  • 群组:chat/~host-ship/channelgroup:~host-ship/channel

注意事项

  • 群组回复需要提及(例如 ~your-bot-ship)才能响应。
  • 主题串回复:如果入站消息在主题串中,Clawdbot 在主题串内回复。
  • 媒体:sendMedia 回退到文本 + URL(无原生上传)。