Developer and self-hosted

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 verebilir. Grup yanıtları varsayılan olarak @ bahsi gerektirir ve izin listeleriyle daha da kısıtlanabilir.

Durum: paketle birlikte gelen Plugin. DM'ler, grup bahisleri, ileti dizisi yanıtları, zengin metin biçimlendirmesi ve görsel yüklemeleri desteklenir. Tepkiler ve anketler henüz desteklenmez.

Paketle birlikte gelen Plugin

Tlon, güncel OpenClaw sürümlerinde paketle birlikte gelen bir Plugin olarak sunulur; bu nedenle normal paketlenmiş derlemeler ayrı bir kurulum gerektirmez.

Daha eski bir derlemedeyseniz veya Tlon'u hariç tutan özel bir kurulum kullanıyorsanız, güncel bir npm paketi kurun:

CLI ile kurulum (npm kayıt deposu):

openclaw plugins install @openclaw/tlon

Güncel resmi sürüm etiketini takip etmek için yalın paketi kullanın. Kesin bir sürümü yalnızca tekrarlanabilir bir kurulum gerektiğinde sabitleyin.

Yerel checkout (bir git deposundan çalıştırırken):

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

Ayrıntılar: Plugins

Kurulum

Tlon Plugin'inin kullanılabilir olduğundan emin olun.
- Güncel paketlenmiş OpenClaw sürümleri bunu zaten içerir.
- Daha eski/özel kurulumlar yukarıdaki komutlarla bunu elle ekleyebilir.
Gemi URL'nizi ve oturum açma kodunuzu alın.
channels.tlon yapılandırmasını ayarlayın.
Gateway'i yeniden başlatın.
Bota DM gönderin veya bir grup kanalında ondan bahsedin.

En küçük yapılandırma (tek hesap):

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

Özel/LAN gemileri

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

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

Bu, şu gibi URL'ler için geçerlidir:

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

⚠️ Bunu yalnızca yerel ağınıza güveniyorsanız etkinleştirin. Bu ayar, gemi URL'nize yapılan istekler için SSRF korumalarını devre dışı bırakır.

Grup kanalları

Otomatik keşif varsayılan olarak etkindir. Kanalları elle de sabitleyebilirsiniz:

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

Otomatik keşfi devre dışı bırakın:

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

Erişim denetimi

