​

Canvas (تطبيق macOS)

​

أين يوجد Canvas

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

• openclaw-canvas://<session>/<path>

• 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

​

سلوك اللوحة

• لوحة بلا حدود، قابلة لتغيير الحجم، ومثبتة قرب شريط القوائم (أو مؤشر الفأرة).
• تتذكّر الحجم/الموضع لكل جلسة.
• تُعيد التحميل تلقائيًا عند تغيّر ملفات Canvas المحلية.
• تظهر لوحة Canvas واحدة فقط في أي وقت (ويُبدَّل السياق حسب الحاجة).

​

واجهة برمجة تطبيقات الوكيل

• إظهار/إخفاء اللوحة
• الانتقال إلى مسار أو URL
• تقييم JavaScript
• التقاط صورة لقطة

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

• يقبل canvas.navigate مسارات Canvas المحلية، وURLات http(s)، وURLات file://.
• إذا مرّرت "/"، يعرض Canvas الهيكل المحلي أو index.html.

​

A2UI في Canvas

http://<gateway-host>:18793/__openclaw__/a2ui/

​

أوامر A2UI (الإصدار 0.8)

• beginRendering
• surfaceUpdate
• dataModelUpdate
• deleteSurface

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":"If you can read this, A2UI push works."},"usageHint":"body"}}}]}}
{"beginRendering":{"surfaceId":"main","root":"root"}}
EOFA2

openclaw nodes canvas a2ui push --jsonl /tmp/a2ui-v0.8.jsonl --node <id>

openclaw nodes canvas a2ui push --node <id> --text "Hello from A2UI"

​

تشغيل مهام الوكيل من Canvas

• openclaw://agent?...

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

​

ملاحظات أمنية

• يمنع مخطط Canvas اجتياز الدلائل؛ يجب أن تعيش الملفات ضمن جذر الجلسة.
• يستخدم محتوى Canvas المحلي مخططًا مخصّصًا (لا يتطلب خادم loopback).
• يُسمح بعناوين URL الخارجية http(s) فقط عند الانتقال إليها صراحةً.