Tlon (plugin)

Tlon là ứng dụng nhắn tin phi tập trung được xây dựng trên Urbit. OpenClaw kết nối với Urbit ship của các bạn và có thể trả lời tin nhắn DM cũng như tin nhắn trong nhóm. Với tin nhắn nhóm, mặc định bot chỉ trả lời khi được @ mention, và các bạn có thể giới hạn thêm bằng allowlist.

Tình trạng: được hỗ trợ qua plugin. Hỗ trợ DM, group mention, thread reply, và fallback media dạng text (URL được thêm vào caption). Không hỗ trợ reaction, poll và upload media trực tiếp.

Cần cài plugin

Tlon được cung cấp dưới dạng plugin và không có sẵn trong bản cài đặt core.

Cài qua CLI (npm registry):

openclaw plugins install @openclaw/tlon

Cài từ local (khi chạy từ git repo):

openclaw plugins install ./extensions/tlon

Chi tiết: Plugins

Thiết lập

1. Cài plugin Tlon.
2. Lấy ship URL và login code của các bạn.
3. Cấu hình channels.tlon.
4. Khởi động lại Gateway.
5. Nhắn tin DM cho bot hoặc mention nó trong channel nhóm.

Config tối thiểu (một tài khoản):

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

Group channels

Auto-discovery được bật mặc định. Các bạn cũng có thể pin channel thủ công:

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

Tắt auto-discovery:

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

Kiểm soát truy cập

DM allowlist (để trống = cho phép tất cả):

{
  channels: {
    tlon: {
      dmAllowlist: ["~zod", "~nec"],
    },
  },
}

Group authorization (mặc định là restricted):

{
  channels: {
    tlon: {
      defaultAuthorizedShips: ["~zod"],
      authorization: {
        channelRules: {
          "chat/~host-ship/general": {
            mode: "restricted",
            allowedShips: ["~zod", "~nec"],
          },
          "chat/~host-ship/announcements": {
            mode: "open",
          },
        },
      },
    },
  },
}

Delivery targets (CLI/cron)

Dùng với openclaw message send hoặc cron delivery:

• DM: ~sampel-palnet hoặc dm/~sampel-palnet
• Group: chat/~host-ship/channel hoặc group:~host-ship/channel

Lưu ý

• Tin nhắn nhóm cần mention (ví dụ ~your-bot-ship) thì bot mới trả lời.
• Thread reply: nếu tin nhắn đến nằm trong thread, OpenClaw sẽ trả lời trong thread đó.
• Media: sendMedia sẽ fallback về text + URL (không upload trực tiếp).