mirror of
https://fastgit.cc/github.com/openclaw/openclaw
synced 2026-05-01 06:36:23 +08:00
docs: batch fix filler Note/page openers and one TUI auth Warning
- gateway/authentication: tighten model-provider Note opener - help/debugging: drop 'this page covers' filler - reference/session-management-compaction: rephrase end-to-end intro - reference/transcript-hygiene: drop 'this document describes' filler - web/index: collapse 'this page focuses' filler - web/tui: convert prose --url Note to Warning component
This commit is contained in:
@@ -7,7 +7,7 @@ title: "Authentication"
|
||||
---
|
||||
|
||||
<Note>
|
||||
This page covers **model provider** authentication (API keys, OAuth, Claude CLI reuse, and Anthropic setup-token). For **gateway connection** authentication (token, password, trusted-proxy), see [Configuration](/gateway/configuration) and [Trusted Proxy Auth](/gateway/trusted-proxy-auth).
|
||||
This page is the **model provider** authentication reference (API keys, OAuth, Claude CLI reuse, and Anthropic setup-token). For **gateway connection** authentication (token, password, trusted-proxy), see [Configuration](/gateway/configuration) and [Trusted Proxy Auth](/gateway/trusted-proxy-auth).
|
||||
</Note>
|
||||
|
||||
OpenClaw supports OAuth and API keys for model providers. For always-on gateway
|
||||
|
||||
@@ -7,8 +7,7 @@ read_when:
|
||||
title: "Debugging"
|
||||
---
|
||||
|
||||
This page covers debugging helpers for streaming output, especially when a
|
||||
provider mixes reasoning into normal text.
|
||||
Debugging helpers for streaming output, especially when a provider mixes reasoning into normal text.
|
||||
|
||||
## Runtime debug overrides
|
||||
|
||||
|
||||
@@ -7,15 +7,15 @@ read_when:
|
||||
title: "Session management deep dive"
|
||||
---
|
||||
|
||||
This page explains how OpenClaw manages sessions end-to-end:
|
||||
OpenClaw manages sessions end-to-end across these areas:
|
||||
|
||||
- **Session routing** (how inbound messages map to a `sessionKey`)
|
||||
- **Session store** (`sessions.json`) and what it tracks
|
||||
- **Transcript persistence** (`*.jsonl`) and its structure
|
||||
- **Transcript hygiene** (provider-specific fixups before runs)
|
||||
- **Context limits** (context window vs tracked tokens)
|
||||
- **Compaction** (manual + auto-compaction) and where to hook pre-compaction work
|
||||
- **Silent housekeeping** (e.g. memory writes that shouldn’t produce user-visible output)
|
||||
- **Compaction** (manual and auto-compaction) and where to hook pre-compaction work
|
||||
- **Silent housekeeping** (memory writes that should not produce user-visible output)
|
||||
|
||||
If you want a higher-level overview first, start with:
|
||||
|
||||
|
||||
@@ -7,11 +7,7 @@ read_when:
|
||||
title: "Transcript hygiene"
|
||||
---
|
||||
|
||||
This document describes **provider-specific fixes** applied to transcripts before a run
|
||||
(building model context). Most of these are **in-memory** adjustments used to satisfy
|
||||
strict provider requirements. A separate session-file repair pass may also rewrite
|
||||
stored JSONL before the session is loaded, either by dropping malformed JSONL lines or
|
||||
by repairing persisted turns that are syntactically valid but known to be rejected by a
|
||||
OpenClaw applies **provider-specific fixes** to transcripts before a run (building model context). Most of these are **in-memory** adjustments used to satisfy strict provider requirements. A separate session-file repair pass may also rewrite stored JSONL before the session is loaded, either by dropping malformed JSONL lines or by repairing persisted turns that are syntactically valid but known to be rejected by a
|
||||
provider during replay. When a repair occurs, the original file is backed up alongside
|
||||
the session file.
|
||||
|
||||
|
||||
@@ -12,8 +12,7 @@ The Gateway serves a small **browser Control UI** (Vite + Lit) from the same por
|
||||
- with `gateway.tls.enabled: true`: `https://<host>:18789/`
|
||||
- optional prefix: set `gateway.controlUi.basePath` (e.g. `/openclaw`)
|
||||
|
||||
Capabilities live in [Control UI](/web/control-ui).
|
||||
This page focuses on bind modes, security, and web-facing surfaces.
|
||||
Capabilities live in [Control UI](/web/control-ui). The rest of this page focuses on bind modes, security, and web-facing surfaces.
|
||||
|
||||
## Webhooks
|
||||
|
||||
|
||||
@@ -217,9 +217,9 @@ Tips:
|
||||
- `--timeout-ms <ms>`: Agent timeout in ms (defaults to `agents.defaults.timeoutSeconds`)
|
||||
- `--history-limit <n>`: History entries to load (default `200`)
|
||||
|
||||
Note: when you set `--url`, the TUI does not fall back to config or environment credentials.
|
||||
Pass `--token` or `--password` explicitly. Missing explicit credentials is an error.
|
||||
In local mode, do not pass `--url`, `--token`, or `--password`.
|
||||
<Warning>
|
||||
When you set `--url`, the TUI does not fall back to config or environment credentials. Pass `--token` or `--password` explicitly. Missing explicit credentials is an error. In local mode, do not pass `--url`, `--token`, or `--password`.
|
||||
</Warning>
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
|
||||
Reference in New Issue
Block a user