diff --git a/apps/web/src/app/(app)/claw/components/SettingsTab.tsx b/apps/web/src/app/(app)/claw/components/SettingsTab.tsx
index c58bda5286..ce8b9c2275 100644
--- a/apps/web/src/app/(app)/claw/components/SettingsTab.tsx
+++ b/apps/web/src/app/(app)/claw/components/SettingsTab.tsx
@@ -20,6 +20,7 @@ import { useEffect, useMemo, useRef, useState } from 'react';
 import { OpenclawImportCard } from './OpenclawImportCard';
 
 import { usePostHog } from 'posthog-js/react';
+import Link from 'next/link';
 import { toast } from 'sonner';
 import { useModelSelectorList } from '@/app/api/openrouter/hooks';
 import { useUser } from '@/hooks/useUser';
@@ -2233,6 +2234,13 @@ export function SettingsTab({
               <p className="text-muted-foreground text-xs">
                 Used for new conversations. Can be changed per-conversation.
               </p>
+              <p className="text-muted-foreground mt-2 text-xs">
+                Configure your own model provider keys in{' '}
+                <Link href="/byok" target="_blank" className="underline">
+                  Kilo BYOK settings
+                </Link>
+                .
+              </p>
             </div>
             <div className="flex items-center gap-2">
               <ModelCombobox
diff --git a/apps/web/src/components/organizations/byok/BYOKKeysManager.tsx b/apps/web/src/components/organizations/byok/BYOKKeysManager.tsx
index d47f5203de..53800154f3 100644
--- a/apps/web/src/components/organizations/byok/BYOKKeysManager.tsx
+++ b/apps/web/src/components/organizations/byok/BYOKKeysManager.tsx
@@ -21,7 +21,7 @@ import {
 import { Input } from '@/components/ui/input';
 import { Label } from '@/components/ui/label';
 import { Switch } from '@/components/ui/switch';
-import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
+import { Card, CardContent, CardFooter, CardHeader, CardTitle } from '@/components/ui/card';
 import { Alert, AlertDescription } from '@/components/ui/alert';
 import { Tooltip, TooltipContent, TooltipTrigger } from '@/components/ui/tooltip';
 import {
@@ -91,6 +91,19 @@ function BYOKDescription() {
   );
 }
 
+function BYOKSetupGuideLink() {
+  return (
+    <a
+      href="https://kilo.ai/docs/getting-started/byok"
+      target="_blank"
+      rel="noopener noreferrer"
+      className="text-muted-foreground hover:text-foreground text-sm underline underline-offset-4 transition-colors"
+    >
+      View the BYOK setup guide
+    </a>
+  );
+}
+
 function SupportedModelsList({ models }: { models: string[] }) {
   const [expanded, setExpanded] = useState(false);
 
@@ -293,11 +306,16 @@ export function BYOKKeysManager({ organizationId }: BYOKKeysManagerProps) {
         <BYOKDescription />
         <Card>
           <CardHeader>
-            <CardTitle>BYOK API Keys</CardTitle>
+            <div className="flex flex-col gap-2">
+              <CardTitle>BYOK API Keys</CardTitle>
+            </div>
           </CardHeader>
           <CardContent>
             <div className="text-muted-foreground">Loading...</div>
           </CardContent>
+          <CardFooter>
+            <BYOKSetupGuideLink />
+          </CardFooter>
         </Card>
       </div>
     );
@@ -317,8 +335,10 @@ export function BYOKKeysManager({ organizationId }: BYOKKeysManagerProps) {
     <div className="space-y-4">
       <BYOKDescription />
       <Card>
-        <CardHeader className="flex flex-row items-center justify-between space-y-0 pb-4">
-          <CardTitle>BYOK API Keys</CardTitle>
+        <CardHeader className="flex flex-row items-start justify-between gap-4 space-y-0 pb-4">
+          <div className="flex flex-col gap-2">
+            <CardTitle>BYOK API Keys</CardTitle>
+          </div>
           <Button onClick={() => setIsDialogOpen(true)} size="sm">
             <Plus className="mr-2 h-4 w-4" />
             Add Key
@@ -622,6 +642,9 @@ export function BYOKKeysManager({ organizationId }: BYOKKeysManagerProps) {
             </DialogFooter>
           </DialogContent>
         </Dialog>
+        <CardFooter>
+          <BYOKSetupGuideLink />
+        </CardFooter>
       </Card>
     </div>
   );