diff --git a/docs/cli/index.md b/docs/cli/index.md
index a5526d45bda..c54d398f263 100644
--- a/docs/cli/index.md
+++ b/docs/cli/index.md
@@ -931,9 +931,13 @@ openclaw models auth setup-token --provider anthropic
 openclaw models status
 ```
 
-Policy note: this is technical compatibility. Anthropic has blocked some
-subscription usage outside Claude Code in the past; verify current Anthropic
-terms before relying on setup-token in production.
+Billing note: Anthropic changed third-party harness billing on **April 4, 2026
+at 12:00 PM PT / 8:00 PM BST**. Anthropic says Claude subscription limits no
+longer cover OpenClaw, and setup-token usage in OpenClaw now requires **Extra
+Usage** billed separately from the subscription. For production, prefer an
+Anthropic API key or another supported subscription-style provider such as
+OpenAI Codex, Alibaba Cloud Model Studio Coding Plan, MiniMax Coding Plan, or
+Z.AI / GLM Coding Plan.
 
 Anthropic Claude CLI migration:
 
diff --git a/docs/cli/models.md b/docs/cli/models.md
index 446843e8753..549b448dfb7 100644
--- a/docs/cli/models.md
+++ b/docs/cli/models.md
@@ -87,4 +87,4 @@ Notes:
   CLI login and rewrites the main Anthropic default-model path to `claude-cli/...`.
 - `setup-token` prompts for a setup-token value (generate it with `claude setup-token` on any machine).
 - `paste-token` accepts a token string generated elsewhere or from automation.
-- Anthropic policy note: setup-token support is technical compatibility. Anthropic has blocked some subscription usage outside Claude Code in the past, so verify current terms before using it broadly.
+- Anthropic billing note: Anthropic changed third-party harness billing on **April 4, 2026 at 12:00 PM PT / 8:00 PM BST**. Anthropic says Claude subscription limits no longer cover OpenClaw, and setup-token usage in OpenClaw now requires **Extra Usage** billed separately from the subscription.
diff --git a/docs/concepts/model-providers.md b/docs/concepts/model-providers.md
index 96d5702ceaf..e9c0731a474 100644
--- a/docs/concepts/model-providers.md
+++ b/docs/concepts/model-providers.md
@@ -167,7 +167,7 @@ OpenClaw ships with the pi‑ai catalog. These providers require **no**
 - Example model: `anthropic/claude-opus-4-6`
 - CLI: `openclaw onboard --auth-choice token` (paste setup-token) or `openclaw models auth paste-token --provider anthropic`
 - Direct public Anthropic requests support the shared `/fast` toggle and `params.fastMode`, including API-key and OAuth-authenticated traffic sent to `api.anthropic.com`; OpenClaw maps that to Anthropic `service_tier` (`auto` vs `standard_only`)
-- Policy note: setup-token support is technical compatibility; Anthropic has blocked some subscription usage outside Claude Code in the past. Verify current Anthropic terms and decide based on your risk tolerance.
+- Billing note: Anthropic changed third-party harness billing on **April 4, 2026 at 12:00 PM PT / 8:00 PM BST**. Anthropic says Claude subscription limits no longer cover OpenClaw, and subscription-auth traffic now requires **Extra Usage** billed separately from the subscription.
 - Recommendation: Anthropic API key auth is the safer, recommended path over subscription setup-token auth.
 
 ```json5
