GitHub Issue：macOS Homebrew 全局安装下 Canvas A2UI 资源路径修复手册
解决“Open Canvas 报 A2UI assets not found”的场景：定位全局安装路径解析偏差，修复候选目录后恢复画布资源加载。
GITHUBDiscovered 2026-02-13Author joesuarez
Prerequisites
- macOS environment with OpenClaw installed globally (Homebrew Node/npm -g).
- You can check canvas endpoint status and access gateway logs.
Steps
- Reproduce via menu-bar “Open Canvas” and confirm `/__openclaw__/a2ui/` returns 503.
- Inspect asset root candidates and verify packaged path resolves to `dist/canvas-host/a2ui` in global install.
- Apply path-resolution fix (or temporary symlink workaround), then restart gateway.
- Retest both endpoint status and actual A2UI message rendering to avoid false-positive 200-only success.
Commands
openclaw gateway statusopenclaw logs --local-timeopenclaw gateway restartVerify
Canvas endpoint returns 200 and pushed A2UI content is rendered correctly instead of only showing placeholder text.
Caveats
- Temporary symlink can hide deeper path-resolution bugs; treat it as short-term workaround.
- Path behavior differs by install method (dev/npm/homebrew bundle)（需验证）。
Source attribution
This tip is aggregated from community/public sources and preserved with attribution.
Open original source ↗