Tlon (plugin)

Tlon 是一个基于 Urbit 构建的去中心化通讯工具。OpenClaw 可以连接到你的 Urbit ship，并回复 DM 和群组聊天消息。群组回复默认需要 @ 提及，还可以通过白名单进一步限制。

状态：通过 Plugin 支持。支持 DM、群组提及、Thread 回复，以及纯文本媒体回退（URL 附加到说明文字）。不支持 Reactions、投票和原生媒体上传。

需要安装 Plugin

Tlon 以 Plugin 形式提供，不包含在核心安装中。

通过 CLI 安装（npm registry）：

openclaw plugins install @openclaw/tlon

本地安装（从 git 仓库运行时）：

openclaw plugins install ./extensions/tlon

详情：Plugins

设置

1. 安装 Tlon Plugin。
2. 获取你的 ship URL 和登录代码。
3. 配置 channels.tlon。
4. 重启 Gateway。
5. 给机器人发 DM 或在群组 Channel 中提及它。

最小配置（单账号）：

{
  channels: {
    tlon: {
      enabled: true,
      ship: "~sampel-palnet",
      url: "https://your-ship-host",
      code: "lidlut-tabwed-pillex-ridrup",
    },
  },
}

群组 Channel

自动发现默认启用。你也可以手动固定 Channel：

{
  channels: {
    tlon: {
      groupChannels: ["chat/~host-ship/general", "chat/~host-ship/support"],
    },
  },
}

禁用自动发现：

{
  channels: {
    tlon: {
      autoDiscoverChannels: false,
    },
  },
}

访问控制

DM 白名单（留空 = 允许所有）：

{
  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/cron）

配合 openclaw message send 或 cron 投递使用：

• DM：~sampel-palnet 或 dm/~sampel-palnet
• 群组：chat/~host-ship/channel 或 group:~host-ship/channel

注意事项

• 群组回复需要提及（例如 ~your-bot-ship）才会响应。
• Thread 回复：如果收到的消息在 Thread 中，OpenClaw 会在 Thread 内回复。
• 媒体：sendMedia 会回退到文本 + URL（不支持原生上传）。