Tlon (plugin)

Tlon 是建立在 Urbit 上的去中心化通讯工具。OpenClaw 连接到你的 Urbit ship 并可以响应私信（DM）和群聊消息。群组回复默认需要 @ 提及，可以通过允许列表进一步限制。

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

需要插件

Tlon 作为插件提供，不与核心安装捆绑。

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

openclaw plugins install @openclaw/tlon

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

openclaw plugins install ./extensions/tlon

详细信息：插件（Plugins）

设置

  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"
    }
  }
}

群组频道（Group channels）

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

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

与 openclaw message send 或 cron 传递一起使用：

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

注意事项

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