OpenClaw · 可观测 · Token · 鉴权 · 远程 Mac · 冒烟 · 2026
2026 OpenClaw 可观测实战:
远程 Mac 网关上 Token 用量面板与模型鉴权状态卡串联端到端冒烟失败摘要的可复现步骤
2026.04.21
前端与发布闸
约 9 分钟
在远程 Mac用 OpenClaw 跑 网页冒烟时,令牌在涨而鉴权卡片像卡住最难分诊。本文给五步串联、证据表、免登录控制台的 Webhook 摘要模板,用可观测字段对齐失败阶段。slug:2026-openclaw-token-auth-e2e-summary-remote-mac.html。另读 模型列表、部署钩子、追踪摘要。
网关与浏览器双证据链
序 场景、对照与步骤
前端红屏常与网关假阳性并存:提示令牌因预检先涨,完成令牌不动;鉴权枚举抖动而页面仍转圈。把可观测字段压进同一阶段枚举,才能先判断续令牌、换别名还是改断言。
痛点。账单页缺运行编号难对齐单次部署;只看浏览器报告会丢模型策略;群聊贴日志易泄密,需要结构化摘要。
| 证据来源 | 擅长 | 盲区 |
|---|---|---|
| 云用量页 | 对账。 | 延迟大、缺运行编号。 |
| 网关日志加 Webhook | 单次冒烟即时分诊。 | 要脱敏。 |
| 仅浏览器报告 | 定位超时与选择器。 | 缺上游鉴权语义。 |
五步串联。
- 导出运行编号、提交哈希、基址与模型别名到同一环境文件。
- 启浏览器前用真实授权头打网关预检,把状态码、时延、鉴权枚举追加按行 JSON。
- 跑冒烟,结构化报告落盘并附运行编号。
- 脚本合并网关计数、失败阶段与用例统计为版本化 JSON,勿把密钥打 stdout。
- 以提交哈希加运行编号加配置档作幂等键 POST Webhook,失败指数退避。
摘要模板。字段名稳定,值班规则才可复用。
{
"schema": "smoke_summary/v1",
"openclaw_run_id": "run_…",
"git_sha": "abc123…",
"base_url": "https://staging.example",
"gateway": {
"auth_state": "ok|degraded|blocked",
"prompt_tokens": 0,
"completion_tokens": 0,
"last_http_status": 200,
"last_latency_ms": 0
},
"playwright": {
"status": "passed|failed|timedOut",
"failed_spec": "tests/smoke/checkout.spec.ts",
"shard": "webkit",
"exit_code": 1
},
"failed_phase": "gateway_preflight|playwright_smoke|summary_post"
}
可引用事实
网关行必须可按运行编号过滤;提示涨完成平多半仍在预检未进结账断言;聊天 stderr 截断四千字节余量走制品链。
01 网关侧检查项
先查网关再怪浏览器,并与 模型列表冒烟 交叉验证。
- 时钟偏移。记毫秒偏差进鉴权行,防误判卡死。
- 令牌范围。角色最小权限且与入口基址一致。
- 别名漂移。同入口拉模型目录对配置单一来源。
- 降级语义。写明降级仍允许的只读探针。
02 与 Playwright 报告字段对接思路
从报告抽稳定键进摘要,归一化可复用 构建指标摘要 的模式。
| 报告来源 | 摘要字段 | 帮助 |
|---|---|---|
| 期望意外差 | 断言差分 | 分 UI 抖与上游仍吐令牌。 |
| 工人索引分片 | 分片标识 | 对齐网关瞬时峰。 |
超时要带用例超时与网关时延;时延低且鉴权阻塞先续令牌。
03 阈值告警
单指标易误报,要信号打架再叫。基线见 运维监控排障。
- 令牌斜率。提示增速超基线两倍而用例仍绿。
- 鉴权抖动。同运行编号内枚举短翻三次且无轮换窗。
04 常见问题
令牌在动为何仍红?
预检与嵌入先吃提示令牌;对齐阶段与项目名别看累计。
能不看云控制台吗?
能,入口网关运行器同字段 stdout 与 Webhook;摘要勿嵌控制台专属链。
幂等键?
提交哈希加运行编号加配置档,重复钩子可折,第二套档仍可报。
更多文章:博客列表。