@@ -195,6 +195,12 @@ OpenClaw ships with the pi‑ai catalog. These providers require **no**
 }
 ```
 
+### Other subscription-style hosted options
+
+- [Qwen / Model Studio](/providers/qwen_modelstudio): Alibaba Cloud Standard pay-as-you-go and Coding Plan subscription endpoints
+- [MiniMax](/providers/minimax): MiniMax Coding Plan OAuth or API key access
+- [GLM Models](/providers/glm): Z.AI Coding Plan or general API endpoints
+
 ### OpenCode
 
 - Auth: `OPENCODE_API_KEY` (or `OPENCODE_ZEN_API_KEY`)
diff --git a/docs/concepts/oauth.md b/docs/concepts/oauth.md
index 69c4f422f21..80ea708e857 100644
--- a/docs/concepts/oauth.md
+++ b/docs/concepts/oauth.md
@@ -10,7 +10,14 @@ title: "OAuth"
 
 # OAuth
 
-OpenClaw supports “subscription auth” via OAuth for providers that offer it (notably **OpenAI Codex (ChatGPT OAuth)**). For Anthropic subscriptions, you can either use the **setup-token** flow or reuse a local **Claude CLI** login on the gateway host. Anthropic subscription use outside Claude Code has been restricted for some users in the past, so treat it as a user-choice risk and verify current Anthropic policy yourself. OpenAI Codex OAuth is explicitly supported for use in external tools like OpenClaw. This page explains:
+OpenClaw supports “subscription auth” via OAuth for providers that offer it
+(notably **OpenAI Codex (ChatGPT OAuth)**). For Anthropic subscriptions, you
+can either use the **setup-token** flow or reuse a local **Claude CLI** login
+on the gateway host, but Anthropic changed third-party harness billing on
+**April 4, 2026 at 12:00 PM PT / 8:00 PM BST**: Anthropic says Claude
+subscription limits no longer cover OpenClaw and Anthropic now requires **Extra
+Usage** for that traffic. OpenAI Codex OAuth is explicitly supported for use in
+external tools like OpenClaw. This page explains:
 
 For Anthropic in production, API key auth is the safer recommended path over subscription setup-token auth.
 
@@ -57,9 +64,16 @@ For static secret refs and runtime snapshot activation behavior, see [Secrets Ma
 ## Anthropic setup-token (subscription auth)
 
 <Warning>
-Anthropic setup-token support is technical compatibility, not a policy guarantee.
-Anthropic has blocked some subscription usage outside Claude Code in the past.
-Decide for yourself whether to use subscription auth, and verify Anthropic's current terms.
+Anthropic changed third-party harness billing on **April 4, 2026 at 12:00 PM
+PT / 8:00 PM BST**. Anthropic says Claude subscription limits no longer cover
+OpenClaw or other third-party harnesses. Anthropic setup-token support remains
+technically usable in OpenClaw, but Anthropic now requires **Extra Usage**
+(pay-as-you-go billed separately from the subscription) for that traffic.
+
+If you want other subscription-style options in OpenClaw, see [OpenAI
+Codex](/providers/openai), [Alibaba Cloud Model Studio Coding
+Plan](/providers/qwen_modelstudio), [MiniMax Coding Plan](/providers/minimax),
+and [Z.AI / GLM Coding Plan](/providers/glm).
 </Warning>
 
 Run `claude setup-token` on any machine, then paste it into OpenClaw:
diff --git a/docs/gateway/authentication.md b/docs/gateway/authentication.md
index 14bda3caea5..273e9fbc5fc 100644
--- a/docs/gateway/authentication.md
+++ b/docs/gateway/authentication.md
@@ -89,9 +89,17 @@ This credential is only authorized for use with Claude Code and cannot be used f
 …use an Anthropic API key instead.
 
 <Warning>
-Anthropic setup-token support is technical compatibility only. Anthropic has blocked
-some subscription usage outside Claude Code in the past. Use it only if you decide
-the policy risk is acceptable, and verify Anthropic's current terms yourself.
+Anthropic changed third-party harness billing on **April 4, 2026 at 12:00 PM
+PT / 8:00 PM BST**. Anthropic says Claude subscription limits no longer cover
+OpenClaw or other third-party harnesses. Setup-token auth still works in
+OpenClaw, but Anthropic now requires **Extra Usage** (pay-as-you-go billed
+separately from the subscription) for that traffic.
+
+If you want the clearest path for always-on or team gateways, prefer an
+Anthropic API key. OpenClaw also supports other subscription-style options,
+including [OpenAI Codex](/providers/openai), [Alibaba Cloud Model Studio Coding
+Plan](/providers/qwen_modelstudio), [MiniMax Coding Plan](/providers/minimax),
+and [Z.AI / GLM Coding Plan](/providers/glm).
 </Warning>
 
 Manual token entry (any provider; writes `auth-profiles.json` + updates config):
diff --git a/docs/gateway/configuration-examples.md b/docs/gateway/configuration-examples.md
index fe9d9edd067..f7a591c90b1 100644
--- a/docs/gateway/configuration-examples.md
+++ b/docs/gateway/configuration-examples.md
@@ -569,9 +569,11 @@ Only enable direct mutable name/email/nick matching with each channel's `dangero
 ### Anthropic setup-token + API key, MiniMax fallback
 
 <Warning>
