Tlon（插件）

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

状态：通过插件支持。支持私信、群组提及、线程回复和纯文本媒体回退（URL 追加到标题）。不支持表情回应、投票和原生媒体上传。

---

需要插件

Tlon 作为插件提供，不包含在核心安装中。

通过 CLI 安装（npm 注册表）：

openclaw plugins install @openclaw/tlon

本地检出（从 git 仓库运行时）：

openclaw plugins install ./extensions/tlon

详情：插件

---

设置

1. 安装 Tlon 插件。
2. 收集你的 ship URL 和登录码。
3. 配置 channels.tlon。
4. 重启网关。
5. 向机器人发私信或在群组频道中提及它。

最小配置（单账户）：

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

私有/局域网 ship URL（高级）：

默认情况下，OpenClaw 会阻止此插件的私有/内部主机名和 IP 范围（SSRF 加固）。 如果你的 ship URL 在私有网络上（例如 http://192.168.1.50:8080 或 http://localhost:8080）， 你必须显式选择加入：

{
  channels: {
    tlon: {
      allowPrivateNetwork: true,
    },
  },
}

---

群组频道

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

{
  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/定时任务）

与 openclaw message send 或定时投递一起使用：

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

---

说明

• 群组回复需要提及（例如 ~your-bot-ship）才能响应。
• 线程回复：如果入站消息在线程中，OpenClaw 在线程内回复。
• 媒体：sendMedia 回退到文本 + URL（没有原生上传）。