Tlon

Tlon adalah perpesanan terdesentralisasi yang dibangun di atas Urbit. OpenClaw terhubung ke kapal Urbit Anda dan merespons pesan langsung serta pesan obrolan grup. Secara default, balasan grup memerlukan penyebutan @, dengan aturan otorisasi dan alur persetujuan pemilik yang diterapkan di atasnya.

Status: plugin bawaan. Pesan langsung, penyebutan grup, utas, teks kaya, pengunggahan/pengunduhan gambar, dan sistem persetujuan pemilik didukung. Reaksi dan jajak pendapat tidak didukung.

Plugin bawaan

Tlon disertakan dalam rilis OpenClaw saat ini; build terpaket tidak memerlukan instalasi terpisah.

Pada build lama atau instalasi khusus yang tidak menyertakannya, instal dari npm:

openclaw plugins install @openclaw/tlon

Gunakan nama paket tanpa versi untuk mengikuti tag rilis saat ini. Sematkan versi (@openclaw/tlon@x.y.z) hanya untuk instalasi yang dapat direproduksi.

Dari checkout lokal:

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

Detail: Plugin

Penyiapan

openclaw channels add --channel tlon --ship ~sampel-palnet --url https://your-ship-host --code lidlut-tabwed-pillex-ridrup

Atau edit konfigurasi secara langsung:

{  channels: {    tlon: {      enabled: true,      ship: "~sampel-palnet",      url: "https://your-ship-host",      code: "lidlut-tabwed-pillex-ridrup",      ownerShip: "~your-main-ship", // disarankan: kapal Anda, selalu diotorisasi    },  },}

Mulai ulang Gateway setelah mengedit konfigurasi secara langsung. Kemudian kirim pesan langsung ke bot atau sebut bot dengan @ di saluran grup.

Kapal privat/LAN

Secara default, OpenClaw memblokir nama host dan rentang IP privat/internal untuk perlindungan SSRF. Jika kapal Anda berjalan di jaringan privat (localhost, IP LAN, nama host internal), aktifkan secara eksplisit:

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

Berlaku untuk target seperti http://localhost:8080, http://192.168.x.x:8080, dan http://my-ship.local:8080. Aktifkan ini hanya untuk URL kapal yang Anda percayai; tindakan ini menonaktifkan perlindungan SSRF untuk permintaan HTTP akun tersebut.

Saluran grup

Sematkan saluran secara manual, atau aktifkan penemuan otomatis:

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

autoDiscoverChannels secara default bernilai false jika tidak ditetapkan dalam konfigurasi; wisaya penyiapan secara default memilih ya pada perintah dan menulis true secara eksplisit. Saat diaktifkan, OpenClaw melakukan scry pada grup yang telah diikuti saat dimulai, memantau saluran baru ketika undangan grup diterima, dan memeriksa ulang setiap 2 menit.

Kontrol akses

Daftar izin pesan langsung (kosong = pesan langsung tidak diizinkan kecuali pengirim adalah ownerShip):

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

Otorisasi grup secara default adalah restricted untuk setiap saluran. Tetapkan defaultAuthorizedShips sebagai dasar, lalu timpa untuk setiap sarang saluran:

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

Setelah bot membalas di dalam sebuah utas, bot akan terus merespons pesan berikutnya dalam utas tersebut tanpa memerlukan penyebutan lagi.

Sistem pemilik dan persetujuan

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

Kapal pemilik diotorisasi di mana saja: undangan pesan langsung selalu diterima otomatis, undangan grup selalu diterima otomatis, dan pesan saluran selalu lolos otorisasi. Pemilik tidak perlu tercantum dalam dmAllowlist, defaultAuthorizedShips, atau groupInviteAllowlist.

Saat ownerShip ditetapkan, permintaan yang tidak diotorisasi tidak sekadar dibuang — permintaan tersebut dimasukkan ke antrean persetujuan tertunda dan pesan langsung dikirimkan kepada pemilik:

• Permintaan pesan langsung dari kapal yang tidak ada di dmAllowlist
• Penyebutan di saluran ketika pengirim gagal melewati otorisasi
• Undangan grup dari kapal yang tidak ada di groupInviteAllowlist (saat penerimaan otomatis dinonaktifkan, atau diaktifkan tetapi pengundang tidak ada dalam daftar izin)

Pemilik membalas melalui pesan langsung untuk menindaklanjuti permintaan:

Tanpa ownerShip yang dikonfigurasi, pesan langsung dan penyebutan saluran yang tidak diotorisasi hanya dibuang dan dicatat; tidak ada permintaan persetujuan.

Pengaturan penerimaan otomatis

Terima otomatis undangan pesan langsung dari kapal yang sudah ada di dmAllowlist (pemilik selalu diterima otomatis terlepas dari tanda ini):

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

Terima otomatis undangan grup dari daftar izin (gagal secara tertutup: dengan autoAcceptGroupInvites: true dan groupInviteAllowlist kosong, tidak ada undangan selain dari pemilik yang diterima):

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

Muat ulang langsung melalui penyimpanan pengaturan Urbit

Sebagian besar pengaturan di atas (dmAllowlist, groupInviteAllowlist, groupChannels, defaultAuthorizedShips, autoDiscoverChannels, autoAcceptDmInvites, autoAcceptGroupInvites, ownerShip, showModelSignature) dicerminkan ke agen %settings milik kapal (desk moltbot, bucket tlon) pada proses pertama dan kemudian dibaca secara langsung dari sana, sehingga perubahan yang dibuat melalui klien Landscape atau perintah pengaturan keterampilan bawaan diterapkan tanpa memulai ulang Gateway. channelRules dan persetujuan tertunda juga disimpan di sana sebagai JSON. Konfigurasi berkas tetap menjadi sumber kebenaran untuk nilai yang tidak pernah ditulis ke penyimpanan pengaturan.

Target pengiriman (CLI/Cron)

Gunakan dengan openclaw message send atau pengiriman Cron:

• Pesan langsung: ~sampel-palnet atau dm/~sampel-palnet
• Grup: chat/~host-ship/channel atau group:~host-ship/channel

Keterampilan bawaan

Plugin menyertakan @tloncorp/tlon-skill, sebuah CLI untuk operasi Urbit langsung, yang tersedia secara otomatis setelah plugin diinstal:

• Aktivitas: penyebutan, balasan, pesan belum dibaca
• Saluran: tampilkan, buat, ganti nama
• Kontak: tampilkan/ambil/perbarui profil
• Grup: buat, gabung, alur undangan/permintaan, peran
• Kait: kelola kait saluran
• Pesan: riwayat, pencarian
• Pesan langsung: kirim, beri reaksi, terima/tolak
• Kiriman: beri reaksi, hapus
• Buku catatan: kirim ke saluran buku harian
• Pengaturan: muat ulang langsung konfigurasi plugin melalui penyimpanan pengaturan di atas

Kemampuan

Pemecahan masalah

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctor

Kegagalan umum:

• Pesan langsung diabaikan: pengirim tidak ada di dmAllowlist dan tidak ada ownerShip yang dikonfigurasi untuk alur persetujuan.
• Pesan grup diabaikan: saluran tidak ditemukan/disematkan, atau pengirim gagal melewati otorisasi tanpa ownerShip untuk mengantrekan persetujuan.
• Kesalahan koneksi: periksa apakah URL kapal dapat dijangkau; tetapkan network.dangerouslyAllowPrivateNetwork untuk kapal lokal.
• Kesalahan autentikasi: kode masuk berganti secara berkala — salin kode saat ini dari kapal Anda.

Referensi konfigurasi

Konfigurasi lengkap: Konfigurasi

Catatan

• Balasan grup memerlukan penyebutan @ (mis. ~your-bot-ship) kecuali bot sudah bergabung dengan utas tersebut.
• Balasan utas masuk ke dalam utas; bot juga menerima 10 pesan terakhir dari konteks utas yang ditambahkan di depan untuk agen.
• Teks kaya (tebal, miring, kode, judul, daftar) dikonversi ke format bawaan Tlon.
• Mengirim pesan masuk yang meminta ringkasan saluran (misalnya "rangkum saluran ini") memicu perangkuman riwayat bawaan sebagai pengganti alur balasan normal.

Terkait

• Ikhtisar Saluran — semua saluran yang didukung
• Pemasangan — autentikasi pesan langsung dan alur pemasangan
• Grup — perilaku obrolan grup dan persyaratan penyebutan
• Perutean Saluran — perutean sesi untuk pesan
• Keamanan — model akses dan penguatan