-Anthropic setup-token usage outside Claude Code has been restricted for some
-users in the past. Treat this as user-choice risk and verify current Anthropic
-terms before depending on subscription auth.
+Anthropic changed third-party harness billing on **April 4, 2026 at 12:00 PM
+PT / 8:00 PM BST**. Anthropic says Claude subscription limits no longer cover
+OpenClaw, and Anthropic setup-token traffic now requires **Extra Usage** billed
+separately from the subscription. Prefer an Anthropic API key if you want the
+clearest billing path.
 </Warning>
 
 ```json5
diff --git a/docs/help/faq.md b/docs/help/faq.md
index a3c7c270165..ade10109b30 100644
--- a/docs/help/faq.md
+++ b/docs/help/faq.md
@@ -559,11 +559,19 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
     **local-only models** so your data stays on your device. Subscriptions (Claude
     Pro/Max or OpenAI Codex) are optional ways to authenticate those providers.
 
-    If you choose Anthropic subscription auth, decide for yourself whether to use it:
-    Anthropic has blocked some subscription usage outside Claude Code in the past.
-    OpenAI Codex OAuth is explicitly supported for external tools like OpenClaw.
+    Anthropic changed third-party harness billing on **April 4, 2026 at 12:00 PM
+    PT / 8:00 PM BST**. Anthropic says Claude subscription limits no longer cover
+    OpenClaw, and Anthropic subscription auth in OpenClaw now requires **Extra
+    Usage** billed separately from the subscription. OpenAI Codex OAuth is
+    explicitly supported for external tools like OpenClaw.
+
+    OpenClaw also supports other hosted subscription-style options including
+    **Alibaba Cloud Model Studio Coding Plan**, **MiniMax Coding Plan**, and
+    **Z.AI / GLM Coding Plan**.
 
     Docs: [Anthropic](/providers/anthropic), [OpenAI](/providers/openai),
+    [Qwen / Model Studio](/providers/qwen_modelstudio),
+    [MiniMax](/providers/minimax), [GLM Models](/providers/glm),
     [Local models](/gateway/local-models), [Models](/concepts/models).
 
   </Accordion>
@@ -573,9 +581,11 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
     login on the gateway host.
 
     Claude Pro/Max subscriptions **do not include an API key**, so this is the
-    technical path for subscription accounts. But this is your decision: Anthropic
-    has blocked some subscription usage outside Claude Code in the past.
-    If you want the clearest and safest supported path for production, use an Anthropic API key.
+    technical path for subscription accounts. But Anthropic changed third-party
+    harness billing on **April 4, 2026 at 12:00 PM PT / 8:00 PM BST**:
+    Anthropic says OpenClaw now requires **Extra Usage** billed separately from
+    the subscription for this path. If you want the clearest and safest
+    supported path for production, use an Anthropic API key.
 
   </Accordion>
 
@@ -602,10 +612,17 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
 
     Setup-token is still supported. Claude CLI migration is simpler when the gateway host already runs Claude Code. See [Anthropic](/providers/anthropic) and [OAuth](/concepts/oauth).
 
-    Important: this is technical compatibility, not a policy guarantee. Anthropic
-    has blocked some subscription usage outside Claude Code in the past.
-    You need to decide whether to use it and verify Anthropic's current terms.
-    For production or multi-user workloads, Anthropic API key auth is the safer, recommended choice.
+    Important: Anthropic changed third-party harness billing on **April 4, 2026
+    at 12:00 PM PT / 8:00 PM BST**. Anthropic says Claude subscription limits no
+    longer cover OpenClaw, and Anthropic now requires **Extra Usage** billed
+    separately from the subscription for setup-token or Claude CLI traffic
+    through OpenClaw.
+
+    For production or multi-user workloads, Anthropic API key auth is the
+    safer, recommended choice. If you want other subscription-style hosted
+    options in OpenClaw, see [OpenAI](/providers/openai), [Qwen / Model
+    Studio](/providers/qwen_modelstudio), [MiniMax](/providers/minimax), and
+    [GLM Models](/providers/glm).
 
   </Accordion>
 
diff --git a/docs/providers/anthropic.md b/docs/providers/anthropic.md
index fa7546f162c..797f4833a95 100644
--- a/docs/providers/anthropic.md
+++ b/docs/providers/anthropic.md
@@ -12,6 +12,20 @@ title: "Anthropic"
 Anthropic builds the **Claude** model family and provides access via an API.
 In OpenClaw you can authenticate with an API key or a **setup-token**.
 
+<Warning>
+Anthropic changed third-party harness billing on **April 4, 2026 at 12:00 PM
+PT / 8:00 PM BST**. Anthropic says Claude subscription limits no longer cover
+OpenClaw or other third-party harnesses. You can still use Anthropic
+subscription auth in OpenClaw, but Anthropic now requires **Extra Usage**
+(pay-as-you-go, billed separately from the subscription) for that traffic.
+
+If you want a clearer billing path, use an Anthropic API key instead. OpenClaw
+also supports other subscription-style options, including [OpenAI
+Codex](/providers/openai), [Alibaba Cloud Model Studio Coding
+Plan](/providers/qwen_modelstudio), [MiniMax Coding Plan](/providers/minimax),
+and [Z.AI / GLM Coding Plan](/providers/glm).
+</Warning>
+
 ## Option A: Anthropic API key
 
 **Best for:** standard API access and usage-based billing.
@@ -194,6 +208,11 @@ OAuth betas.
 **Best for:** a single-user gateway host that already has Claude CLI installed
 and signed in with a Claude subscription.
 
+Billing note: when Claude CLI is used through OpenClaw, Anthropic now treats
+that traffic as third-party harness usage. As of **April 4, 2026 at 12:00 PM
+PT / 8:00 PM BST**, Anthropic requires **Extra Usage** instead of included
+Claude subscription limits for this path.
+
 This path uses the local `claude` binary for model inference instead of calling
 the Anthropic API directly. OpenClaw treats it as a **CLI backend provider**
 with model refs like:
@@ -306,7 +325,8 @@ More details: [/gateway/cli-backends](/gateway/cli-backends)
 
 ## Option C: Claude setup-token
 
-**Best for:** using your Claude subscription.
+**Best for:** using your Claude subscription with Anthropic **Extra Usage**
+enabled, or while transitioning to API-key billing.
 
 ### Where to get a setup-token
 
@@ -346,6 +366,9 @@ openclaw onboard --auth-choice setup-token
 ## Notes
 
 - Generate the setup-token with `claude setup-token` and paste it, or run `openclaw models auth setup-token` on the gateway host.
+- Anthropic says that starting **April 4, 2026 at 12:00 PM PT / 8:00 PM BST**,
+  OpenClaw usage with Claude subscription auth requires **Extra Usage**
+  (pay-as-you-go billed separately from the subscription).
 - If you see “OAuth token refresh failed …” on a Claude subscription, re-auth with a setup-token. See [/gateway/troubleshooting](/gateway/troubleshooting).
 - Auth details + reuse rules are in [/concepts/oauth](/concepts/oauth).
 
diff --git a/docs/reference/api-usage-costs.md b/docs/reference/api-usage-costs.md
index aba275d0ed5..a85eb25bf98 100644
--- a/docs/reference/api-usage-costs.md
+++ b/docs/reference/api-usage-costs.md
@@ -22,7 +22,13 @@ OpenClaw features that can generate provider usage or paid API calls.
 **Per-message cost footer**
 
 - `/usage full` appends a usage footer to every reply, including **estimated cost** (API-key only).
-- `/usage tokens` shows tokens only; OAuth flows hide dollar cost.
+- `/usage tokens` shows tokens only; OAuth/setup-token/CLI subscription flows hide dollar cost.
+
+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`.
 
 **CLI usage windows (provider quotas)**
 
@@ -48,6 +54,11 @@ OpenClaw can pick up credentials from:
 Every reply or tool call uses the **current model provider** (OpenAI, Anthropic, etc). This is the
 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**, **Alibaba Cloud Model Studio
+Coding Plan**, **MiniMax Coding Plan**, **Z.AI / GLM Coding Plan**, and
+Anthropic subscription auth with **Extra Usage** enabled.
+
 See [Models](/providers/models) for pricing config and [Token use & costs](/reference/token-use) for display.
 
 ### 2) Media understanding (audio/image/video)