​

Tlon (plugin)

​

Cần cài đặt plugin

openclaw plugins install @openclaw/tlon

openclaw plugins install ./extensions/tlon

​

Thiết lập

1. Cài đặt plugin Tlon.
2. Thu thập URL tàu và mã đăng nhập của bạn.
3. Cấu hình channels.tlon.
4. Khởi động lại gateway.
5. Gửi DM cho bot hoặc nhắc đến nó trong kênh nhóm.

{
  channels: {
    tlon: {
      enabled: true,
      ship: "~sampel-palnet",
      url: "https://your-ship-host",
      code: "lidlut-tabwed-pillex-ridrup",
      ownerShip: "~your-main-ship", // khuyến nghị: tàu của bạn, luôn được phép
    },
  },
}

​

Tàu riêng/LAN

{
  channels: {
    tlon: {
      url: "http://localhost:8080",
      allowPrivateNetwork: true,
    },
  },
}

• http://localhost:8080
• http://192.168.x.x:8080
• http://my-ship.local:8080

​

Kênh nhóm

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

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

​

Kiểm soát truy cập

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

​

Hệ thống chủ sở hữu và phê duyệt

{
  channels: {
    tlon: {
      ownerShip: "~your-main-ship",
    },
  },
}

• Yêu cầu DM từ các tàu không có trong danh sách cho phép
• Nhắc đến trong các kênh không có ủy quyền
• Yêu cầu mời nhóm

​

Cài đặt tự động chấp nhận

{
  channels: {
    tlon: {
      autoAcceptDmInvites: true,
    },
  },
}

{
  channels: {
    tlon: {
      autoAcceptGroupInvites: true,
    },
  },
}

​

Mục tiêu gửi (CLI/cron)

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

​

Kỹ năng đi kèm

• Liên hệ: lấy/cập nhật hồ sơ, danh sách liên hệ
• Kênh: danh sách, tạo, gửi tin nhắn, lấy lịch sử
• Nhóm: danh sách, tạo, quản lý thành viên
• DMs: gửi tin nhắn, phản hồi tin nhắn
• Phản ứng: thêm/xóa phản ứng emoji cho bài viết và DMs
• Cài đặt: quản lý quyền plugin qua lệnh slash

​

Khả năng

​

Khắc phục sự cố

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor

• DMs bị bỏ qua: người gửi không có trong dmAllowlist và không có ownerShip được cấu hình cho luồng phê duyệt.
• Tin nhắn nhóm bị bỏ qua: kênh không được phát hiện hoặc người gửi không được ủy quyền.
• Lỗi kết nối: kiểm tra URL tàu có thể truy cập; bật allowPrivateNetwork cho tàu cục bộ.
• Lỗi xác thực: xác minh mã đăng nhập hiện tại (mã xoay vòng).

​

Tham chiếu cấu hình

• channels.tlon.enabled: bật/tắt khởi động kênh.
• channels.tlon.ship: tên tàu Urbit của bot (ví dụ: ~sampel-palnet).
• channels.tlon.url: URL tàu (ví dụ: https://sampel-palnet.tlon.network).
• channels.tlon.code: mã đăng nhập tàu.
• channels.tlon.allowPrivateNetwork: cho phép URL localhost/LAN (bỏ qua SSRF).
• channels.tlon.ownerShip: tàu chủ sở hữu cho hệ thống phê duyệt (luôn được phép).
• channels.tlon.dmAllowlist: các tàu được phép DM (trống = không có).
• channels.tlon.autoAcceptDmInvites: tự động chấp nhận DMs từ các tàu trong danh sách cho phép.
• channels.tlon.autoAcceptGroupInvites: tự động chấp nhận tất cả lời mời nhóm.
• channels.tlon.autoDiscoverChannels: tự động phát hiện kênh nhóm (mặc định: true).
• channels.tlon.groupChannels: các kênh được ghim thủ công.
• channels.tlon.defaultAuthorizedShips: các tàu được ủy quyền cho tất cả các kênh.
• channels.tlon.authorization.channelRules: quy tắc ủy quyền theo kênh.
• channels.tlon.showModelSignature: thêm tên mô hình vào tin nhắn.

​

Ghi chú

• Trả lời nhóm yêu cầu một mention (ví dụ: ~your-bot-ship) để phản hồi.
• Trả lời theo chuỗi: nếu tin nhắn đến nằm trong một chuỗi, OpenClaw sẽ trả lời trong chuỗi đó.
• Văn bản phong phú: Định dạng Markdown (in đậm, in nghiêng, mã, tiêu đề, danh sách) được chuyển đổi sang định dạng gốc của Tlon.
• Hình ảnh: URL được tải lên lưu trữ Tlon và nhúng dưới dạng khối hình ảnh.