feat: add onboarding doc links

src/commands/configure.ts

@@ -150,6 +150,14 @@ async function promptGatewayConfig(
 
   let tailscaleResetOnExit = false;
   if (tailscaleMode !== "off") {
+    note(
+      [
+        "Docs:",
+        "https://docs.clawd.bot/gateway/tailscale",
+        "https://docs.clawd.bot/web",
+      ].join("\n"),
+      "Tailscale",
+    );
     tailscaleResetOnExit = Boolean(
       guardCancel(
         await confirm({
@@ -300,6 +308,7 @@ async function promptAuthConfig(
     } catch (err) {
       spin.stop("OAuth failed");
       runtime.error(String(err));
+      note("Trouble with OAuth? See https://docs.clawd.bot/start/faq", "OAuth");
     }
   } else if (authChoice === "openai-codex") {
     const isRemote = isRemoteEnvironment();
@@ -373,6 +382,7 @@ async function promptAuthConfig(
     } catch (err) {
       spin.stop("OpenAI OAuth failed");
       runtime.error(String(err));
+      note("Trouble with OAuth? See https://docs.clawd.bot/start/faq", "OAuth");
     }
   } else if (authChoice === "antigravity") {
     const isRemote = isRemoteEnvironment();
@@ -447,6 +457,7 @@ async function promptAuthConfig(
     } catch (err) {
       spin.stop("Antigravity OAuth failed");
       runtime.error(String(err));
+      note("Trouble with OAuth? See https://docs.clawd.bot/start/faq", "OAuth");
     }
   } else if (authChoice === "apiKey") {
     const key = guardCancel(
@@ -608,9 +619,11 @@ export async function runConfigureWizard(
     note(summarizeExistingConfig(baseConfig), title);
     if (!snapshot.valid && snapshot.issues.length > 0) {
       note(
-        snapshot.issues
-          .map((iss) => `- ${iss.path}: ${iss.message}`)
-          .join("\n"),
+        [
+          ...snapshot.issues.map((iss) => `- ${iss.path}: ${iss.message}`),
+          "",
+          "Docs: https://docs.clawd.bot/gateway/configuration",
+        ].join("\n"),
         "Config issues",
       );
     }
@@ -789,6 +802,14 @@ export async function runConfigureWizard(
       await healthCommand({ json: false, timeoutMs: 10_000 }, runtime);
     } catch (err) {
       runtime.error(`Health check failed: ${String(err)}`);
+      note(
+        [
+          "Docs:",
+          "https://docs.clawd.bot/gateway/health",
+          "https://docs.clawd.bot/gateway/troubleshooting",
+        ].join("\n"),
+        "Health check help",
+      );
     }
   }
 
@@ -797,20 +818,22 @@ export async function runConfigureWizard(
     runtime.error(controlUiAssets.message);
   }
 
-  note(
-    (() => {
-      const bind = nextConfig.gateway?.bind ?? "loopback";
-      const links = resolveControlUiLinks({
-        bind,
-        port: gatewayPort,
-        basePath: nextConfig.gateway?.controlUi?.basePath,
-      });
-      return [`Web UI: ${links.httpUrl}`, `Gateway WS: ${links.wsUrl}`].join(
-        "\n",
-      );
-    })(),
-    "Control UI",
-  );
+    note(
+      (() => {
+        const bind = nextConfig.gateway?.bind ?? "loopback";
+        const links = resolveControlUiLinks({
+          bind,
+          port: gatewayPort,
+          basePath: nextConfig.gateway?.controlUi?.basePath,
+        });
+        return [
+          `Web UI: ${links.httpUrl}`,
+          `Gateway WS: ${links.wsUrl}`,
+          "Docs: https://docs.clawd.bot/web/control-ui",
+        ].join("\n");
+      })(),
+      "Control UI",
+    );
 
   const browserSupport = await detectBrowserOpenSupport();
   if (!browserSupport.ok) {