Developer and self-hosted

Tlon

Tlon là trình 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 bạn và có thể phản hồi DM cũng như tin nhắn trò chuyện nhóm. Theo mặc định, phản hồi trong nhóm yêu cầu nhắc đến bằng @ và có thể được hạn chế thêm qua danh sách cho phép.

Trạng thái: Plugin đi kèm. DM, nhắc đến trong nhóm, phản hồi trong luồng, định dạng văn bản phong phú và tải ảnh lên đều được hỗ trợ. Phản ứng và cuộc thăm dò chưa được hỗ trợ.

Plugin đi kèm

Tlon được phát hành dưới dạng Plugin đi kèm trong các bản phát hành OpenClaw hiện tại, vì vậy các bản dựng đóng gói thông thường không cần cài đặt riêng.

Nếu bạn đang dùng bản dựng cũ hơn hoặc bản cài đặt tùy chỉnh loại trừ Tlon, hãy cài đặt một gói npm hiện tại:

Cài đặt qua CLI (npm registry):

openclaw plugins install @openclaw/tlon

Dùng gói không kèm phiên bản để theo dõi thẻ phát hành chính thức hiện tại. Chỉ ghim một phiên bản chính xác khi bạn cần bản cài đặt có thể tái lập.

Bản checkout cục bộ (khi chạy từ git repo):

openclaw plugins install ./path/to/local/tlon-plugin

Chi tiết: Plugins

Thiết lập

Đảm bảo Plugin Tlon có sẵn.
- Các bản phát hành OpenClaw đóng gói hiện tại đã đi kèm Plugin này.
- Các bản cài đặt cũ hơn/tùy chỉnh có thể thêm thủ công bằng các lệnh ở trên.
Lấy URL ship và mã đăng nhập của bạn.
Cấu hình channels.tlon.
Khởi động lại Gateway.
DM bot hoặc nhắc đến bot trong kênh nhóm.

Cấu hình 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",
      ownerShip: "~your-main-ship", // recommended: your ship, always allowed
    },
  },
}

Ship riêng tư/LAN

Theo mặc định, OpenClaw chặn hostname và dải IP riêng tư/nội bộ để bảo vệ khỏi SSRF. Nếu ship của bạn đang chạy trên mạng riêng tư (localhost, IP LAN hoặc hostname nội bộ), bạn phải bật rõ ràng:

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

Điều này áp dụng cho các URL như:

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

⚠️ Chỉ bật tùy chọn này nếu bạn tin tưởng mạng cục bộ của mình. Thiết lập này vô hiệu hóa các biện pháp bảo vệ SSRF cho các yêu cầu tới URL ship của bạn.

Kênh nhóm

Tự động khám phá được bật theo mặc định. Bạn cũng có thể ghim kênh thủ công:

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

Tắt tự động khám phá:

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

Kiểm soát truy cập

Danh sách cho phép DM (trống = không cho phép DM, dùng ownerShip cho luồng phê duyệt):

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

Ủy quyền nhóm (mặc định bị hạn chế):

{
  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

Đặt một owner ship để nhận yêu cầu phê duyệt khi người dùng chưa được ủy quyền cố gắng tương tác:

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

Owner ship được tự động ủy quyền ở mọi nơi — lời mời DM được tự động chấp nhận và tin nhắn kênh luôn được phép. Bạn không cần thêm owner vào dmAllowlist hoặc defaultAuthorizedShips.

Khi được đặt, owner nhận thông báo DM cho:

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

Thiết lập tự động chấp nhận

Tự động chấp nhận lời mời DM (cho các ship trong dmAllowlist):

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

Tự động chấp nhận lời mời nhóm từ các ship đáng tin cậy:

{
  channels: {
    tlon: {
      autoAcceptGroupInvites: true,
      groupInviteAllowlist: ["~zod"],
    },
  },
}

autoAcceptGroupInvites mặc định từ chối an toàn khi groupInviteAllowlist trống. Đặt danh sách cho phép thành các ship có lời mời nhóm cần được tự động chấp nhận.

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

Dùng các mục tiêu này với openclaw message send hoặc gửi qua 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

Plugin Tlon bao gồm một kỹ năng đi kèm (@tloncorp/tlon-skill) cung cấp quyền truy cập CLI vào các thao tác Tlon:

Liên hệ: lấy/cập nhật hồ sơ, liệt kê liên hệ
Kênh: liệt kê, tạo, đăng tin nhắn, lấy lịch sử
Nhóm: liệt kê, tạo, quản lý thành viên
DM: gửi tin nhắn, phản ứng với tin nhắn
Phản ứng: thêm/xóa phản ứng emoji vào bài đăng và DM
Thiết lập: quản lý quyền Plugin qua lệnh slash

Kỹ năng này tự động có sẵn khi Plugin được cài đặt.

Khả năng

Tính năng	Trạng thái
Tin nhắn trực tiếp	✅ Được hỗ trợ
Nhóm/kênh	✅ Được hỗ trợ (mặc định yêu cầu nhắc đến)
Luồng	✅ Được hỗ trợ (tự động phản hồi trong luồng)
Văn bản phong phú	✅ Markdown được chuyển đổi sang định dạng Tlon
Hình ảnh	✅ Được tải lên bộ nhớ Tlon
Phản ứng	✅ Qua kỹ năng đi kèm
Cuộc thăm dò	❌ Chưa được hỗ trợ
Lệnh gốc	✅ Được hỗ trợ (mặc định chỉ owner)

Khắc phục sự cố

Chạy thang kiểm tra này trước:

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

Các lỗi thường gặp:

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

Tham chiếu cấu hình

Cấu hình đầy đủ: Cấu hình

Tùy chọn nhà cung cấp:

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

Ghi chú

Phản hồi nhóm yêu cầu nhắc đến (ví dụ ~your-bot-ship) để phản hồi.
Phản hồi trong luồng: nếu tin nhắn đến nằm trong một luồng, OpenClaw phản hồi trong luồng.
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 bộ nhớ Tlon và nhúng dưới dạng khối hình ảnh.

Liên quan

Tổng quan về kênh — tất cả kênh được hỗ trợ
Ghép nối — xác thực DM và luồng ghép nối
Nhóm — hành vi trò chuyện nhóm và cơ chế yêu cầu nhắc đến
Định tuyến kênh — định tuyến phiên cho tin nhắn
Bảo mật — mô hình truy cập và gia cố

# Plugin đi kèm

# Thiết lập

# Ship riêng tư/LAN

# Kênh nhóm

# Kiểm soát truy cập

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

# Thiết lập tự động chấp nhận

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

# Kỹ năng đi kèm

# Khả năng

# Khắc phục sự cố

# Tham chiếu cấu hình

# Ghi chú

# Liên quan