docs: refresh token auth command mirrors

Author: steipete

docs/cli/index.md

@@ -1607,6 +1607,8 @@ Options:
 Notes:
 
 - `setup-token` and `paste-token` are generic token commands for providers that expose token auth methods.
+- `setup-token` requires an interactive TTY and runs the provider's token-auth method.
+- `paste-token` prompts for the token value and defaults to auth profile id `<provider>:manual` when `--profile-id` is omitted.
 - Anthropic legacy token profiles still run if already configured, but Anthropic no longer supports `setup-token` or `paste-token` as a new OpenClaw auth path.
 
 ### `models auth order get|set|clear`

docs/cli/models.md

@@ -99,7 +99,7 @@ openclaw models fallbacks list
 openclaw models auth add
 openclaw models auth login --provider <id>
 openclaw models auth setup-token --provider <id>
-openclaw models auth paste-token
+openclaw models auth paste-token --provider <id>
 ```
 
 `models auth add` is the interactive auth helper. It can launch a provider auth
@@ -122,6 +122,13 @@ Notes:
   CLI login and rewrites the main Anthropic default-model path to `claude-cli/...`.
 - `setup-token` and `paste-token` remain generic token commands for providers
   that expose token auth methods.
-- `paste-token` accepts a token string generated elsewhere or from automation.
+- `setup-token` requires an interactive TTY and runs the provider's token-auth
+  method (defaulting to that provider's `setup-token` method when it exposes
+  one).
+- `paste-token` requires `--provider`, prompts for the token value, and writes
+  it to the default profile id `<provider>:manual` unless you pass
+  `--profile-id`.
+- `paste-token --expires-in <duration>` stores an absolute token expiry from a
+  relative duration such as `365d` or `12h`.
 - 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 Claude CLI traffic in OpenClaw now requires **Extra Usage** billed separately from the subscription.
 - Existing legacy Anthropic token profiles still run if already configured, but Anthropic no longer supports `setup-token` or `paste-token` as a new OpenClaw auth path.

docs/concepts/oauth.md

@@ -84,6 +84,10 @@ OpenClaw no longer offers Anthropic setup-token onboarding or auth commands for
 new setup. Existing legacy Anthropic token profiles are still honored at
 runtime if they are already configured.
 
+The generic token helpers still exist for other providers:
+`openclaw models auth setup-token --provider <id>` and
+`openclaw models auth paste-token --provider <id>`.
+
 ## Anthropic Claude CLI migration
 
 If Claude CLI is already installed and signed in on the gateway host, you can

docs/gateway/authentication.md

@@ -68,6 +68,14 @@ for new setup via onboarding or `models auth` commands.
 For new setup, use an Anthropic API key or migrate to Claude CLI on the gateway
 host.
 
+Other providers can still use the generic token helpers:
+
+- `openclaw models auth setup-token --provider <id>` runs the provider's token
+  auth flow (interactive TTY required).
+- `openclaw models auth paste-token --provider <id>` prompts for a token value
+  and writes it to `auth-profiles.json` (default profile id:
+  `<provider>:manual`).
+
 Manual token entry (any provider; writes `auth-profiles.json` + updates config):
 
 ```bash

docs/help/faq.md

@@ -614,6 +614,9 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
     Yes. Reuse a local **Claude CLI** login on the gateway host with `openclaw models auth login --provider anthropic --method cli --set-default`.
 
     Existing legacy Anthropic token profiles still run if they are already configured, but OpenClaw no longer offers Anthropic setup-token as a new setup path. See [Anthropic](/providers/anthropic) and [OAuth](/concepts/oauth).
+    Other providers can still use the generic token helpers with
+    `openclaw models auth setup-token --provider <id>` or
+    `openclaw models auth paste-token --provider <id>`.
 
     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