@swarmclawai/swarmclaw 1.7.0 → 1.7.2

package/src/cli/index.ts

@@ -45,9 +45,18 @@ function resolveDefaultAccessKey(cwd: string = process.cwd()): string {
   ).trim()
   if (envKey) return envKey
 
-  const keyFile = path.join(cwd, 'platform-api-key.txt')
-  if (!fs.existsSync(keyFile)) return ''
-  return fs.readFileSync(keyFile, 'utf8').trim()
+  const keyLocations = [
+    path.join(cwd, 'platform-api-key.txt'),
+  ]
+  const serviceHome = (process.env.SWARMCLAW_HOME || '').trim()
+  if (serviceHome) keyLocations.push(path.join(serviceHome, 'platform-api-key.txt'))
+
+  for (const keyFile of keyLocations) {
+    if (!fs.existsSync(keyFile)) continue
+    const value = fs.readFileSync(keyFile, 'utf8').trim()
+    if (value) return value
+  }
+  return ''
 }
 
 const DEFAULT_ACCESS_KEY = resolveDefaultAccessKey()

package/src/components/agents/inspector-panel.tsx

@@ -4,9 +4,9 @@ import { DEFAULT_HEARTBEAT_INTERVAL_SEC } from '@/lib/runtime/heartbeat-defaults
 import { useCallback, useEffect, useMemo, useRef, useState, type ReactNode } from 'react'
 import type { Agent, MemoryEntry, Session } from '@/types'
 import { useAppStore } from '@/stores/use-app-store'
+import { selectActiveSessionId } from '@/stores/slices/session-slice'
 import { useChatStore } from '@/stores/use-chat-store'
 import { api } from '@/lib/app/api-client'
-import { sortSessionsNewestFirst } from '@/lib/chat/new-session'
 import { AgentAvatar } from './agent-avatar'
 import { AgentFilesEditor } from './agent-files-editor'
 import { OpenClawSkillsPanel } from './openclaw-skills-panel'
