From 66b1520d92699c0e4d88ada712278f2f785b70b4 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Sat, 4 Apr 2026 08:10:18 +0100
Subject: [PATCH] docs: refresh auth command references

---
 docs/cli/index.md                | 4 ++--
 docs/cli/models.md               | 4 ++++
 docs/providers/github-copilot.md | 8 +++++++-
 3 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/docs/cli/index.md b/docs/cli/index.md
index 381c963d283..7a5b082298a 100644
--- a/docs/cli/index.md
+++ b/docs/cli/index.md
@@ -1095,9 +1095,9 @@ Options:
 
 Options:
 
-- `add`: interactive token-auth helper
+- `add`: interactive auth helper (provider auth flow or token paste)
 - `login`: `--provider <name>`, `--method <method>`, `--set-default`
-- `login-github-copilot`: GitHub Copilot OAuth login flow
+- `login-github-copilot`: GitHub Copilot OAuth login flow (`--yes`)
 - `setup-token`: `--provider <name>`, `--yes`
 - `paste-token`: `--provider <name>`, `--profile-id <id>`, `--expires-in <duration>`
 
diff --git a/docs/cli/models.md b/docs/cli/models.md
index 14bf7bcc87c..532c2b400f6 100644
--- a/docs/cli/models.md
+++ b/docs/cli/models.md
@@ -71,6 +71,10 @@ openclaw models auth setup-token --provider <id>
 openclaw models auth paste-token
 ```
 
+`models auth add` is the interactive auth helper. It can launch a provider auth
+flow (OAuth/API key) or guide you into manual token paste, depending on the
+provider you choose.
+
 `models auth login` runs a provider plugin’s auth flow (OAuth/API key). Use
 `openclaw plugins list` to see which providers are installed.
 
diff --git a/docs/providers/github-copilot.md b/docs/providers/github-copilot.md
index fe5535de1fa..3b01947253f 100644
--- a/docs/providers/github-copilot.md
+++ b/docs/providers/github-copilot.md
@@ -45,10 +45,16 @@ open until it completes.
 ### Optional flags
 
 ```bash
-openclaw models auth login-github-copilot --profile-id github-copilot:work
 openclaw models auth login-github-copilot --yes
 ```
 
+To also apply the provider's recommended default model in one step, use the
+generic auth command instead:
+
+```bash
+openclaw models auth login --provider github-copilot --method device --set-default
+```
+
 ## Set a default model
 
 ```bash