Çalışma alanları

Kontrol Arayüzü içindeki Çalışma Alanları sekmesi, sizin ve ajanlarınızın birlikte düzenlediği bir yüzeydir. Sekmeler, bileşenler, bunların 12 sütunlu bir ızgaradaki konumları ve veri bağlamalarının tümü tek bir belgede bulunur. Bu belgeyi düzenleyebilen her şey çalışma alanını oluşturabilir: siz, openclaw workspaces CLI veya workspace_* araçlarını çağıran bir ajan.

Her yazma işlemi aynı doğrulanmış yoldan geçer; böylece bir insanın düzeni ile bir ajanın düzeni birbirinden farklılaşamaz. Kabul edilen her yazma işlemi sürümü artırır ve plugin.workspaces.changed olayını yayınlar; dolayısıyla bir ajanın düzenlemesi, yeniden yükleme gerektirmeden zaten açık olan tarayıcıda görünür.

Çalışma Alanlarını Etkinleştirme

Paketle birlikte gelen Çalışma Alanları Plugin'i varsayılan olarak devre dışıdır. Kontrol Arayüzünde Pluginler bölümünü açın, Çalışma Alanları öğesini bulun ve Etkinleştir seçeneğini belirleyin. CLI üzerinden de etkinleştirebilirsiniz:

openclaw plugins enable workspaces

Plugin'i etkinleştirmek Çalışma Alanları sekmesini ekler ve openclaw workspaces CLI ile workspace_* ajan araçlarını kullanılabilir hâle getirir. Devre dışı bırakmak, çalışma alanı veritabanını veya bileşen varlıklarını silmeden bu yüzeyleri kaldırır.

Varsayılan çalışma alanı

İlk yüklemede bir Genel Bakış çalışma alanı sunulur: maliyet ve token kartları, örnek durumu, oturumlar, cron durumu ve etkinlik akışı. Bu, sıradan çalışma alanı içeriğidir; sürükleyebilir, daraltabilir, gizleyebilir veya silebilirsiniz.

Yerleşik bileşenler

Dokuz güvenilir bileşen Plugin ile birlikte sunulur ve birinci taraf kullanıcı arayüzü olarak işlenir:

stat-card, markdown, table, iframe-embed, sessions, usage, cron, instances, activity.

Bileşenler verileri bağlamalar aracılığıyla bildirir; verileri asla kendi başlarına getirmezler:

file bağlaması, kendi sayılarınızı bir çalışma alanına yerleştirmenin en basit yoludur: veri dizinine bir JSON dosyası yazın ve bir stat-card öğesini ona yönlendirin.

Kaynak bilgisi

Sekmeler ve bileşenler, yazma işlemini yapan kişiye göre ayarlanan bir createdBy damgası taşır: user, system veya agent:<id>. Bu değer çağıran tarafından sağlanamaz; dolayısıyla bir ajan kendi çalışmasını sizin çalışmanızmış gibi etiketleyemez ve ajan tarafından oluşturulan bir bileşendeki "AI" rozeti her zaman gerçekten bunu ifade eder.

Özel bileşenler

Bir ajan, workspace_widget_scaffold ile gerçek bir HTML bileşeni oluşturabilir (veya siz openclaw workspaces widget-scaffold <name> ile oluşturabilirsiniz). Ajan tarafından oluşturulan kod düşmanca kabul edilir:

• İskeleti oluşturulan bir bileşen kayıt defterine beklemede durumuyla girer. Bir operatör onaylayana kadar iframe oluşturulmaz ve varlık rotası dosyaları için 404 döndürür.
• Onay, düzeni değiştirmekten ayrı bir karardır: workspaces.widget.approve, çalıştırma onaylarını koruyan kapsamla aynı olan operator.approvals kapsamını gerektirir.
• Onaylanmış bir bileşen <iframe sandbox="allow-scripts"> içinde işlenir; allow-same-origin hiçbir zaman kullanılmaz. Böylece kökeni opaktır ve üst öğenin DOM'una, depolama alanına veya çerezlerine erişemez.
• Varlıkları connect-src 'none' ile sunulur; bu, fetch, XHR ve WebSockets gibi betik ağ iletişimini engeller. Herhangi bir kimlik bilgisi taşımaz ve Gateway ile hiçbir zaman iletişim kurmaz.
• Veriler bileşene yalnızca sürümlendirilmiş bir postMessage köprüsü üzerinden ulaşır. Özel kod, önceden ajan veya operatör tarafından çalışma alanında oluşturulmuş değerler olan bildirilmiş static bağlamalarını alabilir. RPC ve dosya bağlamaları güvenilir yerleşik bileşenlerde kalır: tarayıcılar korumalı alan içindeki bir alt öğenin kendi çerçevesinde gezinmesine izin verdiğinden ayrıcalıklı veriler hiçbir zaman ajan tarafından oluşturulan HTML'ye gönderilmez.

Bir bileşenden sohbete istem göndermek ayrıca bir bildirim yeteneği, tam metni alıntılayan çağrı başına onay ve hız sınırından geçmeyi gerektirir.

CLI

openclaw workspaces tabs listopenclaw workspaces tabs create --title Financialsopenclaw workspaces widget-scaffold revenue-chart --title "Revenue Chart"openclaw workspaces widget-approve revenue-chart

widget-approve, operator.approvals kapsamıyla eşleştirilmiş bir cihaz gerektirir; Kontrol Arayüzünden onaylamak bunu gerektirmez çünkü tarayıcı bu kapsamı zaten taşır.

Depolama

Çalışma alanı belgesi, özel bileşen kayıt defteri ve 20 girdilik geri alma halkası <stateDir>/workspaces/workspaces.sqlite içinde bulunur. Ajan tarafından oluşturulan bileşen varlıkları <stateDir>/workspaces/widgets/<name>/ altında, dosya bağlama verileri ise <stateDir>/workspaces/data/ altında diskte kalır; çünkü ajan bunları sıradan dosya araçlarıyla oluşturur ve bileşen rotası bunların baytlarını sunar.