docs: clarify anthropic extra usage billing

docs/reference/api-usage-costs.md

@@ -31,11 +31,13 @@ OpenClaw features that can generate provider usage or paid API calls.
   `stats`, normalizes `stats.cached` into `cacheRead`, and derives input tokens
   from `stats.input_tokens - stats.cached` when needed.
 
-Anthropic note: starting **April 4, 2026 at 12:00 PM PT / 8:00 PM BST**,
-Anthropic says OpenClaw no longer uses included Claude subscription limits.
-Anthropic subscription-auth traffic in OpenClaw now requires **Extra Usage**
-billed separately from the subscription, but Anthropic does not expose a
-per-message dollar estimate that OpenClaw can show in `/usage full`.
+Anthropic note: Anthropic's public Claude Code docs still include direct Claude
+Code terminal usage in Claude plan limits. Separately, Anthropic told OpenClaw
+users that starting **April 4, 2026 at 12:00 PM PT / 8:00 PM BST**, the
+**OpenClaw** Claude-login path counts as third-party harness usage and
+requires **Extra Usage** billed separately from the subscription. Anthropic
+does not expose a per-message dollar estimate that OpenClaw can show in
+`/usage full`.
 
 **CLI usage windows (provider quotas)**
 
@@ -74,9 +76,9 @@ Every reply or tool call uses the **current model provider** (OpenAI, Anthropic,
 primary source of usage and cost.
 
 This also includes subscription-style hosted providers that still bill outside
-OpenClaw's local UI, such as **OpenAI Codex**, **Qwen Cloud Coding Plan**,
-**MiniMax Coding Plan**, **Z.AI / GLM Coding Plan**, and
-Anthropic subscription auth with **Extra Usage** enabled.
+OpenClaw's local UI, such as **OpenAI Codex**, **Alibaba Cloud Model Studio
+Coding Plan**, **MiniMax Coding Plan**, **Z.AI / GLM Coding Plan**, and
+Anthropic's OpenClaw Claude-login path with **Extra Usage** enabled.
 
 See [Models](/providers/models) for pricing config and [Token use & costs](/reference/token-use) for display.
 

docs/reference/token-use.md

@@ -178,9 +178,9 @@ This maps to Anthropic's `context-1m-2025-08-07` beta header.
 This only applies when `context1m: true` is set on that model entry.
 
 Requirement: the credential must be eligible for long-context usage (API key
-billing, or Anthropic OAuth/subscription auth with Extra Usage enabled). If
-not, Anthropic responds with
-`HTTP 429: rate_limit_error: Extra usage is required for long context requests`.
+billing, or OpenClaw's Claude-login path with Extra Usage enabled). If not,
+Anthropic responds
+with `HTTP 429: rate_limit_error: Extra usage is required for long context requests`.
 
 If you authenticate Anthropic with OAuth/subscription tokens (`sk-ant-oat-*`),
 OpenClaw skips the `context-1m-*` beta header because Anthropic currently

docs/reference/wizard.md

@@ -32,7 +32,7 @@ For a high-level overview, see [Onboarding (CLI)](/start/wizard).
   <Step title="Model/Auth">
     - **Anthropic API key**: uses `ANTHROPIC_API_KEY` if present or prompts for a key, then saves it for daemon use.
     - **Anthropic Claude CLI**: preferred Anthropic assistant choice in onboarding/configure. On macOS onboarding checks Keychain item "Claude Code-credentials" (choose "Always Allow" so launchd starts don't block); on Linux/Windows it reuses `~/.claude/.credentials.json` if present and switches model selection to a canonical `claude-cli/claude-*` ref.
-    - **Anthropic OAuth/token profiles**: still honored at runtime if already configured, but onboarding/configure no longer offers Anthropic setup-token as a new setup path.
+    - **Anthropic setup-token (legacy/manual)**: available again in onboarding/configure, but Anthropic told OpenClaw users that the OpenClaw Claude-login path counts as third-party harness usage and requires **Extra Usage** on the Claude account.
     - **OpenAI Code (Codex) subscription (Codex CLI)**: if `~/.codex/auth.json` exists, onboarding can reuse it. Reused Codex CLI credentials stay managed by Codex CLI; on expiry OpenClaw re-reads that source first and, when the provider can refresh it, writes the refreshed credential back to Codex storage instead of taking ownership itself.
     - **OpenAI Code (Codex) subscription (OAuth)**: browser flow; paste the `code#state`.
       - Sets `agents.defaults.model` to `openai-codex/gpt-5.4` when model is unset or `openai/*`.