OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

macOS companion app

Tuval

macOS uygulaması, HTML/CSS/JS, A2UI ve küçük etkileşimli kullanıcı arayüzü yüzeyleri için hafif bir görsel çalışma alanı olan WKWebView kullanarak ajan denetimli bir Canvas paneli yerleştirir.

Canvas'ın bulunduğu yer

Canvas durumu Application Support altında saklanır:

  • ~/Library/Application Support/OpenClaw/canvas/<session>/...

Canvas paneli bu dosyaları özel bir URL şeması olan openclaw-canvas://<session>/<path> aracılığıyla sunar:

  • openclaw-canvas://main/ -> <canvasRoot>/main/index.html
  • openclaw-canvas://main/assets/app.css -> <canvasRoot>/main/assets/app.css
  • openclaw-canvas://main/widgets/todo/ -> <canvasRoot>/main/widgets/todo/index.html

Kökte index.html yoksa uygulama yerleşik bir başlangıç sayfası gösterir.

Panel davranışı

  • Menü çubuğunun (veya fare imlecinin) yakınına sabitlenmiş, kenarlıksız ve yeniden boyutlandırılabilir panel.
  • Canvas'ın gösterilmesi uygulamalar arasında geçiş yapmaz veya klavye odağını çalmaz.
  • Boyutu/konumu oturum bazında hatırlar.
  • Yerel Canvas dosyaları değiştiğinde otomatik olarak yeniden yüklenir.
  • Aynı anda yalnızca bir Canvas paneli görünür (oturumlar gerektiğinde değiştirilir).

Canvas, Settings -> Allow Canvas seçeneğinden devre dışı bırakılabilir. Devre dışı bırakıldığında Canvas Node komutları CANVAS_DISABLED döndürür.

Ajan API yüzeyi

Canvas, Gateway WebSocket üzerinden kullanıma sunulur; böylece ajan paneli gösterebilir/gizleyebilir, bir yola veya URL'ye gidebilir, JavaScript değerlendirebilir ve bir anlık görüntü yakalayabilir:

bash
openclaw nodes canvas present --node <id>openclaw nodes canvas navigate --node <id> "/"openclaw nodes canvas eval --node <id> --js "document.title"openclaw nodes canvas snapshot --node <id>

eval ve a2ui.*, paneli açmadan veya görünür hâle getirmeden içeriği günceller. Paneli yalnızca present, navigate veya bir kullanıcı eylemi gösterir; gizlendikten sonra içerik güncellemeleri gizli panele uygulanmaya devam eder. snapshot için görünür bir panel gerekir; aksi durumda CANVAS_HIDDEN döndürülür. Önce present çalıştırılmalıdır.

canvas.navigate; yerel Canvas yollarını, http(s) URL'lerini ve file:// URL'lerini kabul eder. "/" iletildiğinde yerel başlangıç sayfası veya index.html gösterilir.

/__openclaw__/canvas/ ve /__openclaw__/a2ui/ altındaki Gateway tarafından barındırılan hedefler, Node oturumunun mevcut kapsamlı Canvas URL'si üzerinden çözümlenir. Uygulama, gezinmeden önce bu kısa ömürlü yeteneği yeniler; yetenek URL'sini kendiniz oluşturmanız veya kopyalamanız gerekmez.

Canvas'ta A2UI

A2UI, Gateway Canvas ana makinesi tarafından barındırılır ve Canvas panelinin içinde işlenir. Gateway bir Canvas ana makinesi duyurduğunda macOS uygulaması, ilk açılışta otomatik olarak A2UI ana makine sayfasına gider.

Duyurulan URL yetenek kapsamlıdır; örneğin http://<gateway-host>:18789/__openclaw__/cap/<token>/__openclaw__/a2ui/?platform=macos. Bunu kalıcı bir bağlantı değil, geçici kimlik bilgileri olarak değerlendirin.

A2UI komutları (v0.8)

Canvas, A2UI v0.8 sunucudan istemciye iletilerini kabul eder: beginRendering, surfaceUpdate, dataModelUpdate, deleteSurface. createSurface (v0.9) henüz desteklenmemektedir.

bash
cat > /tmp/a2ui-v0.8.jsonl <<'EOFA2'{"surfaceUpdate":{"surfaceId":"main","components":[{"id":"root","component":{"Column":{"children":{"explicitList":["title","content"]}}}},{"id":"title","component":{"Text":{"text":{"literalString":"Canvas (A2UI v0.8)"},"usageHint":"h1"}}},{"id":"content","component":{"Text":{"text":{"literalString":"Bunu okuyabiliyorsanız A2UI gönderimi çalışıyor."},"usageHint":"body"}}}]}}{"beginRendering":{"surfaceId":"main","root":"root"}}EOFA2 openclaw nodes canvas a2ui push --jsonl /tmp/a2ui-v0.8.jsonl --node <id>

Hızlı duman testi:

bash
openclaw nodes canvas a2ui push --node <id> --text "A2UI'dan merhaba"

Canvas'tan ajan çalıştırmalarını tetikleme

Canvas, openclaw://agent?... derin bağlantıları aracılığıyla yeni ajan çalıştırmalarını tetikleyebilir:

js
window.location.href = "openclaw://agent?message=Review%20this%20design";

Desteklenen sorgu parametreleri:

Parametre Anlamı
message Önceden doldurulmuş ajan istemi.
sessionKey Kararlı oturum tanımlayıcısı.
thinking İsteğe bağlı düşünme profili.
deliver, to, channel Teslimat hedefi.
timeoutSeconds İsteğe bağlı çalıştırma zaman aşımı.
key Güvenilir yerel çağıranlar için uygulama tarafından oluşturulan güvenlik belirteci.

Geçerli bir anahtar sağlanmadığı sürece uygulama onay ister. Anahtarsız bağlantılar onaydan önce iletiyi ve URL'yi gösterir ve teslimat yönlendirme alanlarını yok sayar; anahtarlı bağlantılar normal Gateway çalıştırma yolunu kullanır.

Güvenlik notları

  • Canvas şeması dizin geçişini engeller; dosyalar oturum kökü altında bulunmalıdır.
  • Yerel Canvas içeriği özel bir şema kullanır (geri döngü sunucusu gerekmez).
  • Harici http(s) URL'lerine yalnızca açıkça gidildiğinde izin verilir.
  • Normal web sayfaları yalnızca işlenir. Ajan eylemleri yalnızca uygulamaya ait Canvas şemasından veya uygulama tarafından seçilen, tam olarak yetenek kapsamlı Gateway A2UI belgesinden kabul edilir; alt çerçeveler, yönlendirmeler, eskimiş yetenekler ve değiştirilmiş sorgular eylem gönderemez.

İlgili

Was this useful?
On this page

On this page