@@ -901,6 +901,7 @@ function QuickActionsSection({ agent, session }: { agent: Agent; session: Sessio
 
 function SessionsSection({ agent }: { agent: Agent }) {
   const sessions = useAppStore((s) => s.sessions)
+  const activeSessionId = useAppStore(selectActiveSessionId)
   const connectors = useAppStore((s) => s.connectors)
   const agents = useAppStore((s) => s.agents)
   const setCurrentAgent = useAppStore((s) => s.setCurrentAgent)
@@ -908,7 +909,19 @@ function SessionsSection({ agent }: { agent: Agent }) {
   const setInspectorOpen = useAppStore((s) => s.setInspectorOpen)
 
   const agentSessions = useMemo(() => {
-    return sortSessionsNewestFirst(Object.values(sessions).filter((s) => s.agentId === agent.id))
+    const getLastMessageTime = (session: Session): number => {
+      const summaryTime = session.lastMessageSummary?.time
+      if (typeof summaryTime === 'number' && Number.isFinite(summaryTime)) return summaryTime
+      if (Array.isArray(session.messages) && session.messages.length > 0) {
+        const last = session.messages[session.messages.length - 1]
+        if (typeof last?.time === 'number' && Number.isFinite(last.time)) return last.time
+      }
+      return session.lastActiveAt || session.createdAt || 0
+    }
+
+    return Object.values(sessions)
+      .filter((s) => s.agentId === agent.id)
+      .sort((left, right) => getLastMessageTime(right) - getLastMessageTime(left))
   }, [sessions, agent.id])
 
   if (agentSessions.length === 0) return null
@@ -918,6 +931,7 @@ function SessionsSection({ agent }: { agent: Agent }) {
       <SectionLabel>Sessions ({agentSessions.length})</SectionLabel>
       <div className="flex flex-col gap-1.5">
         {agentSessions.map((s) => {
+          const isSelected = s.id === activeSessionId
           const connector = getSessionConnector(s, connectors)
           const delegatedByAgentId = (s as unknown as Record<string, unknown>).delegatedByAgentId as string | undefined
           const delegatedBy = delegatedByAgentId ? agents[delegatedByAgentId] : null
@@ -934,7 +948,10 @@ function SessionsSection({ agent }: { agent: Agent }) {
                   }
                 }).catch(() => {})
               }}
-              className="flex items-center gap-2 w-full py-1.5 px-2 rounded-[8px] bg-transparent border-none cursor-pointer hover:bg-white/[0.04] transition-colors text-left"
+              className={`flex items-center gap-2 w-full py-1.5 px-2 rounded-[8px] border-none cursor-pointer transition-colors text-left
+                ${isSelected
+                  ? 'bg-accent-soft/70 ring-1 ring-accent-bright/25'
+                  : 'bg-transparent hover:bg-white/[0.04]'}`}
             >
               {connector ? (
                 <ConnectorPlatformIcon platform={connector.platform} size={14} />
@@ -944,6 +961,11 @@ function SessionsSection({ agent }: { agent: Agent }) {
                 </svg>
               )}
               <span className="text-[12px] text-text-2 truncate flex-1">{s.name}</span>
+              {isSelected && (
+                <span className="text-[9px] font-700 uppercase tracking-[0.08em] text-accent-bright bg-accent-bright/15 px-1.5 py-0.5 rounded-[6px] shrink-0">
+                  Selected
+                </span>
+              )}
               {delegatedBy && (
                 <span className="text-[9px] text-amber-300/60 font-600 shrink-0">from {delegatedBy.name}</span>
               )}

package/src/components/auth/setup-wizard/index.tsx

@@ -11,7 +11,7 @@ import {
   type OnboardingPath,
   type SetupProvider,
 } from '@/lib/setup-defaults'
-import { resolveLaunchPathHref } from '@/lib/home-launchpad'
+import { DEFAULT_BUILDER_ROUTE } from '@/lib/home-launchpad'
 import type {
   SetupStep,
   SetupWizardProps,
@@ -482,7 +482,11 @@ export function SetupWizard({ onComplete }: SetupWizardProps) {
         <StepNext
           createdAgents={createdAgents}
           onContinueToDashboard={() => finishSetup('/home')}
-          onLaunchPathAction={(id, action) => finishSetup(resolveLaunchPathHref(id, action, createdAgents[0]?.id))}
+          onOpenFirstAgent={() => finishSetup(createdAgents[0]?.id ? `/agents/${encodeURIComponent(createdAgents[0].id)}` : '/agents')}
+          onOpenProtocols={() => finishSetup('/protocols')}
+          onOpenBuilder={() => finishSetup(DEFAULT_BUILDER_ROUTE)}
+          onOpenConnectors={() => finishSetup('/connectors')}
+          onOpenUsage={() => finishSetup('/usage')}
         />
       )}
 

package/src/components/auth/setup-wizard/step-next.tsx

@@ -1,48 +1,19 @@
 'use client'
 
-import { getLaunchPathCards, type LaunchPathAction, type LaunchPathCardCopy, type LaunchPathId } from '@/lib/home-launchpad'
+import { LaunchActionCard } from '@/components/shared/launch-action-card'
 import type { StepNextProps } from './types'
 import { StepShell } from './shared'
 
-function PathCard({
-  card,
-  onAction,
-}: {
-  card: LaunchPathCardCopy
-  onAction: (id: LaunchPathId, action: LaunchPathAction) => void
-}) {
-  return (
-    <div className="flex min-h-[220px] flex-col rounded-[18px] border border-white/[0.07] bg-white/[0.03] p-5 text-left">
-      <div className="text-[11px] font-700 uppercase tracking-[0.12em] text-text-3/55">{card.kicker}</div>
-      <div className="mt-3 text-[18px] font-display font-700 tracking-normal text-text">{card.title}</div>
-      <p className="mt-2 flex-1 text-[13px] leading-relaxed text-text-3/72">{card.description}</p>
-      <div className="mt-5 flex flex-wrap gap-2">
-        <button
-          type="button"
-          onClick={() => onAction(card.id, 'primary')}
-          className="rounded-[10px] bg-accent-bright px-3.5 py-2 text-[12px] font-display font-700 text-black transition-opacity hover:opacity-90"
-        >
-          {card.primaryLabel}
-        </button>
-        <button
-          type="button"
-          onClick={() => onAction(card.id, 'secondary')}
-          className="rounded-[10px] border border-white/[0.08] bg-white/[0.04] px-3.5 py-2 text-[12px] font-display font-700 text-text-2 transition-colors hover:bg-white/[0.08]"
-        >
-          {card.secondaryLabel}
-        </button>
-      </div>
-    </div>
-  )
-}
-
 export function StepNext({
   createdAgents,
   onContinueToDashboard,
-  onLaunchPathAction,
+  onOpenFirstAgent,
+  onOpenProtocols,
+  onOpenBuilder,
+  onOpenConnectors,
+  onOpenUsage,
 }: StepNextProps) {
   const firstAgent = createdAgents[0] || null
-  const launchPathCards = getLaunchPathCards({ firstAgentName: firstAgent?.name })
 
   return (
     <StepShell wide>
@@ -58,10 +29,46 @@ export function StepNext({
           : 'You finished setup without starter agents, so the launch options below focus on wiring up the rest of the workspace.'}
       </p>
 
-      <div className="grid gap-3 xl:grid-cols-3 mb-8">
-        {launchPathCards.map((card) => (
-          <PathCard key={card.id} card={card} onAction={onLaunchPathAction} />
-        ))}
+      <div className="grid gap-3 md:grid-cols-2 xl:grid-cols-3 mb-8">
+        <LaunchActionCard
+          title={firstAgent ? 'Open First Agent Chat' : 'Open Agents'}
+          description={firstAgent
+            ? `Jump straight into ${firstAgent.name} and start working from the workspace you just created.`
+            : 'Open the agents workspace so you can create or tune the first agent manually.'}
+          actionLabel={firstAgent ? 'Open Chat' : 'Open Agents'}
+          onClick={onOpenFirstAgent}
+          tone="primary"
+        />
+        <LaunchActionCard
+          title="Start Structured Session"
+          description="Open bounded collaboration runs for reviews, planning rounds, decision-making, or focused multi-agent work."
+          actionLabel="Open Protocols"
+          onClick={onOpenProtocols}
+        />
+        <LaunchActionCard
+          title="Open Workflow Builder"
+          description="Jump into the visual protocol builder if you want a reusable orchestration graph instead of a one-off run."
+          actionLabel="Open Builder"
+          onClick={onOpenBuilder}
+        />
+        <LaunchActionCard
+          title="Connect a Platform"
+          description="Bridge agents into Discord, Slack, Telegram, WhatsApp, or other runtime connectors."
+          actionLabel="Open Connectors"
+          onClick={onOpenConnectors}
+        />
+        <LaunchActionCard
+          title="Review Usage"
+          description="Inspect cost, provider health, and agent activity so the workspace stays observable from day one."
+          actionLabel="Open Usage"
+          onClick={onOpenUsage}
+        />
+        <LaunchActionCard
+          title="Go to Dashboard"
+          description="Land on the main home view. Fresh workspaces open in guided launch mode before switching to the normal ops dashboard."
+          actionLabel="Open Home"
+          onClick={onContinueToDashboard}
+        />
       </div>
 
       <button

package/src/components/auth/setup-wizard/step-providers.tsx

@@ -3,89 +3,10 @@
 import { useState } from 'react'
 import { api } from '@/lib/app/api-client'
 import { errorMessage } from '@/lib/shared-utils'
+import { SETUP_PROVIDERS } from '@/lib/setup-defaults'
 import type { StepProvidersProps, SetupDoctorResponse } from './types'
-import { getSetupProviderGroups } from './utils'
 import { StepShell, ConfiguredProviderChips } from './shared'
 
-function ReadinessPanel({
-  state,
-  report,
-  error,
-  onRun,
-}: {
-  state: 'idle' | 'checking' | 'done' | 'error'
-  report: SetupDoctorResponse | null
-  error: string
-  onRun: () => void
-}) {
-  const problemChecks = report?.checks.filter((check) => check.status !== 'pass') || []
-  const statusLabel = state === 'done'
-    ? report?.ok
-      ? 'Ready'
-      : `${problemChecks.length} item${problemChecks.length === 1 ? '' : 's'} to review`
-    : state === 'error'
-      ? 'Check failed'
-      : 'Optional check'
-
-  return (
-    <div className="mb-6 rounded-[16px] border border-white/[0.08] bg-white/[0.025] p-4 text-left">
-      <div className="flex flex-col gap-3 sm:flex-row sm:items-start sm:justify-between">
-        <div>
-          <div className="text-[12px] font-display font-700 text-text">Setup readiness</div>
-          <p className="mt-1 text-[12px] leading-relaxed text-text-3/70">
-            Check Node, npm, local storage, secrets, and starter workspace state before connecting a provider.
-          </p>
-        </div>
-        <button
-          type="button"
-          onClick={onRun}
-          disabled={state === 'checking'}
-          className="shrink-0 rounded-[10px] border border-white/[0.08] bg-white/[0.04] px-3 py-2 text-[12px] font-display font-700 text-text-2 transition-colors hover:bg-white/[0.08] disabled:opacity-40"
-        >
-          {state === 'checking' ? 'Checking...' : 'Run Check'}
-        </button>
-      </div>
-
-      <div className="mt-3 flex flex-wrap items-center gap-2">
-        <span className={`rounded-full px-2.5 py-1 text-[11px] font-700 ${
-          state === 'done' && report?.ok
-            ? 'bg-emerald-500/10 text-emerald-300'
-            : state === 'done' || state === 'error'
-              ? 'bg-amber-500/10 text-amber-300'
-              : 'bg-white/[0.05] text-text-3'
-        }`}>
-          {statusLabel}
-        </span>
-        {report && (
-          <span className="text-[11px] text-text-3/65">
-            {report.summary}
-          </span>
-        )}
-        {state === 'error' && error && (
-          <span className="text-[11px] text-rose-300">{error}</span>
-        )}
-      </div>
-
-      {problemChecks.length > 0 && (
-        <div className="mt-3 grid gap-2 sm:grid-cols-2">
-          {problemChecks.slice(0, 4).map((check) => (
-            <div key={check.id} className="rounded-[10px] border border-white/[0.06] bg-white/[0.025] px-3 py-2">
-              <div className="text-[11px] font-700 text-text-2">{check.label}</div>
-              <div className="mt-0.5 text-[11px] leading-relaxed text-text-3/70">{check.detail}</div>
-            </div>
-          ))}
-        </div>
-      )}
-
-      {!!report?.actions?.length && (
-        <div className="mt-3 text-[11px] leading-relaxed text-text-3/70">
-          Next: {report.actions.slice(0, 2).join(' ')}
-        </div>
-      )}
-    </div>
-  )
-}
-
 export function StepProviders({
   configuredProviders,
   configuredProviderIds,
@@ -97,10 +18,10 @@ export function StepProviders({
   onContinue,
   onSkip,
 }: StepProvidersProps) {
+  const [providerSearch, setProviderSearch] = useState('')
   const [doctorState, setDoctorState] = useState<'idle' | 'checking' | 'done' | 'error'>('idle')
   const [doctorError, setDoctorError] = useState('')
   const [doctorReport, setDoctorReport] = useState<SetupDoctorResponse | null>(null)
-  const providerGroups = getSetupProviderGroups()
 
   const runSetupDoctor = async () => {
     setDoctorState('checking')
@@ -116,6 +37,23 @@ export function StepProviders({
     }
   }
 
+  const normalizedSearch = providerSearch.trim().toLowerCase()
+  const visibleProviders = SETUP_PROVIDERS.filter((candidate) => {
+    if (!normalizedSearch) return true
+    return [
+      candidate.name,
+      candidate.description,
+      candidate.badge || '',
+      candidate.id,
+    ].some((part) => part.toLowerCase().includes(normalizedSearch))
+  })
+  const providerGroups = [
+    { id: 'cli', label: 'CLI Agents', items: visibleProviders.filter((candidate) => candidate.category === 'cli') },
+    { id: 'gateway', label: 'Gateways and Local Runtimes', items: visibleProviders.filter((candidate) => candidate.category === 'gateway' || candidate.category === 'local') },
+    { id: 'api', label: 'API Providers', items: visibleProviders.filter((candidate) => !candidate.category || candidate.category === 'api') },
+    { id: 'custom', label: 'Custom', items: visibleProviders.filter((candidate) => candidate.category === 'custom') },
+  ].filter((group) => group.items.length > 0)
+
   return (
     <StepShell>
       <h1 className="font-display text-[36px] font-800 leading-[1.05] tracking-[-0.04em] mb-3">
@@ -130,70 +68,105 @@ export function StepProviders({
 
       <ConfiguredProviderChips providers={configuredProviders} onRemove={onRemoveProvider} />
 
-      <ReadinessPanel
-        state={doctorState}
-        report={doctorReport}
-        error={doctorError}
-        onRun={runSetupDoctor}
+      <input
+        type="search"
+        value={providerSearch}
+        onChange={(e) => setProviderSearch(e.target.value)}
+        placeholder="Search providers, CLIs, or runtimes..."
+        className="w-full px-4 py-3 rounded-[12px] border border-white/[0.08] bg-surface text-text text-[13px]
+          outline-none transition-all duration-200 placeholder:text-text-3/50 focus:border-accent-bright/30 mb-4"
       />
 
-      <div className="max-h-[46vh] overflow-y-auto pr-1 text-left">
-        <div className="flex flex-col gap-5">
-          {providerGroups.map((group) => (
-            <section key={group.id}>
-              <div className="mb-2 px-1">
-                <div className="text-[12px] font-display font-700 text-text">{group.title}</div>
-                <p className="mt-0.5 text-[11px] leading-relaxed text-text-3/65">{group.description}</p>
-              </div>
-              <div className="flex flex-col gap-3">
-                {group.providers.map((candidate) => {
-                  const isConfigured = configuredProviderIds.has(candidate.id)
-                  return (
-                    <button
-                      key={candidate.id}
-                      onClick={() => onSelectProvider(candidate.id)}
-                      className={`w-full px-5 py-4 rounded-[14px] border bg-surface text-left
-                        transition-all duration-200 flex items-start gap-4 cursor-pointer
-                        ${isConfigured
-                          ? 'border-emerald-500/25 hover:border-emerald-500/40 hover:bg-surface-hover'
-                          : 'border-white/[0.08] hover:border-accent-bright/30 hover:bg-surface-hover'
-                        }`}
-                    >
-                      <div className={`w-10 h-10 rounded-[10px] border flex items-center justify-center shrink-0 mt-0.5 ${
-                        isConfigured ? 'bg-emerald-500/10 border-emerald-500/20' : 'bg-white/[0.04] border-white/[0.06]'
-                      }`}>
-                        <span className={`text-[16px] font-display font-700 ${isConfigured ? 'text-emerald-400' : 'text-accent-bright'}`}>
-                          {candidate.icon}
+      <div className="flex flex-col gap-3 max-h-[42vh] overflow-y-auto pr-1">
+        {providerGroups.map((group) => (
+          <div key={group.id} className="space-y-2">
+            <div className="px-1 text-[10px] font-700 uppercase tracking-[0.1em] text-text-3/70">
+              {group.label}
+            </div>
+            {group.items.map((candidate) => {
+              const isConfigured = configuredProviderIds.has(candidate.id)
+              return (
+                <button
+                  key={candidate.id}
+                  onClick={() => onSelectProvider(candidate.id)}
+                  className={`w-full px-5 py-4 rounded-[14px] border bg-surface text-left
+                    transition-all duration-200 flex items-start gap-4 cursor-pointer
+                    ${isConfigured
+                      ? 'border-emerald-500/25 hover:border-emerald-500/40 hover:bg-surface-hover'
+                      : 'border-white/[0.08] hover:border-accent-bright/30 hover:bg-surface-hover'
+                    }`}
+                >
+                  <div className={`w-10 h-10 rounded-[10px] border flex items-center justify-center shrink-0 mt-0.5 ${
+                    isConfigured ? 'bg-emerald-500/10 border-emerald-500/20' : 'bg-white/[0.04] border-white/[0.06]'
+                  }`}>
+                    <span className={`text-[16px] font-display font-700 ${isConfigured ? 'text-emerald-400' : 'text-accent-bright'}`}>
+                      {candidate.icon}
+                    </span>
+                  </div>
+                  <div className="flex-1">
+                    <div className="text-[15px] font-display font-600 text-text mb-1">
+                      {candidate.name}
+                      {isConfigured ? (
+                        <span className="ml-2 inline-flex items-center gap-1 px-2 py-0.5 rounded-md bg-emerald-500/10 text-emerald-300 text-[10px] uppercase tracking-[0.08em] font-600">
+                          Connected · Edit
                         </span>
+                      ) : candidate.badge ? (
+                        <span className="ml-2 inline-flex items-center gap-1 px-2 py-0.5 rounded-md bg-accent-bright/15 text-accent-bright text-[10px] uppercase tracking-[0.08em] font-600">
+                          {candidate.badge}
+                        </span>
+                      ) : null}
+                    </div>
+                    <div className="text-[13px] text-text-3 leading-relaxed">{candidate.description}</div>
+                    {!candidate.requiresKey && !isConfigured && (
+                      <div className="mt-1.5 inline-flex items-center gap-1.5 px-2 py-0.5 rounded-md bg-emerald-500/10 text-emerald-400 text-[11px] font-500">
+                        <span className="w-1.5 h-1.5 rounded-full bg-emerald-400" />
+                        No API key required
                       </div>
-                      <div className="flex-1">
-                        <div className="text-[15px] font-display font-600 text-text mb-1">
-                          {candidate.name}
-                          {isConfigured ? (
-                            <span className="ml-2 inline-flex items-center gap-1 px-2 py-0.5 rounded-md bg-emerald-500/10 text-emerald-300 text-[10px] uppercase tracking-[0.08em] font-600">
-                              Connected · Edit
-                            </span>
-                          ) : candidate.badge ? (
-                            <span className="ml-2 inline-flex items-center gap-1 px-2 py-0.5 rounded-md bg-accent-bright/15 text-accent-bright text-[10px] uppercase tracking-[0.08em] font-600">
-                              {candidate.badge}
-                            </span>
-                          ) : null}
-                        </div>
-                        <div className="text-[13px] text-text-3 leading-relaxed">{candidate.description}</div>
-                        {!candidate.requiresKey && !isConfigured && (
-                          <div className="mt-1.5 inline-flex items-center gap-1.5 px-2 py-0.5 rounded-md bg-emerald-500/10 text-emerald-400 text-[11px] font-500">
-                            <span className="w-1.5 h-1.5 rounded-full bg-emerald-400" />
-                            No API key required
-                          </div>
-                        )}
-                      </div>
-                    </button>
-                  )
-                })}
+                    )}
+                  </div>
+                </button>
+              )
+            })}
+          </div>
+        ))}
+        {providerGroups.length === 0 && (
+          <div className="px-5 py-6 rounded-[14px] border border-white/[0.08] bg-surface text-center text-[13px] text-text-3">
+            No providers match that search.
+          </div>
+        )}
+      </div>
+
+      <div className="mt-4 text-left">
+        <button
+          onClick={runSetupDoctor}
+          disabled={doctorState === 'checking'}
+          className="w-full px-4 py-3 rounded-[12px] border border-white/[0.08] bg-white/[0.02] text-[13px] text-text-2
+            cursor-pointer hover:bg-white/[0.05] transition-all duration-200 disabled:opacity-40"
+        >
+          {doctorState === 'checking' ? 'Running System Check...' : 'Run System Check'}
+        </button>
+
+        {doctorState === 'error' && doctorError && (
+          <p className="mt-2 text-[12px] text-red-300">{doctorError}</p>
+        )}
+
+        {doctorReport && doctorState === 'done' && (
+          <div className="mt-3 p-3 rounded-[12px] border border-white/[0.08] bg-surface">
+            <div className={`text-[12px] font-600 ${doctorReport.ok ? 'text-emerald-300' : 'text-amber-300'}`}>
+              {doctorReport.summary}
+            </div>
+            {doctorReport.checks.filter((check) => check.status !== 'pass').slice(0, 3).map((check) => (
+              <div key={check.id} className="mt-1 text-[11px] text-text-3">
+                - {check.label}: {check.detail}
               </div>
-            </section>
-          ))}
-        </div>
+            ))}
+            {!!doctorReport.actions?.length && (
+              <div className="mt-2 text-[11px] text-text-3/80">
+                Next: {doctorReport.actions.slice(0, 2).join(' ')}
+              </div>
+            )}
+          </div>
+        )}
       </div>
 
       {error && <p className="mt-4 text-[13px] text-red-400">{error}</p>}

package/src/components/auth/setup-wizard/types.ts

@@ -1,6 +1,5 @@
 import type { GatewayProfile, ProviderId } from '@/types'
 import type { SetupProvider } from '@/lib/setup-defaults'
-import type { LaunchPathAction, LaunchPathId } from '@/lib/home-launchpad'
 
 export type SetupStep = 'profile' | 'path' | 'providers' | 'connect' | 'agents' | 'next' | 'done'
 export type CheckState = 'idle' | 'checking' | 'ok' | 'error'
@@ -163,7 +162,11 @@ export interface StepAgentsProps {
 export interface StepNextProps {
   createdAgents: CreatedAgentSummary[]
   onContinueToDashboard: () => void
-  onLaunchPathAction: (id: LaunchPathId, action: LaunchPathAction) => void
+  onOpenFirstAgent: () => void
+  onOpenProtocols: () => void
+  onOpenBuilder: () => void
+  onOpenConnectors: () => void
+  onOpenUsage: () => void
 }
 
 export interface StepDoneProps {

package/src/components/auth/setup-wizard/utils.test.ts

@@ -8,7 +8,6 @@ import {
   isLocalOpenClawEndpoint,
   resolveOpenClawDashboardUrl,
   getOpenClawErrorHint,
-  getSetupProviderGroups,
   requiresSetupProviderVerification,
   withHttpScheme,
   buildStarterDrafts,
@@ -77,24 +76,6 @@ test('getStarterKitsForPath: manual keeps the full catalog', () => {
   assert.equal(ids.has('openclaw_fleet'), true)
 })
 
-test('getSetupProviderGroups puts fast local and no-key providers first', () => {
-  const groups = getSetupProviderGroups()
-  assert.deepEqual(groups.map((group) => group.id), ['fast-local', 'recommended-api', 'advanced-catalog'])
-  assert.equal(groups[0]?.providers[0]?.id, 'claude-cli')
-  assert.equal(groups[0]?.providers.some((provider) => provider.id === 'openclaw'), true)
-  assert.equal(groups[0]?.providers.some((provider) => provider.id === 'ollama'), true)
-})
-
-test('getSetupProviderGroups separates recommended APIs from advanced catalogs', () => {
-  const groups = getSetupProviderGroups()
-  const recommendedIds = new Set(groups.find((group) => group.id === 'recommended-api')?.providers.map((provider) => provider.id))
-  const advancedIds = new Set(groups.find((group) => group.id === 'advanced-catalog')?.providers.map((provider) => provider.id))
-  assert.equal(recommendedIds.has('openai'), true)
-  assert.equal(recommendedIds.has('openrouter'), true)
-  assert.equal(advancedIds.has('custom'), true)
-  assert.equal(advancedIds.has('deepseek'), true)
-})
-
 // ---------------------------------------------------------------------------
 // formatEndpointHost
 // ---------------------------------------------------------------------------

package/src/components/auth/setup-wizard/utils.ts

@@ -1,47 +1,14 @@
 import {
-  SETUP_PROVIDERS,
   STARTER_KITS,
   getDefaultModelForProvider,
   type OnboardingPath,
   type StarterKit,
-  type SetupProviderOption,
   type SetupProvider,
   type StarterKitAgentTemplate,
 } from '@/lib/setup-defaults'
 import type { ConfiguredProvider, SetupStep, StarterDraftAgent } from './types'
 import { STEP_ORDER } from './types'
 
-export type SetupProviderGroupId = 'fast-local' | 'recommended-api' | 'advanced-catalog'
-
-export interface SetupProviderGroup {
-  id: SetupProviderGroupId
-  title: string
-  description: string
-  providers: SetupProviderOption[]
-}
-
-const FAST_LOCAL_PROVIDER_IDS = new Set<SetupProvider>([
-  'claude-cli',
-  'codex-cli',
-  'opencode-cli',
-  'gemini-cli',
-  'copilot-cli',
-  'droid-cli',
-  'cursor-cli',
-  'qwen-code-cli',
-  'goose',
-  'ollama',
-  'openclaw',
-  'hermes',
-])
-
-const RECOMMENDED_API_PROVIDER_IDS = new Set<SetupProvider>([
-  'openai',
-  'openrouter',
-  'anthropic',
-  'google',
-])
-
 export function stepIndex(step: SetupStep): number {
   if (step === 'connect') return STEP_ORDER.indexOf('providers')
   return STEP_ORDER.indexOf(step)
@@ -71,42 +38,6 @@ export function getStarterKitsForPath(path: OnboardingPath): StarterKit[] {
   return STARTER_KITS
 }
 
-export function getSetupProviderGroups(providers: SetupProviderOption[] = SETUP_PROVIDERS): SetupProviderGroup[] {
-  const groups: SetupProviderGroup[] = [
-    {
-      id: 'fast-local',
-      title: 'Fast local and no-key starts',
-      description: 'Use an installed CLI, a local runtime, or an existing OpenClaw/Hermes gateway.',
-      providers: [],
-    },
-    {
-      id: 'recommended-api',
-      title: 'Recommended API providers',
-      description: 'Good first choices for cloud-backed chats, agents, and workflow runs.',
-      providers: [],
-    },
-    {
-      id: 'advanced-catalog',
-      title: 'Advanced catalog and custom endpoints',
-      description: 'Specialized model catalogs, OpenAI-compatible servers, and provider-specific setups.',
-      providers: [],
-    },
-  ]
-  const byId = new Map(groups.map((group) => [group.id, group]))
-
-  for (const provider of providers) {
-    if (FAST_LOCAL_PROVIDER_IDS.has(provider.id)) {
-      byId.get('fast-local')!.providers.push(provider)
-    } else if (RECOMMENDED_API_PROVIDER_IDS.has(provider.id)) {
-      byId.get('recommended-api')!.providers.push(provider)
-    } else {
-      byId.get('advanced-catalog')!.providers.push(provider)
-    }
-  }
-
-  return groups.filter((group) => group.providers.length > 0)
-}
-
 export function applyIntentContext(prompt: string, intentText: string): string {
   const trimmed = intentText.trim()
   if (!trimmed) return prompt