@swarmclawai/swarmclaw 0.7.5 → 0.7.7

package/src/lib/server/orchestrator.ts

@@ -19,9 +19,16 @@ export function createOrchestratorSession(
   task: string,
   parentSessionId?: string,
   cwd?: string,
+  routePreferences?: {
+    preferredGatewayTags?: string[]
+    preferredGatewayUseCase?: string | null
+  } | null,
 ): string {
   const sessions = loadSessions()
   const sessionId = genId()
+  const preferredGatewayTags = Array.isArray(routePreferences?.preferredGatewayTags)
+    ? routePreferences.preferredGatewayTags.filter((tag) => typeof tag === 'string' && tag.trim())
+    : []
   sessions[sessionId] = {
     id: sessionId,
     name: `[Orch] ${orchestrator.name}: ${task.slice(0, 40)}`,
@@ -31,6 +38,8 @@ export function createOrchestratorSession(
     model: orchestrator.model,
     credentialId: orchestrator.credentialId || null,
     apiEndpoint: orchestrator.apiEndpoint || null,
+    routePreferredGatewayTags: preferredGatewayTags,
+    routePreferredGatewayUseCase: routePreferences?.preferredGatewayUseCase || null,
     claudeSessionId: null,
     codexThreadId: null,
     opencodeSessionId: null,

package/src/lib/server/queue.ts

@@ -80,6 +80,36 @@ function normalizeInt(value: unknown, fallback: number, min: number, max: number
   return Math.max(min, Math.min(max, Math.trunc(parsed)))
 }
 
+const OPENCLAW_USE_CASE_TAGS = new Set([
+  'local-dev',
+  'single-vps',
+  'private-tailnet',
+  'browser-heavy',
+  'team-control',
+])
+
+function deriveTaskRoutePreferences(task: BoardTask): {
+  preferredGatewayTags?: string[]
+  preferredGatewayUseCase?: string | null
+} {
+  const tags = Array.isArray(task.tags)
+    ? [...new Set(task.tags.map((tag) => (typeof tag === 'string' ? tag.trim().toLowerCase() : '')).filter(Boolean))]
+    : []
+  const customUseCase = typeof task.customFields?.openclawUseCase === 'string'
+    ? task.customFields.openclawUseCase
+    : typeof task.customFields?.gatewayUseCase === 'string'
+      ? task.customFields.gatewayUseCase
+      : null
+  const preferredGatewayUseCase = customUseCase && OPENCLAW_USE_CASE_TAGS.has(customUseCase)
+    ? customUseCase
+    : (tags.find((tag) => OPENCLAW_USE_CASE_TAGS.has(tag)) || null)
+  const preferredGatewayTags = tags.filter((tag) => tag !== preferredGatewayUseCase)
+  return {
+    preferredGatewayTags,
+    preferredGatewayUseCase,
+  }
+}
+
 function resolveTaskPolicy(task: BoardTask): { maxAttempts: number; backoffSec: number } {
   const settings = loadSettings()
   const defaultMaxAttempts = normalizeInt(settings.defaultTaskMaxAttempts, 3, 1, 20)
@@ -1137,6 +1167,7 @@ export async function processNext() {
 
       // Resolve the agent's persistent thread session to use as parentSessionId
       const agentThreadSessionId = agent.threadSessionId || null
+      const taskRoutePreferences = deriveTaskRoutePreferences(task)
 
       if (isScheduleTask && sourceScheduleId) {
         const schedules = loadSchedules()
@@ -1151,7 +1182,13 @@ export async function processNext() {
           }
         }
         if (!sessionId) {
-          sessionId = createOrchestratorSession(agent, task.title, agentThreadSessionId || undefined, taskCwd)
+          sessionId = createOrchestratorSession(
+            agent,
+            task.title,
+            agentThreadSessionId || undefined,
+            taskCwd,
+            taskRoutePreferences,
+          )
         }
         if (linkedSchedule && linkedSchedule.lastSessionId !== sessionId) {
           linkedSchedule.lastSessionId = sessionId
@@ -1160,7 +1197,13 @@ export async function processNext() {
           saveSchedules(schedules)
         }
       } else {
-        sessionId = createOrchestratorSession(agent, task.title, agentThreadSessionId || undefined, taskCwd)
+        sessionId = createOrchestratorSession(
+          agent,
+          task.title,
+          agentThreadSessionId || undefined,
+          taskCwd,
+          taskRoutePreferences,
+        )
       }
 
       // Notify the agent's thread that a task has started

package/src/lib/setup-defaults.ts

@@ -48,7 +48,7 @@ export const SETUP_PROVIDERS: SetupProviderOption[] = [
   {
     id: 'openclaw',
     name: 'OpenClaw',
-    description: 'Connect one or more local or remote OpenClaw gateways and map different starter agents to each one.',
+    description: 'Deploy or connect official-only local and remote OpenClaw gateways, then map starter agents across your swarm by role, tag, or use case.',
     requiresKey: false,
     supportsEndpoint: true,
     allowMultiple: true,
@@ -481,7 +481,7 @@ export const STARTER_KITS: StarterKit[] = [
     id: 'openclaw_fleet',
     name: 'OpenClaw Fleet',
     description: 'An OpenClaw-first starter setup for local or remote gateways.',
-    detail: 'Designed for users who want multiple OpenClaw-backed agents right away, including remote endpoint assignments.',
+    detail: 'Designed for users who want multiple OpenClaw-backed agents right away, with official-only local deploy, single-VPS, and private-tailnet defaults built into setup.',
     recommendedFor: ['manual'],
     badge: 'OpenClaw',
     agents: [

package/src/lib/validation/schemas.ts

@@ -10,6 +10,8 @@ const AgentRoutingTargetSchema = z.object({
   fallbackCredentialIds: z.array(z.string()).optional().default([]),
   apiEndpoint: z.string().nullable().optional().default(null),
   gatewayProfileId: z.string().nullable().optional().default(null),
+  preferredGatewayTags: z.array(z.string()).optional().default([]),
+  preferredGatewayUseCase: z.string().nullable().optional().default(null),
   priority: z.number().int().optional(),
 })
 
@@ -23,6 +25,8 @@ export const AgentCreateSchema = z.object({
   fallbackCredentialIds: z.array(z.string()).optional().default([]),
   apiEndpoint: z.string().nullable().optional().default(null),
   gatewayProfileId: z.string().nullable().optional().default(null),
+  preferredGatewayTags: z.array(z.string()).optional().default([]),
+  preferredGatewayUseCase: z.string().nullable().optional().default(null),
   routingStrategy: z.enum(['single', 'balanced', 'economy', 'premium', 'reasoning']).nullable().optional().default(null),
   routingTargets: z.array(AgentRoutingTargetSchema).optional().default([]),
   isOrchestrator: z.boolean().optional().default(false),
@@ -89,6 +93,11 @@ export const ExternalAgentRegisterSchema = z.object({
   gatewayProfileId: z.string().nullable().optional().default(null),
   capabilities: z.array(z.string()).optional().default([]),
   labels: z.array(z.string()).optional().default([]),
+  lifecycleState: z.enum(['active', 'draining', 'cordoned']).optional().default('active'),
+  gatewayTags: z.array(z.string()).optional().default([]),
+  gatewayUseCase: z.string().nullable().optional().default(null),
+  version: z.string().nullable().optional().default(null),
+  lastHealthNote: z.string().nullable().optional().default(null),
   metadata: z.record(z.string(), z.unknown()).nullable().optional().default(null),
   tokenStats: z.object({
     inputTokens: z.number().nonnegative().optional(),

package/src/types/index.ts

@@ -93,6 +93,8 @@ export interface Session {
   fallbackCredentialIds?: string[]
   apiEndpoint?: string | null
   gatewayProfileId?: string | null
+  routePreferredGatewayTags?: string[]
+  routePreferredGatewayUseCase?: string | null
   claudeSessionId: string | null
   codexThreadId?: string | null
   opencodeSessionId?: string | null
@@ -498,6 +500,8 @@ export interface Agent {
   fallbackCredentialIds?: string[]
   apiEndpoint?: string | null
   gatewayProfileId?: string | null
+  preferredGatewayTags?: string[]
+  preferredGatewayUseCase?: string | null
   routingStrategy?: AgentRoutingStrategy | null
   routingTargets?: AgentRoutingTarget[]
   isOrchestrator?: boolean
@@ -1168,6 +1172,58 @@ export interface ProviderConfig {
 
 export type GatewayProvider = 'openclaw'
 export type GatewayHealthState = 'unknown' | 'healthy' | 'degraded' | 'offline' | 'pending'
+export type OpenClawDeploymentMethod = 'local' | 'bundle' | 'ssh' | 'imported'
+export type OpenClawDeploymentProvider =
+  | 'local'
+  | 'hetzner'
+  | 'digitalocean'
+  | 'vultr'
+  | 'linode'
+  | 'lightsail'
+  | 'gcp'
+  | 'azure'
+  | 'oci'
+  | 'generic'
+  | 'render'
+  | 'fly'
+  | 'railway'
+export type OpenClawRemoteDeployTarget = 'docker' | 'render' | 'fly' | 'railway'
+export type OpenClawUseCaseTemplate = 'local-dev' | 'single-vps' | 'private-tailnet' | 'browser-heavy' | 'team-control'
+export type OpenClawExposurePreset = 'private-lan' | 'tailscale' | 'caddy' | 'nginx' | 'ssh-tunnel'
+
+export interface OpenClawGatewayStats {
+  nodeCount?: number
+  connectedNodeCount?: number
+  pendingNodePairings?: number
+  pairedDeviceCount?: number
+  pendingDevicePairings?: number
+  externalRuntimeCount?: number
+}
+
+export interface OpenClawDeploymentConfig {
+  method?: OpenClawDeploymentMethod | null
+  provider?: OpenClawDeploymentProvider | null
+  remoteTarget?: OpenClawRemoteDeployTarget | null
+  useCase?: OpenClawUseCaseTemplate | null
+  exposure?: OpenClawExposurePreset | null
+  managedBy?: 'swarmclaw' | 'manual' | null
+  targetHost?: string | null
+  sshHost?: string | null
+  sshUser?: string | null
+  sshPort?: number | null
+  sshKeyPath?: string | null
+  sshTargetDir?: string | null
+  image?: string | null
+  version?: string | null
+  lastDeployAt?: number | null
+  lastDeployAction?: string | null
+  lastDeployProcessId?: string | null
+  lastDeploySummary?: string | null
+  lastVerifiedAt?: number | null
+  lastVerifiedOk?: boolean | null
+  lastVerifiedMessage?: string | null
+  lastBackupPath?: string | null
+}
 
 export interface GatewayProfile {
   id: string
@@ -1184,6 +1240,8 @@ export interface GatewayProfile {
   lastModelCount?: number | null
   discoveredHost?: string | null
   discoveredPort?: number | null
+  deployment?: OpenClawDeploymentConfig | null
+  stats?: OpenClawGatewayStats | null
   isDefault?: boolean
   createdAt: number
   updatedAt: number
@@ -1256,6 +1314,8 @@ export interface AgentRoutingTarget {
   fallbackCredentialIds?: string[]
   apiEndpoint?: string | null
   gatewayProfileId?: string | null
+  preferredGatewayTags?: string[]
+  preferredGatewayUseCase?: string | null
   priority?: number
 }
 
@@ -1307,6 +1367,11 @@ export interface ExternalAgentRuntime {
   gatewayProfileId?: string | null
   capabilities?: string[]
   labels?: string[]
+  lifecycleState?: 'active' | 'draining' | 'cordoned'
+  gatewayTags?: string[]
+  gatewayUseCase?: string | null
+  version?: string | null
+  lastHealthNote?: string | null
   metadata?: Record<string, unknown> | null
   tokenStats?: {
     inputTokens?: number