DM izin listesi (boş = DM'lere izin verilmez, onay akışı için ownerShip kullanın):

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

Grup yetkilendirmesi (varsayılan olarak kısıtlı):

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

Sahip ve onay sistemi

Yetkisiz kullanıcılar etkileşim kurmaya çalıştığında onay isteklerini almak için bir sahip gemi ayarlayın:

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

Sahip gemi her yerde otomatik olarak yetkilendirilir — DM davetleri otomatik kabul edilir ve kanal mesajlarına her zaman izin verilir. Sahibi dmAllowlist veya defaultAuthorizedShips içine eklemeniz gerekmez.

Ayarlandığında, sahip şu durumlar için DM bildirimleri alır:

İzin listesinde olmayan gemilerden gelen DM istekleri
Yetkilendirme bulunmayan kanallardaki bahisler
Grup davet istekleri

Otomatik kabul ayarları

DM davetlerini otomatik kabul etme (dmAllowlist içindeki gemiler için):

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

Güvenilen gemilerden gelen grup davetlerini otomatik kabul etme:

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

autoAcceptGroupInvites, groupInviteAllowlist boş olduğunda kapalı kalarak başarısız olur. İzin listesini, grup davetleri otomatik olarak kabul edilecek gemilerle ayarlayın.

Teslim hedefleri (CLI/Cron)

Bunları openclaw message send veya Cron teslimi ile kullanın:

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

Paketle birlikte gelen yetenek

Tlon Plugin'i, Tlon işlemlerine CLI erişimi sağlayan paketle birlikte gelen bir yetenek (@tloncorp/tlon-skill) içerir:

Kişiler: profilleri alma/güncelleme, kişileri listeleme
Kanallar: listeleme, oluşturma, mesaj gönderme, geçmişi getirme
Gruplar: listeleme, oluşturma, üyeleri yönetme
DM'ler: mesaj gönderme, mesajlara tepki verme
Tepkiler: gönderilere ve DM'lere emoji tepkileri ekleme/kaldırma
Ayarlar: eğik çizgi komutlarıyla Plugin izinlerini yönetme

Bu yetenek, Plugin kurulduğunda otomatik olarak kullanılabilir olur.

Yetenekler

Özellik	Durum
Doğrudan mesajlar	✅ Desteklenir
Gruplar/kanallar	✅ Desteklenir (varsayılan olarak bahis gerektirir)
İleti dizileri	✅ Desteklenir (ileti dizisinde otomatik yanıtlar)
Zengin metin	✅ Markdown, Tlon biçimine dönüştürülür
Görseller	✅ Tlon depolamasına yüklenir
Tepkiler	✅ Paketle birlikte gelen yetenek aracılığıyla
Anketler	❌ Henüz desteklenmez
Yerel komutlar	✅ Desteklenir (varsayılan olarak yalnızca sahip)

Sorun giderme

Önce bu merdiveni çalıştırın:

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw 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ş veya gönderen yetkilendirilmemiş.
Bağlantı hataları: gemi URL'sinin erişilebilir olduğunu kontrol edin; yerel gemiler için allowPrivateNetwork etkinleştirin.
Kimlik doğrulama hataları: oturum açma kodunun güncel olduğunu doğrulayın (kodlar döner).

Yapılandırma başvurusu

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

Sağlayıcı seçenekleri:

channels.tlon.enabled: kanal başlatmayı etkinleştir/devre dışı bırak.
channels.tlon.ship: botun Urbit gemi adı (örn. ~sampel-palnet).
channels.tlon.url: gemi URL'si (örn. https://sampel-palnet.tlon.network).
channels.tlon.code: gemi oturum açma kodu.
channels.tlon.allowPrivateNetwork: localhost/LAN URL'lerine izin ver (SSRF atlaması).
channels.tlon.ownerShip: onay sistemi için sahip gemi (her zaman yetkilidir).
channels.tlon.dmAllowlist: DM göndermesine izin verilen gemiler (boş = hiçbiri).
channels.tlon.autoAcceptDmInvites: izin listesindeki gemilerden gelen DM'leri otomatik kabul et.
channels.tlon.autoAcceptGroupInvites: izin listesindeki gemilerden gelen grup davetlerini otomatik kabul et.
channels.tlon.groupInviteAllowlist: grup davetleri otomatik kabul edilebilecek gemiler.
channels.tlon.autoDiscoverChannels: grup kanallarını otomatik keşfet (varsayılan: true).
channels.tlon.groupChannels: elle sabitlenmiş kanal yuvaları.
channels.tlon.defaultAuthorizedShips: tüm kanallar için yetkilendirilmiş gemiler.
channels.tlon.authorization.channelRules: kanal başına kimlik doğrulama kuralları.
channels.tlon.showModelSignature: mesajlara model adını ekle.

Notlar

Grup yanıtları, yanıt vermek için bir bahis gerektirir (örn. ~your-bot-ship).
İleti dizisi yanıtları: gelen mesaj bir ileti dizisindeyse OpenClaw ileti dizisi içinde yanıtlar.
Zengin metin: Markdown biçimlendirmesi (kalın, italik, kod, başlıklar, listeler) Tlon'un yerel biçimine dönüştürülür.
Görseller: URL'ler Tlon depolamasına yüklenir ve görsel blokları olarak gömülür.

İlgili

Kanallara Genel Bakış — desteklenen tüm kanallar
Eşleme — DM kimlik doğrulaması ve eşleme akışı
Gruplar — grup sohbeti davranışı ve bahis kapısı
Kanal Yönlendirme — mesajlar için oturum yönlendirmesi
Güvenlik — erişim modeli ve sıkılaştırma

# Paketle birlikte gelen Plugin

# Kurulum

# Özel/LAN gemileri

# Grup kanalları

# Erişim denetimi

# Sahip ve onay sistemi

# Otomatik kabul ayarları

# Teslim hedefleri (CLI/Cron)

# Paketle birlikte gelen yetenek

# Yetenekler

# Sorun giderme

# Yapılandırma başvurusu

# Notlar

# İlgili