Коротко
- Автогенерация секрета привязана к standalone browser server и sandbox browser bridge.
- В режиме
trusted-proxyпароль остаётся в процессе Gateway, а клиенту нужен явныйgateway.auth.password. - В режиме
passwordавтогенерация пропускается, поэтому задайте пароль явно.
Сверено с документацией OpenClaw 2026.10.8, 27 октября 2026.
Отдельная проверка касается standalone browser server и sandbox browser bridge. Их HTTP-доступ использует только аутентификацию с общим секретом.
Что изменилось в OpenClaw 2026.10.8
Автогенерация теперь привязана к HTTP-серверам: standalone browser server и sandbox browser bridge.
- Режим
noneсоздаёт токен и сохраняет его какgateway.auth.token. - Режим
trusted-proxyсоздаёт пароль только в памяти процесса Gateway. - Режим
passwordне запускает автогенерацию.
При trusted-proxy gateway.auth.password также служит локальным паролем Gateway. Его изменение перезапускает Gateway.
Три режима аутентификации
none: OpenClaw создаёт токен и сохраняет его вgateway.auth.token.trusted-proxy: пароль создаётся внутри Gateway, но в конфиг не записывается.password: автогенерация пропускается, задайте пароль явно.
Если для режима уже задан явный строковый секрет, OpenClaw не создаёт новый. Для HTTP-доступа браузера принимаются bearer token, заголовок x-openclaw-password или HTTP Basic auth.
Где ломается trusted-proxy
В режиме trusted-proxy внешний клиент standalone loopback API не получит сгенерированный пароль: он остаётся в процессе Gateway. Ему нужен явный gateway.auth.password.
Заголовки Tailscale Serve и режим trusted-proxy не аутентифицируют standalone loopback browser API.
{
gateway: {
// Trusted-proxy auth expects the proxy's source IP to be non-loopback by default
bind: "lan",
// CRITICAL: Only add your proxy's IP(s) here
trustedProxies: ["10.0.0.1", "172.17.0.1"],
auth: {
mode: "trusted-proxy",
identityScopes: {
"admin@company.org": ["operator.admin"],
},
trustedProxy: {
// Header containing authenticated user identity (required)
userHeader: "x-forwarded-user",
// Optional: headers that MUST be present (proxy verification)
requiredHeaders: ["x-forwarded-proto", "x-forwarded-host"],
// Optional: restrict to specific users (empty = allow all)
allowUsers: ["nick@example.com", "admin@company.org"],
// Optional: allow a same-host loopback proxy after explicit opt-in
allowLoopback: false,
// Optional: let authenticated proxy users enroll UI devices and upgrade scopes
deviceAutoApprove: {
enabled: false,
scopes: ["operator.read", "operator.write", "operator.approvals", "operator.questions"],
},
},
},
},
}
Почему встроенный сервис браузера не меняет конфиг
Встроенный сервис браузера Gateway не имеет HTTP-слушателя. При первом использовании браузера он не создаёт секрет и не пишет в конфиг.
Что проверить у себя
- Проверьте режим и явные секреты в
~/.openclaw/openclaw.json:gateway.auth.mode,gateway.auth.token,gateway.auth.password. - Для standalone browser server и sandbox browser bridge найдите секрет управления браузером. В режиме
noneпроверьтеgateway.auth.token. - Для standalone loopback API в режиме
trusted-proxyзадайте явныйgateway.auth.password. - Изменение
gateway.auth.passwordперезапускает Gateway.