Tlon

Tlon, Urbit üzerinde oluşturulmuş 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 @ bahsetmesi gerektirir; bunun üzerine yetkilendirme kuralları ve sahip onayı akışı uygulanır.

Durum: paketle birlikte gelen Plugin. DM'ler, grup bahsetmeleri, ileti dizileri, zengin metin, görsel yükleme/indirme ve 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 üzerinden yükleyin:

openclaw plugins install @openclaw/tlon

Güncel sürüm etiketini takip etmek için yalnızca paket adını kullanın. Bir sürümü (@openclaw/tlon@x.y.z) yalnızca yeniden üretilebilir kurulumlar için sabitleyin.

Yerel bir kaynak kod 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

Alternatif olarak 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 yetkilendirilir    },  },}

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 bottan @ ile bahsedin.

Özel/LAN gemileri

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

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

Bu ayar 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 istekleri için 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 belirtilmediğinde varsayılan olarak false değerini alır; kurulum sihirbazı istem için varsayılan olarak evet seçeneğini kullanır ve açıkça true yazar. Etkinleştirildiğinde OpenClaw, başlangıçta katılınan grupları scry yöntemiyle sorgular, grup davetleri kabul edildikçe yeni kanalları izler ve her 2 dakikada bir yeniden denetler.

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ı belirleyin 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, başka bir bahsetme gerektirmeden o ileti dizisindeki sonraki mesajlara yanıt vermeyi sürdürür.

Sahip ve onay sistemi

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

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

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

• dmAllowlist içinde olmayan gemilerden gelen DM istekleri
• Gönderenin yetkilendirmeyi geçemediği kanallardaki bahsetmeler
• groupInviteAllowlist içinde 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 üzerinden 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ı

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

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

Bir izin listesindeki grup davetlerini otomatik olarak kabul edin (güvenli biçimde kapalı kalır: autoAcceptGroupInvites: true ve boş bir groupInviteAllowlist ile sahip dışındaki hiçbir davet kabul edilmez):

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

Urbit ayar 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, bölüm tlon) yansıtılır ve sonrasında canlı olarak oradan okunur. Bu nedenle bir Landscape istemcisi veya paketle gelen Skill'ın ayar komutları üzerinden 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. Ayar deposuna hiçbir zaman yazılmayan değerler için dosya yapılandırması 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 paketini içerir ve 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önderme
• Ayarlar: yukarıdaki ayar 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 bir ownerShip yok.
• Bağlantı hataları: gemi URL'sinin erişilebilir olduğunu denetleyin; yerel gemiler için network.dangerouslyAllowPrivateNetwork ayarını belirleyin.
• Kimlik doğrulama hataları: oturum açma kodları dönüşümlü olarak değişir; güncel kodu geminizden kopyalayın.

Yapılandırma başvurusu

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

Notlar

• Bot ilgili ileti dizisine zaten katılmadıysa grup yanıtları @ bahsetmesi (ör. ~your-bot-ship) gerektirir.
• İleti dizisi yanıtları ileti dizisinin içine gönderilir; ayrıca ileti dizisi bağlamının son 10 mesajı aracının bağlamının başına eklenir.
• 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 gönderilmesi (örneğin "bu kanalı özetle"), normal yanıt akışı yerine yerleşik geçmiş özetlemeyi tetikler.

İlgili konular

• 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 gereksinimi
• Kanal Yönlendirme — mesajlar için oturum yönlendirme
• Güvenlik — erişim modeli ve güvenliği güçlendirme