Skip to main content
Discord Activities, bir aracının geçerli Discord kanalına etkileşimli, kendi kendine yeten bir HTML widget’ı göndermesini sağlar. Mesaj bir Widget’ı aç düğmesi içerir; bu düğmeye tıklandığında widget Discord içinde başlatılır. Özellik varsayılan olarak kapalıdır. OpenClaw, Activity HTTP rotalarını, show_widget aracı aracını ve başlatma düğmesi işleyicisini yalnızca channels.discord.activities mevcut olduğunda ve bir istemci gizli anahtarı çözümlendiğinde kaydeder. Kullanımdan kaldırılan discord_widget diğer adı bir sürüm boyunca kullanılabilir kalır.

​
Ön koşullar

  • mevcut bir OpenClaw Discord botu
  • OpenClaw Gateway’e ulaşan genel bir HTTPS ana makine adı
  • botun Discord uygulaması için Activities ve OAuth2’yi yapılandırma izni
Herhangi bir HTTPS ters proxy’si veya tüneli kullanılabilir. Adlandırılmış bir Cloudflare Tunnel, Gateway bağlantı noktasını doğrudan açığa çıkarmadan kararlı bir ana makine adı sağlar.
Normal Gateway kimlik doğrulamasını etkin tutun. Yalnızca Activity öneki geneldir; Plugin, OAuth’ı, Activity örneği üyeliğini, kanal bağlamasını, oturumları ve tek kullanımlık belge yeteneklerini kendisi doğrular.

​
Kurulum

1

Gateway'i HTTPS üzerinden erişilebilir hâle getirin

Tünelinizi veya ters proxy’nizi başlatın ve Activities yapılandırması eklendikten sonra https://openclaw.example.com/discord/activity/ adresinin Gateway’e ulaştığını doğrulayın. Örnek ana makine adını kendi adınızla değiştirin.
2

Discord'da Activities'i etkinleştirin

Mevcut bot uygulamasını Discord Developer Portal içinde açın. Activities bölümünü açın, Activities’i etkinleştirin ve bir URL eşlemesi oluşturun:
  • önek: ROOT (/)
  • hedef: openclaw.example.com/discord/activity
Hedef, genel ana makine adı ile /discord/activity birleşimidir ve sonunda eğik çizgi bulunmaz.
3

OAuth2 istemci gizli anahtarını kopyalayın

Developer Portal’da OAuth2 bölümünü açın. Discord en az bir yönlendirme URI’si gerektirir; uygulamada henüz yoksa geri döngü adresi gibi yerel bir yer tutucu ekleyin. Activity dönüş akışını Embedded App SDK yönetir. Uygulama istemci gizli anahtarını kopyalayın veya sıfırlayın. Bunu bir kimlik bilgisi olarak değerlendirin: sohbete, günlüklere veya kaydedilmiş bir yapılandırma dosyasına yapıştırmayın.
4

OpenClaw'u yapılandırın

Widget sunması gereken Discord hesabına bir blok ekleyin:
DISCORD_CLIENT_SECRET ayarlandığında clientSecret değerini bloktan çıkarabilirsiniz. Etkinleştirmeyi seçmek için bloğun kendisi mevcut kalmalıdır.Normal Discord erişim ayarları ayrı kalır. Örneğin allowFrom, aracıya kimlerin DM gönderebileceğini denetlemeye devam eder; bir kanalda daha önce gönderilmiş bir widget’ı kimlerin açabileceğini denetlemez.
5

Yeniden başlatın ve test edin

Gateway’i yeniden başlatın. Bir Discord görüşmesinde aracıdan etkileşimli bir widget göstermesini isteyin. Araç show_widget çağrısını yapar; gönderilen mesajdaki Widget’ı aç düğmesine tıklayın.

