LLM/moltbot
1
0
Fork 0
mirror of https://github.com/moltbot/moltbot.git synced 2026-04-21 05:32:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: refresh anthropic oauth defaults refs

Browse Source
This commit is contained in:
Peter Steinberger
2026-04-04 22:01:16 +01:00
parent f14f7b9fde
commit 5c5c82dfaa
5 changed files with 26 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
docs/concepts/session-pruning.md
View File

@@ -51,10 +51,10 @@ persisted raw image blocks in history.
OpenClaw auto-enables pruning for Anthropic profiles:
| Profile type | Pruning enabled | Heartbeat |
| ------------------------------- | --------------- | --------- |
| Claude CLI or legacy token auth | Yes | 1 hour |
| API key | Yes | 30 min |
| Profile type | Pruning enabled | Heartbeat |
| ------------------------------------------------------- | --------------- | --------- |
| Anthropic OAuth/token auth (including Claude CLI reuse) | Yes | 1 hour |
| API key | Yes | 30 min |
If you set explicit values, OpenClaw does not override them.

4
docs/gateway/heartbeat.md
View File

@@ -20,7 +20,7 @@ Troubleshooting: [Scheduled Tasks](/automation/cron-jobs#troubleshooting)
## Quick start (beginner)
1. Leave heartbeats enabled (default is `30m`, or `1h` for Anthropic Claude CLI or legacy token auth) or set your own cadence.
1. Leave heartbeats enabled (default is `30m`, or `1h` for Anthropic OAuth/token auth, including Claude CLI reuse) or set your own cadence.
2. Create a tiny `HEARTBEAT.md` checklist or `tasks:` block in the agent workspace (optional but recommended).
3. Decide where heartbeat messages should go (`target: "none"` is the default; set `target: "last"` to route to the last contact).
4. Optional: enable heartbeat reasoning delivery for transparency.
@@ -50,7 +50,7 @@ Example config:
## Defaults
- Interval: `30m` (or `1h` when Anthropic Claude CLI or legacy token auth is the detected auth mode). Set `agents.defaults.heartbeat.every` or per-agent `agents.list[].heartbeat.every`; use `0m` to disable.
- Interval: `30m` (or `1h` when Anthropic OAuth/token auth is the detected auth mode, including Claude CLI reuse). Set `agents.defaults.heartbeat.every` or per-agent `agents.list[].heartbeat.every`; use `0m` to disable.
- Prompt body (configurable via `agents.defaults.heartbeat.prompt`):
`Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`
- The heartbeat prompt is sent **verbatim** as the user message. The system

2
docs/gateway/troubleshooting.md
View File

@@ -50,7 +50,7 @@ Look for:
Fix options:
1. Disable `context1m` for that model to fall back to the normal context window.
2. Use an Anthropic API key with billing, or enable Anthropic Extra Usage on the subscription account.
2. Use an Anthropic API key with billing, or enable Anthropic Extra Usage on the Anthropic OAuth/subscription account.
3. Configure fallback models so runs continue when Anthropic long-context requests are rejected.
Related:

9
docs/help/faq.md
View File

@@ -631,15 +631,16 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
<a id="why-am-i-seeing-http-429-ratelimiterror-from-anthropic"></a>
<Accordion title="Why am I seeing HTTP 429 rate_limit_error from Anthropic?">
That means your **Anthropic quota/rate limit** is exhausted for the current window. If you
use **Claude CLI**, wait for the window to reset or upgrade your plan. If you
use an **Anthropic API key**, check the Anthropic Console
use **Claude CLI** or **Anthropic OAuth/subscription tokens**, wait for the
window to reset or enable/upgrade Extra Usage. If you use an **Anthropic API
key**, check the Anthropic Console
for usage/billing and raise limits as needed.
If the message is specifically:
`Extra usage is required for long context requests`, the request is trying to use
Anthropic's 1M context beta (`context1m: true`). That only works when your
credential is eligible for long-context billing (API key billing or Claude
CLI with Extra Usage enabled).
credential is eligible for long-context billing (API key billing or
Anthropic OAuth/subscription auth with Extra Usage enabled).
Tip: set a **fallback model** so OpenClaw can keep replying while a provider is rate-limited.
See [Models](/cli/models), [OAuth](/concepts/oauth), and

25
docs/providers/anthropic.md
View File

@@ -16,7 +16,7 @@ if they are already configured.
<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. Existing legacy Anthropic token auth
OpenClaw or other third-party harnesses. Existing Anthropic OAuth/token auth
can still run in OpenClaw, but Anthropic now requires **Extra Usage**
(pay-as-you-go, billed separately from the subscription) for that traffic.
@@ -90,7 +90,7 @@ Important limits:
## Prompt caching (Anthropic API)
OpenClaw supports Anthropic's prompt caching feature. This is **API-only**; legacy Anthropic token auth does not honor cache settings.
OpenClaw supports Anthropic's prompt caching feature. This is **API-only**; Anthropic OAuth/token auth does not honor cache settings.
### Configuration
@@ -182,15 +182,15 @@ This only activates when `params.context1m` is explicitly set to `true` for
that model.
Requirement: Anthropic must allow long-context usage on that credential
(typically API key billing, or Claude CLI / legacy token auth with Extra Usage
enabled). Otherwise Anthropic returns:
(typically API key billing, or Anthropic OAuth/subscription auth with Extra
Usage enabled). Otherwise Anthropic returns:
`HTTP 429: rate_limit_error: Extra usage is required for long context requests`.
Note: Anthropic currently rejects `context-1m-*` beta requests when using
legacy Anthropic token auth (`sk-ant-oat-*`). If you configure
`context1m: true` with that legacy auth mode, OpenClaw logs a warning and
falls back to the standard context window by skipping the context1m beta
header while keeping the required OAuth betas.
Anthropic OAuth/subscription tokens (`sk-ant-oat-*`). If you configure
`context1m: true` with that auth mode, OpenClaw logs a warning and falls back
to the standard context window by skipping the context1m beta header while
keeping the required OAuth betas.
## Option B: Claude CLI as the message provider
@@ -334,9 +334,12 @@ More details: [/gateway/cli-backends](/gateway/cli-backends)
## Notes
- Anthropic says that starting **April 4, 2026 at 12:00 PM PT / 8:00 PM BST**,
OpenClaw usage with Claude CLI or legacy Anthropic token auth requires **Extra Usage**
(pay-as-you-go billed separately from the subscription).
- Existing legacy Anthropic token profiles are still honored at runtime, but OpenClaw no longer offers setup-token onboarding or auth commands for new setups.
OpenClaw usage with Claude CLI or Anthropic OAuth/subscription token auth
requires **Extra Usage** (pay-as-you-go billed separately from the
subscription).
- Existing legacy Anthropic token profiles are still honored at runtime, but
OpenClaw no longer offers setup-token onboarding or auth commands for new
setups.
- Auth details + reuse rules are in [/concepts/oauth](/concepts/oauth).
## Troubleshooting