Tlon(插件)

Tlon 是构建在 Urbit 上的去中心化消息应用。OpenClaw 连接到你�?Urbit ship,可以回复私聊和群组聊天消息。群组回复默认需�?@提及,并且可以通过允许列表进一步限制�?

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

需要插�?

Tlon 作为插件提供,不随核心安装一起打包�?

通过 CLI 安装(npm 注册表)�?

openclaw plugins install @openclaw/tlon

本地检出(�?git 仓库运行时)�?

openclaw plugins install ./extensions/tlon

详情:Plugins

设置

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

私有/LAN 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,
    },
  },
}

访问控制

私聊允许列表(空 = 允许所有)�?

{
  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(无原生上传)�?