openclaw - 💡(How to fix) Fix [Gateway] A2UI host not reachable [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#59022Fetched 2026-04-08 02:29:49
View on GitHub
Comments
0
Participants
1
Timeline
2
Reactions
1
Author
Participants
Timeline (top)
cross-referenced ×1subscribed ×1

Error Message

{"error":{"message":"Unauthorized","type":"unauthorized"}}

Code Example

$ curl --noproxy '*' -s http://127.0.0.1:18789/__openclaw__/a2ui
{"error":{"message":"Unauthorized","type":"unauthorized"}}
RAW_BUFFERClick to expand / collapse

问题描述

Gateway 的 A2UI 服务不可用,导致 canvas.a2ui.push 命令失败。

环境

  • Gateway: OpenClaw 2026.3.31
  • macOS 节点: 曾蔚的MacBook Pro, macOS 26.3.0

复现步骤

  1. 执行 canvas a2ui_push --node "曾蔚的MacBook Pro" --jsonl '{"beginRendering": {"surfaceId": "main"}}'
  2. 返回错误: UNAVAILABLE: A2UI_HOST_UNAVAILABLE: A2UI host not reachable

实际行为

  • Canvas 功能正常工作 (canvas.present, canvas.snapshot 等)
  • 但 A2UI 相关功能全部失败
  • 日志显示 "canvas host mounted" 但没有 A2UI 相关日志

检查结果

  • Gateway 日志中只显示: canvas host mounted at http://0.0.0.0:18789/__openclaw__/canvas/
  • 没有 A2UI host 启动的相关日志
  • 节点命令列表中包含 canvas.a2ui.push, canvas.a2ui.pushJSONL, canvas.a2ui.reset

预期行为

A2UI host 应该正常启动并可用。

附加信息

Gateway 配置:

  • gateway.port: 18789
  • gateway.mode: local
  • gateway.bind: lan
  • 已尝试配置 canvasHost.enabled: true

curl 测试:

$ curl --noproxy '*' -s http://127.0.0.1:18789/__openclaw__/a2ui
{"error":{"message":"Unauthorized","type":"unauthorized"}}

端点存在但返回 Unauthorized。

extent analysis

TL;DR

  • The most likely fix is to configure proper authentication for the A2UI host endpoint.

Guidance

  • Verify that the canvas.a2ui.push command is correctly authenticated, as the curl test shows an "Unauthorized" error.
  • Check the Gateway configuration for any authentication settings related to A2UI, such as API keys or tokens.
  • Ensure that the canvasHost.enabled setting is correctly applied, as it may affect A2UI host availability.
  • Investigate the Gateway logs for any authentication-related errors or warnings that may indicate the root cause of the issue.

Example

  • A possible authentication configuration could involve setting an API key or token in the Gateway configuration, but the exact implementation depends on the specific requirements and documentation of the OpenClaw Gateway.

Notes

  • The issue may be related to a misconfiguration or missing authentication setup for the A2UI host endpoint.
  • Further investigation into the Gateway documentation and configuration is necessary to determine the exact cause and solution.

Recommendation

  • Apply workaround: Configure proper authentication for the A2UI host endpoint, as the "Unauthorized" error suggests an authentication issue.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING