feat: add OpenClaw User-Agent toggle, default off

Add a switch in the OpenClaw provider form to optionally send a browser
User-Agent header. The toggle defaults to off — only providers that
explicitly include headers in their preset or config will have it enabled.

Remove the previous auto-injection logic that force-added User-Agent on
every preset load and new provider creation.

src/components/providers/forms/OpenClawFormFields.tsx

@@ -42,6 +42,10 @@ interface OpenClawFormFieldsProps {
   // Models
   models: OpenClawModel[];
   onModelsChange: (models: OpenClawModel[]) => void;
+
+  // User-Agent
+  userAgent: boolean;
+  onUserAgentChange: (checked: boolean) => void;
 }
 
 export function OpenClawFormFields({
@@ -58,6 +62,8 @@ export function OpenClawFormFields({
   onApiChange,
   models,
   onModelsChange,
+  userAgent,
+  onUserAgentChange,
 }: OpenClawFormFieldsProps) {
   const { t } = useTranslation();
   const [expandedModels, setExpandedModels] = useState<Record<number, boolean>>(
@@ -205,6 +211,21 @@ export function OpenClawFormFields({
         partnerPromotionKey={partnerPromotionKey}
       />
 
+      {/* User-Agent */}
+      <div className="flex items-center justify-between">
+        <div className="space-y-0.5">
+          <FormLabel>
+            {t("openclaw.userAgent", { defaultValue: "发送 User-Agent" })}
+          </FormLabel>
+          <p className="text-xs text-muted-foreground">
+            {t("openclaw.userAgentHint", {
+              defaultValue: "部分供应商需要浏览器 User-Agent 才能正常访问。",
+            })}
+          </p>
+        </div>
+        <Switch checked={userAgent} onCheckedChange={onUserAgentChange} />
+      </div>
+
       {/* Models Editor */}
       <div className="space-y-3">
         <div className="flex items-center justify-between">

src/components/providers/forms/ProviderForm.tsx

@@ -1450,6 +1450,8 @@ export function ProviderForm({
             onApiChange={openclawForm.handleOpenclawApiChange}
             models={openclawForm.openclawModels}
             onModelsChange={openclawForm.handleOpenclawModelsChange}
+            userAgent={openclawForm.openclawUserAgent}
+            onUserAgentChange={openclawForm.handleOpenclawUserAgentChange}
           />
         )}
 

src/components/providers/forms/hooks/useOpenclawFormState.ts

@@ -14,6 +14,9 @@ interface UseOpenclawFormStateParams {
   getSettingsConfig: () => string;
 }
 
+export const OPENCLAW_DEFAULT_USER_AGENT =
+  "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:148.0) Gecko/20100101 Firefox/148.0";
+
 export interface OpenclawFormState {
   openclawProviderKey: string;
   setOpenclawProviderKey: (key: string) => void;
@@ -21,16 +24,19 @@ export interface OpenclawFormState {
   openclawApiKey: string;
   openclawApi: string;
   openclawModels: OpenClawModel[];
+  openclawUserAgent: boolean;
   existingOpenclawKeys: string[];
   handleOpenclawBaseUrlChange: (baseUrl: string) => void;
   handleOpenclawApiKeyChange: (apiKey: string) => void;
   handleOpenclawApiChange: (api: string) => void;
   handleOpenclawModelsChange: (models: OpenClawModel[]) => void;
+  handleOpenclawUserAgentChange: (enabled: boolean) => void;
   resetOpenclawState: (config?: {
     baseUrl?: string;
     apiKey?: string;
     api?: string;
     models?: OpenClawModel[];
+    headers?: Record<string, string>;
   }) => void;
 }
 
@@ -92,6 +98,16 @@ export function useOpenclawFormState({
     return parseOpenclawField<OpenClawModel[]>(initialData, "models", []);
   });
 
+  const [openclawUserAgent, setOpenclawUserAgent] = useState<boolean>(() => {
+    if (appId !== "openclaw") return true;
+    const headers = parseOpenclawField<Record<string, string>>(
+      initialData,
+      "headers",
+      {},
+    );
+    return "User-Agent" in headers;
+  });
+
   const updateOpenclawConfig = useCallback(
     (updater: (config: Record<string, any>) => void) => {
       try {
@@ -147,18 +163,35 @@ export function useOpenclawFormState({
     [updateOpenclawConfig],
   );
 
+  const handleOpenclawUserAgentChange = useCallback(
+    (enabled: boolean) => {
+      setOpenclawUserAgent(enabled);
+      updateOpenclawConfig((config) => {
+        if (enabled) {
+          config.headers = { "User-Agent": OPENCLAW_DEFAULT_USER_AGENT };
+        } else {
+          delete config.headers;
+        }
+      });
+    },
+    [updateOpenclawConfig],
+  );
+
   const resetOpenclawState = useCallback(
     (config?: {
       baseUrl?: string;
       apiKey?: string;
       api?: string;
       models?: OpenClawModel[];
+      headers?: Record<string, string>;
     }) => {
       setOpenclawProviderKey("");
       setOpenclawBaseUrl(config?.baseUrl || "");
       setOpenclawApiKey(config?.apiKey || "");
       setOpenclawApi(config?.api || "openai-completions");
       setOpenclawModels(config?.models || []);
+      const ua = config?.headers ? "User-Agent" in config.headers : false;
+      setOpenclawUserAgent(ua);
     },
     [],
   );
@@ -170,11 +203,13 @@ export function useOpenclawFormState({
     openclawApiKey,
     openclawApi,
     openclawModels,
+    openclawUserAgent,
     existingOpenclawKeys,
     handleOpenclawBaseUrlChange,
     handleOpenclawApiKeyChange,
     handleOpenclawApiChange,
     handleOpenclawModelsChange,
+    handleOpenclawUserAgentChange,
     resetOpenclawState,
   };
 }