Tlon

Tlon, Urbit üzerine kurulmuş merkeziyetsiz bir mesajlaşma uygulamasıdır. OpenClaw, Urbit geminize bağlanır ve DM'lere ve grup sohbeti mesajlarına yanıt verir. Grup yanıtları varsayılan olarak @ ile bahsetme gerektirir; bunun üzerine yetkilendirme kuralları ve bir sahip onay akışı uygulanır.

Durum: paketle birlikte gelen plugin. DM'ler, grup bahsetmeleri, ileti dizileri, zengin metin, görsel yükleme/indirme ve bir sahip onay sistemi desteklenir. Tepkiler ve anketler desteklenmez.

Paketle birlikte gelen plugin

Tlon, güncel OpenClaw sürümleriyle birlikte gelir; paketlenmiş derlemeler ayrı bir kurulum gerektirmez.

Tlon'u içermeyen eski bir derlemede veya özel kurulumda npm'den yükleyin:

openclaw plugins install @openclaw/tlon

Güncel sürüm etiketini izlemek için yalnızca paket adını kullanın. Yalnızca tekrarlanabilir kurulumlar için bir sürümü (@openclaw/tlon@x.y.z) sabitleyin.

Yerel bir çalışma kopyasından:

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

Ayrıntılar: Plugin'ler

Kurulum

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

Veya yapılandırmayı doğrudan düzenleyin:

{  channels: {    tlon: {      enabled: true,      ship: "~sampel-palnet",      url: "https://your-ship-host",      code: "lidlut-tabwed-pillex-ridrup",      ownerShip: "~your-main-ship", // önerilen: geminiz, her zaman yetkilidir    },  },}

Yapılandırmayı doğrudan düzenledikten sonra Gateway'i yeniden başlatın. Ardından bota DM gönderin veya bir grup kanalında @ ile bottan bahsedin.

Gelen iletilerin dayanıklılığı

OpenClaw, kabul edilen Tlon DM ve grup sohbeti olaylarını aracıya göndermeden önce kalıcı hâle getirir. Bekleyen veya yeniden denenebilir işlemler Gateway yeniden başlatıldığında korunur ve işler grup kanalı ya da doğrudan eş başına sıralı kalır. Kararlı Urbit mesaj kimlikleri de kuyruk kaydı veya saklanan tamamlanma kaydı mevcut olduğu sürece yeniden teslim edilen bir olayı engeller.

Kuyruktan aracıya geçiş sınırında teslimat en az bir kez gerçekleşir: devir sırasında oluşan bir çökme, bir işlemin yeniden yürütülmesine neden olabilir. Bu nedenle dış yan etkiler oluşturan aracı eylemleri, uygulanabilir olduğunda idempotent kalmalıdır.

Özel/LAN gemileri

OpenClaw, SSRF koruması için özel/dahili ana bilgisayar adlarını ve IP aralıklarını varsayılan olarak engeller. Geminiz özel bir ağda (localhost, LAN IP'si, dahili ana bilgisayar adı) çalışıyorsa açıkça izin verin:

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

http://localhost:8080, http://192.168.x.x:8080 ve http://my-ship.local:8080 gibi hedefler için geçerlidir. Bunu yalnızca güvendiğiniz bir gemi URL'si için etkinleştirin; ilgili hesabın HTTP isteklerinde SSRF korumasını devre dışı bırakır.

Grup kanalları

Kanalları elle sabitleyin veya otomatik keşfi açın:

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

autoDiscoverChannels, yapılandırmada ayarlanmadığında varsayılan olarak false değerini alır; kurulum sihirbazı istem için varsayılan olarak evet seçeneğini sunar ve true değerini açıkça yazar. Bu özellik açıkken OpenClaw, başlangıçta katılınan grupları sorgular, grup davetleri kabul edildikçe yeni kanalları izler ve her 2 dakikada bir yeniden kontrol eder.

Erişim denetimi

DM izin listesi (boş = gönderen ownerShip olmadığı sürece hiçbir DM'ye izin verilmez):

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

Grup yetkilendirmesi kanal başına varsayılan olarak restricted değerini kullanır. Bir temel değer için defaultAuthorizedShips ayarını yapın ve kanal yuvası başına geçersiz kılın:

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

Bot bir ileti dizisinde yanıt verdikten sonra, yeniden bahsedilmesi gerekmeden o ileti dizisindeki sonraki mesajlara yanıt vermeyi sürdürür.

Bu takip yanıtlarında yeniden açıkça bahsedilmesini zorunlu kılmak için channels.tlon.implicitMentions.threadParticipation: false ayarını yapın. Hesap geçersiz kılmaları channels.tlon.accounts.<id>.implicitMentions kullanır. Tlon şu anda replyToBot veya quotedBot olgularını üretmediğinden bu bayrakların burada hiçbir etkisi yoktur.

Sahip ve onay sistemi

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

Sahip gemi her yerde yetkilidir: DM davetleri her zaman otomatik kabul edilir, grup davetleri her zaman otomatik kabul edilir ve kanal mesajları her zaman yetkilendirmeden geçer. Sahibin dmAllowlist, defaultAuthorizedShips veya groupInviteAllowlist içinde bulunması gerekmez.

ownerShip ayarlandığında yetkisiz istekler yalnızca yok sayılmaz; bekleyen bir onay kuyruğuna alınır ve sahibine DM gönderilir:

• dmAllowlist üzerinde olmayan gemilerden gelen DM istekleri
• Gönderenin yetkilendirmeyi geçemediği kanallardaki bahsetmeler
• groupInviteAllowlist üzerinde olmayan gemilerden gelen grup davetleri (otomatik kabul kapalıysa veya açık olmasına rağmen davet eden izin listesinde değilse)

Sahip, bir istek üzerinde işlem yapmak için DM ile yanıt verir:

ownerShip yapılandırılmadığında yetkisiz DM'ler ve kanal bahsetmeleri yalnızca yok sayılır ve günlüğe kaydedilir; onay istemi gösterilmez.

Otomatik kabul ayarları

dmAllowlist üzerinde bulunan gemilerden gelen DM davetlerini otomatik kabul edin (bu bayraktan bağımsız olarak sahip her zaman otomatik kabul edilir):

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

Bir izin listesindeki grup davetlerini otomatik kabul edin (güvenli biçimde reddeder: autoAcceptGroupInvites: true etkin ve groupInviteAllowlist boş olduğunda sahip dışındaki hiçbir davet kabul edilmez):

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

Urbit ayarlar deposu üzerinden çalışırken yeniden yükleme

Yukarıdaki ayarların çoğu (dmAllowlist, groupInviteAllowlist, groupChannels, defaultAuthorizedShips, autoDiscoverChannels, autoAcceptDmInvites, autoAcceptGroupInvites, ownerShip, showModelSignature) ilk çalıştırmada geminin %settings aracısına (masa moltbot, demet tlon) yansıtılır ve ardından doğrudan buradan okunur; bu nedenle bir Landscape istemcisi veya paketle birlikte gelen skill'in ayar komutlarıyla yapılan değişiklikler Gateway yeniden başlatılmadan uygulanır. channelRules ve bekleyen onaylar da burada JSON olarak kalıcı hâle getirilir. Dosya yapılandırması, ayarlar deposuna hiç yazılmamış değerlerin doğruluk kaynağı olmaya devam eder.

Teslimat hedefleri (CLI/cron)

openclaw message send veya cron teslimatıyla kullanın:

• DM: ~sampel-palnet veya dm/~sampel-palnet
• Grup: chat/~host-ship/channel veya group:~host-ship/channel

Paketle birlikte gelen skill

Plugin, doğrudan Urbit işlemleri için bir CLI olan @tloncorp/tlon-skill aracını paketle birlikte sunar; plugin yüklendikten sonra otomatik olarak kullanılabilir:

• Etkinlik: bahsetmeler, yanıtlar, okunmamışlar
• Kanallar: listeleme, oluşturma, yeniden adlandırma
• Kişiler: profilleri listeleme/alma/güncelleme
• Gruplar: oluşturma, katılma, davet/istek akışları, roller
• Kancalar: kanal kancalarını yönetme
• Mesajlar: geçmiş, arama
• DM'ler: gönderme, tepki verme, kabul etme/reddetme
• Gönderiler: tepki verme, silme
• Not Defteri: günlük kanallarına gönderi yayımlama
• Ayarlar: yukarıdaki ayarlar deposu üzerinden plugin yapılandırmasını çalışırken yeniden yükleme

Yetenekler

Sorun giderme

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctor

Yaygın hatalar:

• DM'ler yok sayılıyor: gönderen dmAllowlist içinde değil ve onay akışı için ownerShip yapılandırılmamış.
• Grup mesajları yok sayılıyor: kanal keşfedilmemiş/sabitlenmemiş veya gönderen yetkilendirmeyi geçemiyor ve onayı kuyruğa almak için ownerShip bulunmuyor.
• Bağlantı hataları: gemi URL'sine erişilebildiğini kontrol edin; yerel gemiler için network.dangerouslyAllowPrivateNetwork ayarını yapın.
• Kimlik doğrulama hataları: giriş kodları dönüşümlüdür; güncel kodu geminizden kopyalayın.

Yapılandırma referansı

Tam yapılandırma: Yapılandırma

Notlar

• Bot ilgili ileti dizisine zaten katılmadıysa grup yanıtları bir @ bahsi (ör. ~your-bot-ship) gerektirir.
• İleti dizisi yanıtları ilgili ileti dizisine gönderilir; ayrıca ileti dizisi bağlamındaki son 10 mesaj agent için başa eklenerek bota iletilir.
• Zengin metin (kalın, italik, kod, başlıklar, listeler) Tlon'un yerel biçimine dönüştürülür.
• Kanal özeti isteyen bir gelen mesajın (örneğin "bu kanalı özetle") gönderilmesi, normal yanıt akışı yerine yerleşik geçmiş özetlemeyi tetikler.

İlgili

• Kanallara Genel Bakış — desteklenen tüm kanallar
• Eşleştirme — DM kimlik doğrulaması ve eşleştirme akışı
• Gruplar — grup sohbeti davranışı ve bahsetme kısıtlaması
• Kanal Yönlendirme — mesajlar için oturum yönlendirmesi
• Güvenlik — erişim modeli ve güvenliği güçlendirme