vultr/openclaw
1
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-04-11 01:01:13 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: update Anthropic subscription billing guidance

Browse Source
This commit is contained in:
Peter Steinberger
2026-04-04 09:31:58 +09:00
parent b2fb1210e1
commit 45675c1698
9 changed files with 112 additions and 27 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/cli/index.md
View File

@@ -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:

2
docs/cli/models.md
View File

@@ -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.

8
docs/concepts/model-providers.md
View File

@@ -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`)

22
docs/concepts/oauth.md
View File

@@ -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:

14
docs/gateway/authentication.md
View File

@@ -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):

8
docs/gateway/configuration-examples.md
View File

@@ -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

37
docs/help/faq.md
View File

@@ -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>

25
docs/providers/anthropic.md
View File

@@ -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).

13
docs/reference/api-usage-costs.md
View File

@@ -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)