​
Güvenlik modeli

  • OAuth, widget meta verileri döndürülmeden önce Discord kullanıcısını tanımlar.
  • Discord’un Get Activity Instance API’si, OAuth kullanıcısının geçerli Activity örneğinde bulunduğunu doğrulamalıdır. Örnek kanalı, widget’ın gönderildiği kanalla eşleşmelidir.
  • Discord’un ilgili kanala girmesine izin verdiği herkes kanalın widget’larını açabilir. Hedef kitleyi daraltmak için Discord kanal izinlerini kullanın. OpenClaw komut ve DM izin listeleri, daha önce gönderilmiş kanal içeriğine erişim sağlamaz veya bu erişimi kaldırmaz.
  • OAuth oturumlarının süresi 15 dakika sonra dolar. Widget belge yeteneklerinin süresi 60 saniye sonra dolar ve yalnızca bir kez çalışır.
  • Widget’ların süresi yedi gün sonra dolar ve Discord Plugin örneği başına en fazla 64 widget saklanır.
  • Widget HTML’si aracınız tarafından yazılır ve güvenilir içerik olarak değerlendirilmelidir. Hatalı bir widget’ın açığa çıkarmasını istemeyeceğiniz gizli bilgileri yerleştirmeyin.
  • Widget, kendi iç içe çerçevesi içinde gezinebilir. sandbox="allow-scripts" iframe’i üst düzey gezinmeyi, açılır pencereleri ve aynı kaynağa erişimi engellerken İçerik Güvenliği Politikası ağ bağlantılarını ve harici kaynakları engeller. Bu denetimler derinlemesine savunma sağlar; widget’ı yazan aracıya karşı bir güvenlik sınırı değildir.
  • Activities devre dışı bırakıldığında /discord/activity hiçbir şekilde kaydedilmez.
Genel Activity kabuğu ve token değişim rotası, etkinleştirildiklerinde tüneliniz üzerinden erişilebilir hâle gelir. Geçerli bir OAuth oturumu ve tek kullanımlık belge yeteneği olmadan widget HTML’sini açığa çıkarmazlar.

​
Sorun giderme

​
Activity “Gateway çevrimdışı” diyor

  • tünelin çalıştığını ve Gateway’in gerçek bağlama bağlantı noktasına yönlendirildiğini doğrulayın
  • Developer Portal hedefinin /discord/activity içerdiğini doğrulayın
  • Discord veya OpenClaw yapılandırmasını değiştirdikten sonra Gateway’i yeniden başlatın
  • eksik Activities istemci gizli anahtarıyla ilgili tek satırlık uyarı için Gateway günlüklerini denetleyin

​
Discord boş bir sayfa açıyor veya blocked:csp bildiriyor

  • URL eşlemesinin ROOT kullandığını ve ikinci bir /discord/activity segmenti eklemediğini doğrulayın
  • kabuğun, shell.js öğesinin ve SDK modülünün tamamının Discord proxy’si üzerinden döndüğünü doğrulayın
  • /discord/activity/ altındaki istekler için Gateway günlüklerini inceleyin
Widget ağ istekleri kasıtlı olarak engellenir. Widget’ın ihtiyaç duyduğu tüm CSS, JavaScript, görseller ve verileri satır içine yerleştirin.

​
“Widget kullanılamıyor”

Düğmeyi, aracının gönderdiği kanaldan başlatın. OpenClaw, tıklanan başlatmaları sunucu tarafında izler; böylece Discord düğmenin özel kimliğini çıkarsa veya bozsa bile yeni bir başlatma kaydı doğru widget’ı çözümleyebilir. Ne özel kimlik ne de bir başlatma kaydı çözümlenebildiğinde OpenClaw, ilgili kanalda en son gönderilen ve hâlâ etkin olan widget’ı açar. Eski widget’lara, özel kimliklerini koruyan düğmeler üzerinden erişilmeye devam edilebilir.

​
“Bu kanalda Activities başlatamazsınız”

Discord, forum gönderisi ileti dizilerinden Activities başlatmaz. OpenClaw widget mesajını ve düğmesini buraya gönderebilir ancak Activity’yi bunun yerine normal bir metin kanalından başlatın. Bu kısıtlama OpenClaw’dan değil, Discord’dan kaynaklanır.