@swarmclawai/swarmclaw 1.9.23 → 1.9.25

package/README.md

@@ -151,13 +151,14 @@ clawhub install swarmclaw
 
 [Browse on ClawHub](https://clawhub.ai/skills/swarmclaw)
 
-## v1.9.23 Highlights
+## v1.9.25 Highlights
 
-Schedule reliability is now more deterministic for recurring autonomous work, especially after restarts or stale stored timing state.
+Gateway lifecycle controls and Slack peer-agent collaboration are now safer for multi-agent operations.
 
-- **Cron drift repair.** Active schedules repair stale future cron slots before they skip the nearest run.
-- **Stable stagger.** Staggered schedules keep a deterministic per-schedule offset.
-- **Mission continuity.** Schedule-created board tasks keep a persistent mission link across recurring runs.
+- **Gateway lifecycle controls.** Providers can activate, drain, cordon, or request restart for saved OpenClaw gateways.
+- **Routing guardrails.** New OpenClaw work skips draining or cordoned gateway profiles, and Operations Pulse flags unavailable gateways.
+- **CLI lifecycle access.** `swarmclaw gateways activate`, `drain`, `cordon`, and `restart` now reach the same lifecycle control endpoint as the provider UI.
+- **Slack peer messages.** Peer bot messages now reach the existing connector policy gates while self-loop messages are still blocked.
 
 ## Hosted Deploys
 
@@ -409,6 +410,16 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.9.25 Highlights
+
+Gateway lifecycle release: saved OpenClaw gateways now have explicit operator lifecycle controls, automatic routing avoids gateways that should not receive new work, and Slack peer-agent messages flow through the existing connector policy gates.
+
+- **Gateway lifecycle controls.** Providers can activate, drain, cordon, and request restart for saved OpenClaw gateway profiles.
+- **Routing guardrails.** OpenClaw route selection skips draining and cordoned profiles, including default, preferred, and pinned gateway paths.
+- **Operations Pulse awareness.** Cordoned and draining gateways now appear as operator attention items before they surprise a handoff or release check.
+- **CLI lifecycle access.** `swarmclaw gateways activate`, `drain`, `cordon`, and `restart` now post the matching lifecycle action for automation and release scripts.
+- **Slack peer collaboration.** Slack peer-bot messages are no longer dropped before group policy, mention, and self-loop protections run.
+
 ### v1.9.23 Highlights
 
 Schedule reliability release: recurring work now repairs stale timing state before it can skip the nearest run, and scheduled board tasks keep mission context across repeat launches.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.9.23",
+  "version": "1.9.25",
   "description": "Build and run autonomous AI agents with OpenClaw, Hermes, multiple model providers, orchestration, delegation, memory, skills, schedules, and chat connectors.",
   "main": "electron-dist/main.js",
   "license": "MIT",
@@ -39,7 +39,7 @@
     "node": ">=22.6.0"
   },
   "bin": {
-    "swarmclaw": "./bin/swarmclaw.js"
+    "swarmclaw": "bin/swarmclaw.js"
   },
   "files": [
     "bin/",
@@ -88,7 +88,7 @@
     "test:cli": "node --test src/cli/*.test.js bin/*.test.js scripts/electron-after-pack.test.mjs scripts/electron-signing-config.test.mjs scripts/ensure-sandbox-browser-image.test.mjs scripts/postinstall.test.mjs scripts/run-next-build.test.mjs scripts/run-next-typegen.test.mjs",
     "test:setup": "tsx --test src/app/api/setup/check-provider/route.test.ts src/lib/server/provider-model-discovery.test.ts src/components/auth/setup-wizard/utils.test.ts src/components/auth/setup-wizard/types.test.ts src/hooks/setup-done-detection.test.ts src/lib/setup-defaults.test.ts src/lib/server/storage-auth.test.ts src/lib/server/storage-auth-docker.test.ts",
     "test:openclaw": "tsx --test src/lib/openclaw/openclaw-agent-id.test.ts src/lib/openclaw/openclaw-endpoint.test.ts src/lib/server/agents/agent-runtime-config.test.ts src/lib/server/build-llm.test.ts src/lib/server/connectors/connector-routing.test.ts src/lib/server/connectors/openclaw.test.ts src/lib/server/connectors/swarmdock.test.ts src/lib/server/gateway/protocol.test.ts src/lib/server/gateways/gateway-topology.test.ts src/lib/server/llm-response-cache.test.ts src/lib/server/mcp-conformance.test.ts src/lib/server/openclaw/agent-resolver.test.ts src/lib/server/openclaw/deploy.test.ts src/lib/server/openclaw/skills-normalize.test.ts src/lib/server/session-tools/openclaw-nodes.test.ts src/lib/server/session-tools/swarmdock.test.ts src/lib/server/tasks/task-quality-gate.test.ts src/lib/server/tasks/task-validation.test.ts src/lib/server/tool-capability-policy.test.ts src/lib/providers/openai.test.ts src/lib/providers/openclaw-exports.test.ts src/app/api/gateways/topology-route.test.ts src/app/api/openclaw/dashboard-url/route.test.ts",
-    "test:runtime": "tsx --test src/lib/a2a/agent-card.test.ts src/lib/agent-planning-mode.test.ts src/lib/agent-config-history.test.ts src/lib/strip-internal-metadata.test.ts src/lib/provider-sets.test.ts src/lib/providers/opencode-cli.test.ts src/lib/providers/cli-provider-metadata.test.ts src/lib/providers/cli-utils.test.ts src/lib/providers/generic-cli.test.ts src/lib/server/agents/delegation-advisory.test.ts src/lib/server/cli-provider-readiness.test.ts src/lib/server/provider-health.test.ts src/lib/server/provider-diagnostics.test.ts src/lib/server/mcp-gateway-runtime.test.ts src/lib/server/mcp-connection-pool.test.ts src/lib/server/knowledge-sources.test.ts src/lib/server/extension-managed-resources.test.ts src/lib/server/eval/baseline.test.ts src/lib/server/eval/environment-plan.test.ts src/lib/server/chat-execution/chat-execution-grounding.test.ts src/lib/server/chat-execution/chat-turn-preparation.test.ts src/lib/server/chat-execution/iteration-timers.test.ts src/lib/server/chat-execution/post-stream-finalization.test.ts src/lib/server/chat-execution/prompt-sections.planning-mode.test.ts src/lib/server/chat-execution/reasoning-tag-scrubber.test.ts src/lib/server/chats/clear-undo-snapshots.test.ts src/lib/server/chats/session-context-pack.test.ts src/lib/server/connectors/email.test.ts src/lib/server/protocols/protocol-service.test.ts src/lib/server/runtime/run-ledger.test.ts src/lib/server/runtime/queue-retry-policy.test.ts src/lib/server/runs/run-brief.test.ts src/lib/server/runs/run-handoff.test.ts src/lib/server/operations/operation-pulse.test.ts src/lib/server/schedules/schedule-history.test.ts src/lib/server/schedules/schedule-timing.test.ts src/lib/server/schedules/schedule-preview.test.ts src/lib/quality/release-readiness.test.ts src/lib/quality/architecture-health.test.ts src/lib/server/artifacts/artifact-resolver.test.ts src/lib/server/observability/otel-config.test.ts src/lib/server/safe-parse-body.test.ts src/lib/server/missions/mission-templates.test.ts src/lib/server/sharing/share-link-repository.test.ts src/lib/server/sharing/share-resolver.test.ts src/lib/server/tasks/task-execution-workspace.test.ts src/lib/server/tasks/task-execution-policy.test.ts src/lib/server/tasks/task-handoff.test.ts src/lib/server/tasks/task-service.test.ts src/lib/server/session-tools/execute.test.ts src/lib/server/session-tools/manage-tasks.test.ts src/lib/server/session-tools/web-crawl.test.ts src/lib/app/view-constants.test.ts src/lib/quality/quality-summary.test.ts src/app/api/approvals/route.test.ts src/app/api/agents/agents-route.test.ts src/app/api/tasks/tasks-route.test.ts src/app/api/tasks/task-workspace-route.test.ts src/app/api/chats/chat-route.test.ts src/app/api/chats/clear-route.test.ts src/app/api/chats/compact-route.test.ts src/app/api/chats/context-pack-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/config-versions/config-versions-route.test.ts src/app/api/runs/run-handoff-route.test.ts src/app/api/connectors/connector-doctor-route.test.ts src/app/api/extensions/managed-resources/route.test.ts src/app/api/healthz/route.test.ts src/app/api/logs/route.test.ts src/app/api/portability/export/route.test.ts src/app/api/portability/import/route.test.ts src/app/api/providers/[id]/route.test.ts src/app/api/schedules/preview/route.test.ts src/app/api/schedules/schedule-history-route.test.ts src/app/api/tts/route.test.ts",
+    "test:runtime": "tsx --test src/lib/a2a/agent-card.test.ts src/lib/agent-planning-mode.test.ts src/lib/agent-config-history.test.ts src/lib/strip-internal-metadata.test.ts src/lib/provider-sets.test.ts src/lib/providers/opencode-cli.test.ts src/lib/providers/cli-provider-metadata.test.ts src/lib/providers/cli-utils.test.ts src/lib/providers/generic-cli.test.ts src/lib/server/agents/delegation-advisory.test.ts src/lib/server/agents/agent-runtime-config.test.ts src/lib/server/cli-provider-readiness.test.ts src/lib/server/provider-health.test.ts src/lib/server/provider-diagnostics.test.ts src/lib/server/mcp-gateway-runtime.test.ts src/lib/server/mcp-connection-pool.test.ts src/lib/server/knowledge-sources.test.ts src/lib/server/extension-managed-resources.test.ts src/lib/server/eval/baseline.test.ts src/lib/server/eval/environment-plan.test.ts src/lib/server/chat-execution/chat-execution-grounding.test.ts src/lib/server/chat-execution/chat-turn-preparation.test.ts src/lib/server/chat-execution/iteration-timers.test.ts src/lib/server/chat-execution/post-stream-finalization.test.ts src/lib/server/chat-execution/prompt-sections.planning-mode.test.ts src/lib/server/chat-execution/reasoning-tag-scrubber.test.ts src/lib/server/chats/clear-undo-snapshots.test.ts src/lib/server/chats/session-context-pack.test.ts src/lib/server/connectors/email.test.ts src/lib/server/connectors/slack.test.ts src/lib/server/protocols/protocol-service.test.ts src/lib/server/runtime/run-ledger.test.ts src/lib/server/runtime/queue-retry-policy.test.ts src/lib/server/runs/run-brief.test.ts src/lib/server/runs/run-handoff.test.ts src/lib/server/operations/operation-pulse.test.ts src/lib/server/schedules/schedule-history.test.ts src/lib/server/schedules/schedule-timing.test.ts src/lib/server/schedules/schedule-preview.test.ts src/lib/quality/release-readiness.test.ts src/lib/quality/architecture-health.test.ts src/lib/server/artifacts/artifact-resolver.test.ts src/lib/server/observability/otel-config.test.ts src/lib/server/safe-parse-body.test.ts src/lib/server/missions/mission-templates.test.ts src/lib/server/sharing/share-link-repository.test.ts src/lib/server/sharing/share-resolver.test.ts src/lib/server/tasks/task-execution-workspace.test.ts src/lib/server/tasks/task-execution-policy.test.ts src/lib/server/tasks/task-handoff.test.ts src/lib/server/tasks/task-service.test.ts src/lib/server/session-tools/execute.test.ts src/lib/server/session-tools/manage-tasks.test.ts src/lib/server/session-tools/web-crawl.test.ts src/lib/app/view-constants.test.ts src/lib/quality/quality-summary.test.ts src/app/api/approvals/route.test.ts src/app/api/agents/agents-route.test.ts src/app/api/tasks/tasks-route.test.ts src/app/api/tasks/task-workspace-route.test.ts src/app/api/chats/chat-route.test.ts src/app/api/chats/clear-route.test.ts src/app/api/chats/compact-route.test.ts src/app/api/chats/context-pack-route.test.ts src/app/api/chats/context-status-route.test.ts src/app/api/config-versions/config-versions-route.test.ts src/app/api/runs/run-handoff-route.test.ts src/app/api/connectors/connector-doctor-route.test.ts src/app/api/extensions/managed-resources/route.test.ts src/app/api/gateways/control-route.test.ts src/app/api/healthz/route.test.ts src/app/api/logs/route.test.ts src/app/api/portability/export/route.test.ts src/app/api/portability/import/route.test.ts src/app/api/providers/[id]/route.test.ts src/app/api/schedules/preview/route.test.ts src/app/api/schedules/schedule-history-route.test.ts src/app/api/tts/route.test.ts",
     "test:builder": "tsx --test src/features/protocols/builder/utils/nodes-to-template.test.ts src/features/protocols/builder/utils/template-to-nodes.test.ts src/features/protocols/builder/validators/dag-validator.test.ts",
     "test:e2e": "node --import tsx scripts/browser-e2e-smoke.ts",
     "test:mcp:conformance": "node --import tsx ./scripts/mcp-conformance-check.ts",

package/src/app/api/gateways/[id]/control/route.ts

@@ -0,0 +1,22 @@
+import { NextResponse } from 'next/server'
+
+import { controlGatewayProfile } from '@/lib/server/gateways/gateway-profile-service'
+import { notFound } from '@/lib/server/collection-helpers'
+import { GatewayControlSchema, formatZodError } from '@/lib/validation/schemas'
+
+export const dynamic = 'force-dynamic'
+
+export async function POST(req: Request, { params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params
+  const raw = await req.json().catch(() => null)
+  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+    return NextResponse.json({ error: 'Invalid or missing request body' }, { status: 400 })
+  }
+
+  const parsed = GatewayControlSchema.safeParse(raw)
+  if (!parsed.success) return NextResponse.json(formatZodError(parsed.error), { status: 400 })
+
+  const result = controlGatewayProfile(id, parsed.data)
+  if (!result) return notFound()
+  return NextResponse.json(result)
+}

package/src/app/api/gateways/control-route.test.ts

@@ -0,0 +1,86 @@
+import assert from 'node:assert/strict'
+import { afterEach, test } from 'node:test'
+
+import { POST } from '@/app/api/gateways/[id]/control/route'
+import { loadGatewayProfiles, saveGatewayProfiles } from '@/lib/server/storage'
+
+const originalGateways = loadGatewayProfiles()
+
+afterEach(() => {
+  saveGatewayProfiles(originalGateways)
+})
+
+function saveTestGateway(id = 'gateway-control-test') {
+  saveGatewayProfiles({
+    ...loadGatewayProfiles(),
+    [id]: {
+      id,
+      name: 'Gateway Control Test',
+      provider: 'openclaw',
+      endpoint: 'http://127.0.0.1:18789/v1',
+      wsUrl: 'ws://127.0.0.1:18789',
+      credentialId: null,
+      status: 'healthy',
+      lifecycleState: 'active',
+      notes: null,
+      tags: [],
+      lastError: null,
+      lastCheckedAt: null,
+      lastModelCount: null,
+      discoveredHost: null,
+      discoveredPort: null,
+      deployment: null,
+      stats: null,
+      isDefault: false,
+      createdAt: 1,
+      updatedAt: 1,
+    },
+  })
+}
+
+test('gateway control route drains a gateway profile', async () => {
+  saveTestGateway()
+
+  const response = await POST(new Request('http://local/api/gateways/gateway-control-test/control', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ action: 'drain', reason: 'maintenance' }),
+  }), { params: Promise.resolve({ id: 'gateway-control-test' }) })
+
+  assert.equal(response.status, 200)
+  const payload = await response.json()
+  assert.equal(payload.lifecycleState, 'draining')
+  assert.equal(payload.lastControlAction, 'drain')
+  assert.equal(payload.lastControlReason, 'maintenance')
+  assert.equal(payload.controlRequest, null)
+})
+
+test('gateway control route records restart requests without changing lifecycle', async () => {
+  saveTestGateway()
+
+  const response = await POST(new Request('http://local/api/gateways/gateway-control-test/control', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ action: 'restart' }),
+  }), { params: Promise.resolve({ id: 'gateway-control-test' }) })
+
+  assert.equal(response.status, 200)
+  const payload = await response.json()
+  assert.equal(payload.lifecycleState, 'active')
+  assert.equal(payload.lastControlAction, 'restart')
+  assert.equal(payload.controlRequest?.action, 'restart')
+  assert.equal(payload.controlRequest?.source, 'swarmclaw')
+  assert.equal(typeof payload.controlRequest?.requestedAt, 'number')
+})
+
+test('gateway control route validates control actions', async () => {
+  saveTestGateway()
+
+  const response = await POST(new Request('http://local/api/gateways/gateway-control-test/control', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ action: 'pause' }),
+  }), { params: Promise.resolve({ id: 'gateway-control-test' }) })
+
+  assert.equal(response.status, 400)
+})

package/src/cli/index.js

@@ -278,6 +278,23 @@ const COMMAND_GROUPS = [
       cmd('create', 'POST', '/gateways', 'Create a gateway profile', { expectsJsonBody: true }),
       cmd('update', 'PUT', '/gateways/:id', 'Update a gateway profile', { expectsJsonBody: true }),
       cmd('delete', 'DELETE', '/gateways/:id', 'Delete a gateway profile'),
+      cmd('control', 'POST', '/gateways/:id/control', 'Run a gateway lifecycle control action', { expectsJsonBody: true }),
+      cmd('activate', 'POST', '/gateways/:id/control', 'Return a gateway to active routing', {
+        expectsJsonBody: true,
+        defaultBody: { action: 'activate' },
+      }),
+      cmd('drain', 'POST', '/gateways/:id/control', 'Drain a gateway from new automatic work', {
+        expectsJsonBody: true,
+        defaultBody: { action: 'drain' },
+      }),
+      cmd('cordon', 'POST', '/gateways/:id/control', 'Cordon a gateway from automatic work', {
+        expectsJsonBody: true,
+        defaultBody: { action: 'cordon' },
+      }),
+      cmd('restart', 'POST', '/gateways/:id/control', 'Request a gateway restart', {
+        expectsJsonBody: true,
+        defaultBody: { action: 'restart' },
+      }),
       cmd('health', 'GET', '/gateways/:id/health', 'Run a gateway health check'),
       cmd('topology', 'GET', '/gateways/:id/topology', 'Refresh and return one gateway topology snapshot'),
       cmd('environments', 'GET', '/gateways/:id/environments', 'List OpenClaw gateway execution environments'),

package/src/cli/index.test.js

@@ -225,6 +225,36 @@ test('tasks execution-policy-decision posts policy decisions', async () => {
   assert.equal(stderr.toString(), '')
 })
 
+test('gateways drain command posts a lifecycle control action', async () => {
+  const stdout = makeWritable()
+  const stderr = makeWritable()
+  const calls = []
+
+  const fetchImpl = async (url, init) => {
+    calls.push({ url: String(url), init })
+    return jsonResponse({ ok: true })
+  }
+
+  const exitCode = await runCli(
+    ['gateways', 'drain', 'gateway-1', '--json'],
+    {
+      fetchImpl,
+      stdout,
+      stderr,
+      env: {
+        SWARMCLAW_API_KEY: 'test-key',
+      },
+      cwd: process.cwd(),
+    }
+  )
+
+  assert.equal(exitCode, 0)
+  assert.equal(calls.length, 1)
+  assert.match(calls[0].url, /\/api\/gateways\/gateway-1\/control$/)
+  assert.equal(calls[0].init.method, 'POST')
+  assert.deepEqual(JSON.parse(calls[0].init.body), { action: 'drain' })
+})
+
 test('openclaw deploy bundle command merges action with provided JSON body', async () => {
   const stdout = makeWritable()
   const stderr = makeWritable()

package/src/cli/spec.js

@@ -219,6 +219,11 @@ const COMMAND_GROUPS = {
       create: { description: 'Create a gateway profile', method: 'POST', path: '/gateways' },
       update: { description: 'Update a gateway profile', method: 'PUT', path: '/gateways/:id', params: ['id'] },
       delete: { description: 'Delete a gateway profile', method: 'DELETE', path: '/gateways/:id', params: ['id'] },
+      control: { description: 'Run a gateway lifecycle control action', method: 'POST', path: '/gateways/:id/control', params: ['id'] },
+      activate: { description: 'Return a gateway to active routing', method: 'POST', path: '/gateways/:id/control', params: ['id'] },
+      drain: { description: 'Drain a gateway from new automatic work', method: 'POST', path: '/gateways/:id/control', params: ['id'] },
+      cordon: { description: 'Cordon a gateway from automatic work', method: 'POST', path: '/gateways/:id/control', params: ['id'] },
+      restart: { description: 'Request a gateway restart', method: 'POST', path: '/gateways/:id/control', params: ['id'] },
       health: { description: 'Run a gateway health check', method: 'GET', path: '/gateways/:id/health', params: ['id'] },
       topology: { description: 'Refresh and return one gateway topology snapshot', method: 'GET', path: '/gateways/:id/topology', params: ['id'] },
       environments: { description: 'List OpenClaw gateway execution environments', method: 'GET', path: '/gateways/:id/environments', params: ['id'] },

package/src/components/providers/provider-list.tsx

@@ -13,6 +13,7 @@ import {
 import { useCredentialsQuery, useCreateCredentialMutation } from '@/features/credentials/queries'
 import {
   useCloneGatewayProfileMutation,
+  useGatewayControlMutation,
   useDeleteGatewayProfileMutation,
   useGatewayFleetTopologyQuery,
   useGatewayHealthCheckMutation,
@@ -22,7 +23,7 @@ import {
   useVerifyOpenClawDeployMutation,
 } from '@/features/gateways/queries'
 import { useExternalAgentsQuery, useExternalAgentRuntimeMutation } from '@/features/external-agents/queries'
-import type { GatewayProfile } from '@/types'
+import type { GatewayControlAction, GatewayLifecycleState, GatewayProfile } from '@/types'
 import { dedup } from '@/lib/shared-utils'
 import { PageLoader } from '@/components/ui/page-loader'
 import { StatusDot } from '@/components/ui/status-dot'
@@ -45,6 +46,18 @@ function formatRuntimeTimestamp(value: number | null | undefined): string {
   }).format(value)
 }
 
+function gatewayLifecycleLabel(value: GatewayLifecycleState | null | undefined): string {
+  if (value === 'draining') return 'Draining'
+  if (value === 'cordoned') return 'Cordoned'
+  return 'Active'
+}
+
+function gatewayLifecycleBadgeClass(value: GatewayLifecycleState | null | undefined): string {
+  if (value === 'draining') return 'border-amber-400/20 bg-amber-400/[0.08] text-amber-200'
+  if (value === 'cordoned') return 'border-rose-400/20 bg-rose-400/[0.08] text-rose-200'
+  return 'border-emerald-400/20 bg-emerald-400/[0.08] text-emerald-200'
+}
+
 export function ProviderList({ inSidebar }: { inSidebar?: boolean }) {
   const setProviderSheetOpen = useAppStore((s) => s.setProviderSheetOpen)
   const setEditingProviderId = useAppStore((s) => s.setEditingProviderId)
@@ -63,6 +76,7 @@ export function ProviderList({ inSidebar }: { inSidebar?: boolean }) {
   const saveGatewayMutation = useSaveGatewayProfileMutation()
   const deleteGatewayMutation = useDeleteGatewayProfileMutation()
   const healthCheckGatewayMutation = useGatewayHealthCheckMutation()
+  const gatewayControlMutation = useGatewayControlMutation()
   const refreshGatewayTopologyMutation = useRefreshGatewayTopologyMutation()
   const verifyDeployMutation = useVerifyOpenClawDeployMutation()
   const cloneGatewayMutation = useCloneGatewayProfileMutation()
@@ -211,6 +225,7 @@ export function ProviderList({ inSidebar }: { inSidebar?: boolean }) {
         credentialId: gateway.credentialId || null,
         notes: gateway.notes || null,
         tags: gateway.tags || [],
+        lifecycleState: 'active',
         deployment: gateway.deployment || null,
         stats: gateway.stats || null,
         isDefault: false,
@@ -221,6 +236,27 @@ export function ProviderList({ inSidebar }: { inSidebar?: boolean }) {
     }
   }
 
+  const handleGatewayControl = async (
+    e: React.MouseEvent,
+    gatewayId: string,
+    action: GatewayControlAction,
+  ) => {
+    e.stopPropagation()
+    try {
+      await gatewayControlMutation.mutateAsync({ id: gatewayId, action })
+      const actionLabel = action === 'activate'
+        ? 'Gateway activated'
+        : action === 'drain'
+          ? 'Gateway draining'
+          : action === 'cordon'
+            ? 'Gateway cordoned'
+            : 'Restart requested'
+      toast.success(actionLabel)
+    } catch (err: unknown) {
+      toast.error(err instanceof Error ? err.message : 'Gateway control failed')
+    }
+  }
+
   const handleRuntimeAction = async (
     e: React.MouseEvent,
     runtimeId: string,
@@ -537,6 +573,7 @@ export function ProviderList({ inSidebar }: { inSidebar?: boolean }) {
             const deployment = gateway.deployment || null
             const topology = topologyByGatewayId.get(gateway.id) || null
             const stats = topology?.stats || gateway.stats || null
+            const lifecycleState = gateway.lifecycleState || 'active'
             const topologyErrors = topology?.errors || []
             const pendingPairings = (stats?.pendingNodePairings || 0) + (stats?.pendingDevicePairings || 0)
             const topologyErrorCount = topologyErrors.length || stats?.lastTopologyErrorCount || 0
@@ -569,6 +606,9 @@ export function ProviderList({ inSidebar }: { inSidebar?: boolean }) {
                 {gateway.isDefault && (
                   <span className="text-[10px] font-700 px-2 py-0.5 rounded-[5px] bg-accent-bright/10 text-accent-bright uppercase tracking-wider">Default</span>
                 )}
+                <span className={`text-[10px] font-700 px-2 py-0.5 rounded-[5px] border uppercase tracking-wider ${gatewayLifecycleBadgeClass(lifecycleState)}`}>
+                  {gatewayLifecycleLabel(lifecycleState)}
+                </span>
                 <StatusDot
                   status={
                     gateway.status === 'healthy'
@@ -666,7 +706,40 @@ export function ProviderList({ inSidebar }: { inSidebar?: boolean }) {
               </div>
             )}
             {!inSidebar && (
-              <div className="mt-3 flex items-center gap-2">
+              <div className="mt-3 flex flex-wrap items-center gap-2">
+                {lifecycleState !== 'active' ? (
+                  <button
+                    onClick={(e) => void handleGatewayControl(e, gateway.id, 'activate')}
+                    disabled={gatewayControlMutation.isPending}
+                    className="px-2.5 py-1.5 rounded-[8px] border border-emerald-400/20 bg-emerald-400/[0.06] text-[11px] font-700 text-emerald-200 hover:bg-emerald-400/[0.1] cursor-pointer transition-all disabled:opacity-40"
+                  >
+                    Activate
+                  </button>
+                ) : (
+                  <>
+                    <button
+                      onClick={(e) => void handleGatewayControl(e, gateway.id, 'drain')}
+                      disabled={gatewayControlMutation.isPending}
+                      className="px-2.5 py-1.5 rounded-[8px] border border-amber-400/20 bg-amber-400/[0.06] text-[11px] font-700 text-amber-200 hover:bg-amber-400/[0.1] cursor-pointer transition-all disabled:opacity-40"
+                    >
+                      Drain
+                    </button>
+                    <button
+                      onClick={(e) => void handleGatewayControl(e, gateway.id, 'cordon')}
+                      disabled={gatewayControlMutation.isPending}
+                      className="px-2.5 py-1.5 rounded-[8px] border border-white/[0.08] bg-transparent text-[11px] font-700 text-text-2 hover:bg-white/[0.04] cursor-pointer transition-all disabled:opacity-40"
+                    >
+                      Cordon
+                    </button>
+                  </>
+                )}
+                <button
+                  onClick={(e) => void handleGatewayControl(e, gateway.id, 'restart')}
+                  disabled={gatewayControlMutation.isPending}
+                  className="px-2.5 py-1.5 rounded-[8px] border border-white/[0.08] bg-transparent text-[11px] font-700 text-text-2 hover:bg-white/[0.04] cursor-pointer transition-all disabled:opacity-40"
+                >
+                  Restart
+                </button>
                 <button onClick={(e) => void handleHealthCheckGateway(e, gateway.id)} className="px-2.5 py-1.5 rounded-[8px] border border-white/[0.08] bg-transparent text-[11px] font-700 text-text-2 hover:bg-white/[0.04] cursor-pointer transition-all">
                   Health
                 </button>

package/src/features/gateways/queries.ts

@@ -38,6 +38,12 @@ interface SaveGatewayProfileInput {
   payload: Record<string, unknown>
 }
 
+interface GatewayControlInput {
+  id: string
+  action: 'activate' | 'drain' | 'cordon' | 'restart'
+  reason?: string | null
+}
+
 interface VerifyOpenClawDeployInput {
   endpoint: string
   token?: string
@@ -130,6 +136,17 @@ export function useGatewayHealthCheckMutation() {
   })
 }
 
+export function useGatewayControlMutation() {
+  const queryClient = useQueryClient()
+  return useMutation({
+    mutationFn: ({ id, action, reason }: GatewayControlInput) =>
+      api('POST', `/gateways/${id}/control`, { action, reason }),
+    onSuccess: async () => {
+      await invalidateGatewayQueries(queryClient)
+    },
+  })
+}
+
 export function useGatewayFleetTopologyQuery(options: QueryOptions = {}) {
   return useQuery<OpenClawGatewayFleetTopology>({
     queryKey: gatewayQueryKeys.fleet(),

package/src/lib/server/agents/agent-runtime-config.test.ts

@@ -17,6 +17,11 @@ function makeGateway(overrides: Partial<GatewayProfile> = {}): GatewayProfile {
     wsUrl: 'wss://gateway.example.com',
     credentialId: 'cred-gateway',
     status: 'healthy',
+    lifecycleState: 'active',
+    lastControlAction: null,
+    lastControlActionAt: null,
+    lastControlReason: null,
+    controlRequest: null,
     tags: [],
     isDefault: true,
     createdAt: now,
@@ -62,6 +67,81 @@ test('resolveAgentRouteCandidatesWithProfiles applies the default OpenClaw gatew
   assert.equal(route.apiEndpoint, normalizeProviderEndpoint('openclaw', 'https://gateway.example.com/v1'))
 })
 
+test('resolveAgentRouteCandidatesWithProfiles routes around draining default gateways', () => {
+  const gateways = [
+    makeGateway({
+      lifecycleState: 'draining',
+    }),
+    makeGateway({
+      id: 'gateway-secondary',
+      name: 'Gateway Secondary',
+      endpoint: 'https://secondary.example.com/v1',
+      wsUrl: 'wss://secondary.example.com',
+      credentialId: 'cred-secondary',
+      isDefault: false,
+    }),
+  ]
+
+  const [route] = resolveAgentRouteCandidatesWithProfiles(makeAgent(), gateways)
+  assert.ok(route)
+  assert.equal(route.gatewayProfileId, 'gateway-secondary')
+  assert.equal(route.credentialId, 'cred-secondary')
+  assert.equal(route.apiEndpoint, normalizeProviderEndpoint('openclaw', 'https://secondary.example.com/v1'))
+})
+
+test('resolveAgentRouteCandidatesWithProfiles ignores cordoned preferred gateways', () => {
+  const gateways = [
+    makeGateway({
+      id: 'gateway-specialized',
+      name: 'Specialized Gateway',
+      tags: ['browser'],
+      lifecycleState: 'cordoned',
+    }),
+    makeGateway({
+      id: 'gateway-active',
+      name: 'Active Gateway',
+      endpoint: 'https://active.example.com/v1',
+      wsUrl: 'wss://active.example.com',
+      credentialId: 'cred-active',
+      tags: [],
+      isDefault: false,
+    }),
+  ]
+
+  const [route] = resolveAgentRouteCandidatesWithProfiles(makeAgent(), gateways, undefined, undefined, {
+    preferredGatewayTags: ['browser'],
+  })
+  assert.ok(route)
+  assert.equal(route.gatewayProfileId, 'gateway-active')
+})
+
+test('resolveAgentRouteCandidatesWithProfiles drops OpenClaw routes when every gateway is cordoned', () => {
+  const routes = resolveAgentRouteCandidatesWithProfiles(makeAgent({
+    gatewayProfileId: 'gateway-default',
+  }), [
+    makeGateway({
+      lifecycleState: 'cordoned',
+    }),
+  ])
+
+  assert.equal(routes.length, 0)
+})
+
+test('resolveAgentRouteCandidatesWithProfiles keeps explicit direct OpenClaw routes while saved gateways are cordoned', () => {
+  const [route] = resolveAgentRouteCandidatesWithProfiles(makeAgent({
+    gatewayProfileId: null,
+    apiEndpoint: 'https://direct.example.com/v1',
+  }), [
+    makeGateway({
+      lifecycleState: 'cordoned',
+    }),
+  ])
+
+  assert.ok(route)
+  assert.equal(route.gatewayProfileId, null)
+  assert.equal(route.apiEndpoint, normalizeProviderEndpoint('openclaw', 'https://direct.example.com/v1'))
+})
+
 test('resolveAgentRouteCandidatesWithProfiles respects routing strategy but deprioritizes cooling providers', () => {
   const gateways = [
     makeGateway({

package/src/lib/server/agents/agent-runtime-config.ts

@@ -65,6 +65,29 @@ function normalizeNullableNumber(value: unknown): number | null {
   return typeof value === 'number' && Number.isFinite(value) ? value : null
 }
 
+function normalizeGatewayLifecycleState(value: unknown): NonNullable<GatewayProfile['lifecycleState']> {
+  return value === 'draining' || value === 'cordoned' ? value : 'active'
+}
+
+function normalizeGatewayControlAction(value: unknown): GatewayProfile['lastControlAction'] {
+  return value === 'activate' || value === 'drain' || value === 'cordon' || value === 'restart'
+    ? value
+    : null
+}
+
+function normalizeGatewayControlRequest(value: unknown): GatewayProfile['controlRequest'] {
+  if (!value || typeof value !== 'object') return null
+  const request = value as Record<string, unknown>
+  const requestedAt = normalizeNullableNumber(request.requestedAt)
+  if (request.action !== 'restart' || !requestedAt) return null
+  return {
+    action: 'restart',
+    requestedAt,
+    source: 'swarmclaw',
+    reason: normalizeText(request.reason),
+  }
+}
+
 function normalizeGatewayDeployment(
   value: unknown,
 ): GatewayProfile['deployment'] {
@@ -109,6 +132,13 @@ function normalizeGatewayStats(value: unknown): GatewayProfile['stats'] {
     pairedDeviceCount: normalizeNullableNumber(stats.pairedDeviceCount) ?? undefined,
     pendingDevicePairings: normalizeNullableNumber(stats.pendingDevicePairings) ?? undefined,
     externalRuntimeCount: normalizeNullableNumber(stats.externalRuntimeCount) ?? undefined,
+    sessionCount: normalizeNullableNumber(stats.sessionCount) ?? undefined,
+    presenceCount: normalizeNullableNumber(stats.presenceCount) ?? undefined,
+    environmentCount: normalizeNullableNumber(stats.environmentCount) ?? undefined,
+    availableEnvironmentCount: normalizeNullableNumber(stats.availableEnvironmentCount) ?? undefined,
+    lastTopologyCheckedAt: normalizeNullableNumber(stats.lastTopologyCheckedAt) ?? undefined,
+    lastTopologyErrorCount: normalizeNullableNumber(stats.lastTopologyErrorCount) ?? undefined,
+    lastTopologyError: normalizeText(stats.lastTopologyError),
   }
 }
 
@@ -139,6 +169,11 @@ function normalizeGateway(raw: unknown, id: string): GatewayProfile | null {
     wsUrl: typeof gateway.wsUrl === 'string' && gateway.wsUrl.trim() ? gateway.wsUrl.trim() : deriveOpenClawWsUrl(endpoint),
     credentialId: typeof gateway.credentialId === 'string' && gateway.credentialId.trim() ? gateway.credentialId.trim() : null,
     status: gateway.status === 'healthy' || gateway.status === 'degraded' || gateway.status === 'offline' || gateway.status === 'pending' ? gateway.status : 'unknown',
+    lifecycleState: normalizeGatewayLifecycleState(gateway.lifecycleState),
+    lastControlAction: normalizeGatewayControlAction(gateway.lastControlAction),
+    lastControlActionAt: normalizeNullableNumber(gateway.lastControlActionAt),
+    lastControlReason: normalizeText(gateway.lastControlReason),
+    controlRequest: normalizeGatewayControlRequest(gateway.controlRequest),
     notes: typeof gateway.notes === 'string' ? gateway.notes : null,
     tags: ensureStringArray(gateway.tags),
     lastError: typeof gateway.lastError === 'string' ? gateway.lastError : null,
@@ -163,6 +198,18 @@ function findGatewayProfile(
   return gatewayProfiles.find((profile) => profile.id === id) || null
 }
 
+export function isGatewayAcceptingNewWork(gatewayProfile: GatewayProfile | null | undefined): boolean {
+  return normalizeGatewayLifecycleState(gatewayProfile?.lifecycleState) === 'active'
+}
+
+function findAcceptingGatewayProfile(
+  gatewayProfiles: GatewayProfile[],
+  profileId?: string | null,
+): GatewayProfile | null {
+  const gatewayProfile = findGatewayProfile(gatewayProfiles, profileId)
+  return isGatewayAcceptingNewWork(gatewayProfile) ? gatewayProfile : null
+}
+
 export function getGatewayProfiles(provider: GatewayProfile['provider'] | null = null): GatewayProfile[] {
   const all = loadGatewayProfiles()
   return Object.entries(all)
@@ -180,13 +227,15 @@ export function getGatewayProfile(profileId?: string | null): GatewayProfile | n
 }
 
 function defaultGatewayProfile(gatewayProfiles: GatewayProfile[]): GatewayProfile | null {
-  return gatewayProfiles.find((profile) => profile.isDefault) || gatewayProfiles[0] || null
+  const accepting = gatewayProfiles.filter(isGatewayAcceptingNewWork)
+  return accepting.find((profile) => profile.isDefault) || accepting[0] || null
 }
 
 function gatewayPreferenceScore(
   gatewayProfile: GatewayProfile,
   preferences?: GatewayRoutePreferences | null,
 ): number {
+  if (!isGatewayAcceptingNewWork(gatewayProfile)) return -1
   const normalized = normalizeRoutePreferences(preferences)
   const preferredTags = normalized.preferredGatewayTags || []
   const preferredUseCase = normalized.preferredGatewayUseCase || null
@@ -263,13 +312,15 @@ function buildRouteFromSeed(
     preferredGatewayTags: seed.preferredGatewayTags ?? routePreferences?.preferredGatewayTags,
     preferredGatewayUseCase: seed.preferredGatewayUseCase ?? routePreferences?.preferredGatewayUseCase,
   })
-  let gatewayProfile = findGatewayProfile(gatewayProfiles, seed.gatewayProfileId ?? null)
+  let gatewayProfile = findAcceptingGatewayProfile(gatewayProfiles, seed.gatewayProfileId ?? null)
   if (!gatewayProfile && provider === 'openclaw') {
     gatewayProfile = pickPreferredGatewayProfile(gatewayProfiles, mergedPreferences)
-      || findGatewayProfile(gatewayProfiles, agentGatewayProfileId ?? null)
+      || findAcceptingGatewayProfile(gatewayProfiles, agentGatewayProfileId ?? null)
       || defaultGatewayProfile(gatewayProfiles)
   }
-  const gatewayProfileId = gatewayProfile?.id ?? seed.gatewayProfileId ?? agentGatewayProfileId ?? null
+  const hasExplicitDirectEndpoint = typeof seed.apiEndpoint === 'string' && seed.apiEndpoint.trim().length > 0
+  if (provider === 'openclaw' && gatewayProfiles.length > 0 && !gatewayProfile && !hasExplicitDirectEndpoint) return null
+  const gatewayProfileId = gatewayProfile?.id ?? null
 
   const providerFromGateway = gatewayProfile?.provider === 'openclaw' ? 'openclaw' : provider
   const model = (seed.model || '').trim() || (providerFromGateway === 'openclaw' ? DEFAULT_OPENCLAW_MODEL : '')

package/src/lib/server/connectors/slack.test.ts

@@ -0,0 +1,30 @@
+import assert from 'node:assert/strict'
+import { test } from 'node:test'
+
+import { shouldAcceptSlackMessageEvent } from './slack'
+
+test('shouldAcceptSlackMessageEvent accepts peer bot text messages', () => {
+  assert.equal(shouldAcceptSlackMessageEvent({
+    type: 'message',
+    text: 'Marian, can you review this?',
+    user: 'U_PEER_AGENT',
+    bot_id: 'B_PEER_AGENT',
+  }, 'U_SELF_AGENT'), true)
+})
+
+test('shouldAcceptSlackMessageEvent still rejects self-loop messages', () => {
+  assert.equal(shouldAcceptSlackMessageEvent({
+    type: 'message',
+    text: 'Loopback',
+    user: 'U_SELF_AGENT',
+    bot_id: 'B_SELF_AGENT',
+  }, 'U_SELF_AGENT'), false)
+})
+
+test('shouldAcceptSlackMessageEvent rejects non-text message events', () => {
+  assert.equal(shouldAcceptSlackMessageEvent({
+    type: 'message',
+    subtype: 'channel_join',
+    user: 'U_PEER_AGENT',
+  }, 'U_SELF_AGENT'), false)
+})

package/src/lib/server/connectors/slack.ts

@@ -106,6 +106,12 @@ async function hydrateSlackThreadContext(params: {
   }
 }
 
+export function shouldAcceptSlackMessageEvent(message: unknown, botUserId?: string): boolean {
+  if (!message || typeof message !== 'object' || !('text' in message)) return false
+  const msg = message as { user?: unknown }
+  return !(botUserId && typeof msg.user === 'string' && msg.user === botUserId)
+}
+
 const slack: PlatformConnector = {
   async start(connector, botToken, onMessage): Promise<ConnectorInstance> {
     const appToken = connector.config.appToken || ''
@@ -173,10 +179,9 @@ const slack: PlatformConnector = {
 
     // Handle messages
     app.message(async ({ message, say, client }) => {
-      // Only handle user messages (not bot messages or own messages)
-      if (!('text' in message) || ('bot_id' in message)) return
+      // Bot-to-bot collaboration still flows through the normal connector policy gates.
+      if (!shouldAcceptSlackMessageEvent(message, botUserId)) return
       const msg = message as any
-      if (botUserId && msg.user === botUserId) return
 
       const channelId = msg.channel
       if (allowedChannels && !allowedChannels.includes(channelId)) return

package/src/lib/server/gateways/gateway-profile-service.ts

@@ -27,6 +27,29 @@ function normalizeNullableNumber(value: unknown): number | null {
   return typeof value === 'number' && Number.isFinite(value) ? value : null
 }
 
+function normalizeLifecycleState(value: unknown): NonNullable<GatewayProfile['lifecycleState']> {
+  return value === 'draining' || value === 'cordoned' ? value : 'active'
+}
+
+function normalizeControlAction(value: unknown): GatewayProfile['lastControlAction'] {
+  return value === 'activate' || value === 'drain' || value === 'cordon' || value === 'restart'
+    ? value
+    : null
+}
+
+function normalizeControlRequest(value: unknown): GatewayProfile['controlRequest'] {
+  if (!value || typeof value !== 'object') return null
+  const request = value as Record<string, unknown>
+  const requestedAt = normalizeNullableNumber(request.requestedAt)
+  if (request.action !== 'restart' || !requestedAt) return null
+  return {
+    action: 'restart',
+    requestedAt,
+    source: 'swarmclaw',
+    reason: normalizeText(request.reason),
+  }
+}
+
 function normalizeDeployment(value: unknown): OpenClawDeploymentConfig | null {
   if (!value || typeof value !== 'object') return null
   const deployment = value as Record<string, unknown>
@@ -106,6 +129,11 @@ export function createGatewayProfile(input: Record<string, unknown>): GatewayPro
     wsUrl: normalizeText(input.wsUrl),
     credentialId: normalizeText(input.credentialId),
     status: typeof input.status === 'string' && input.status.trim() ? input.status as GatewayProfile['status'] : 'unknown',
+    lifecycleState: normalizeLifecycleState(input.lifecycleState),
+    lastControlAction: normalizeControlAction(input.lastControlAction),
+    lastControlActionAt: normalizeNullableNumber(input.lastControlActionAt),
+    lastControlReason: normalizeText(input.lastControlReason),
+    controlRequest: normalizeControlRequest(input.controlRequest),
     notes: typeof input.notes === 'string' ? input.notes : null,
     tags: normalizeTags(input.tags),
     lastError: null,
@@ -149,6 +177,11 @@ export function updateGatewayProfile(id: string, input: Record<string, unknown>)
       : 'unknown'
     gateway.status = nextStatus
   }
+  if (input.lifecycleState !== undefined) gateway.lifecycleState = normalizeLifecycleState(input.lifecycleState)
+  if (input.lastControlAction !== undefined) gateway.lastControlAction = normalizeControlAction(input.lastControlAction)
+  if (input.lastControlActionAt !== undefined) gateway.lastControlActionAt = normalizeNullableNumber(input.lastControlActionAt)
+  if (input.lastControlReason !== undefined) gateway.lastControlReason = normalizeText(input.lastControlReason)
+  if (input.controlRequest !== undefined) gateway.controlRequest = normalizeControlRequest(input.controlRequest)
   if (input.notes !== undefined) gateway.notes = typeof input.notes === 'string' ? input.notes : null
   if (input.tags !== undefined) gateway.tags = normalizeTags(input.tags)
   if (input.lastError !== undefined) gateway.lastError = typeof input.lastError === 'string' ? input.lastError : null
@@ -167,6 +200,44 @@ export function updateGatewayProfile(id: string, input: Record<string, unknown>)
   return gateway
 }
 
+export function controlGatewayProfile(
+  id: string,
+  input: { action: NonNullable<GatewayProfile['lastControlAction']>; reason?: string | null },
+  now = Date.now(),
+): GatewayProfile | null {
+  const gateways = loadGatewayProfiles()
+  const gateway = gateways[id]
+  if (!gateway) return null
+
+  const action = normalizeControlAction(input.action)
+  if (!action) return null
+
+  gateway.lifecycleState = action === 'drain'
+    ? 'draining'
+    : action === 'cordon'
+      ? 'cordoned'
+      : action === 'activate'
+        ? 'active'
+        : normalizeLifecycleState(gateway.lifecycleState)
+  gateway.lastControlAction = action
+  gateway.lastControlActionAt = now
+  gateway.lastControlReason = normalizeText(input.reason)
+  gateway.controlRequest = action === 'restart'
+    ? {
+        action: 'restart',
+        requestedAt: now,
+        source: 'swarmclaw',
+        reason: normalizeText(input.reason),
+      }
+    : null
+  gateway.updatedAt = now
+
+  gateways[id] = gateway
+  saveGatewayProfiles(gateways)
+  notify('gateways')
+  return gateway
+}
+
 export function deleteGatewayProfileAndDetachAgents(id: string): boolean {
   const gateways = loadGatewayProfiles()
   const deleted = gateways[id]

package/src/lib/server/operations/operation-pulse.test.ts

@@ -88,6 +88,11 @@ function gateway(overrides: Partial<GatewayProfile>): GatewayProfile {
     wsUrl: overrides.wsUrl ?? null,
     credentialId: overrides.credentialId ?? null,
     status: overrides.status || 'healthy',
+    lifecycleState: overrides.lifecycleState || 'active',
+    lastControlAction: overrides.lastControlAction ?? null,
+    lastControlActionAt: overrides.lastControlActionAt ?? null,
+    lastControlReason: overrides.lastControlReason ?? null,
+    controlRequest: overrides.controlRequest ?? null,
     notes: overrides.notes ?? null,
     tags: overrides.tags || [],
     lastError: overrides.lastError ?? null,
@@ -190,4 +195,33 @@ describe('operation pulse', () => {
     assert.ok((pulse.actions[0]?.summary || '').includes('no available OpenClaw execution environments'))
     assert.equal(pulse.actions[0]?.evidence.includes('0/2 environments'), true)
   })
+
+  it('surfaces gateways that are unavailable for automatic new work', () => {
+    const pulse = buildOperationPulse({
+      range: '24h',
+      now,
+      missions: [],
+      runs: [],
+      approvals: [],
+      connectors: [],
+      gateways: [
+        gateway({
+          lifecycleState: 'cordoned',
+          stats: {
+            nodeCount: 1,
+            connectedNodeCount: 1,
+            environmentCount: 1,
+            availableEnvironmentCount: 1,
+            lastTopologyCheckedAt: now - 1000,
+          },
+        }),
+      ],
+    })
+
+    assert.equal(pulse.kpis.gatewayAttention, 1)
+    assert.equal(pulse.actions[0]?.kind, 'gateway')
+    assert.equal(pulse.actions[0]?.severity, 'medium')
+    assert.ok((pulse.actions[0]?.summary || '').includes('cordoned from automatic new work'))
+    assert.equal(pulse.actions[0]?.evidence.includes('lifecycle:cordoned'), true)
+  })
 })

package/src/lib/server/operations/operation-pulse.ts

@@ -84,8 +84,10 @@ function gatewayAttentionReason(gateway: GatewayProfile, now: number): {
   const errorCount = gateway.stats?.lastTopologyErrorCount || 0
   const checkedAt = gateway.stats?.lastTopologyCheckedAt || gateway.lastCheckedAt || null
   const staleTopology = !checkedAt || now - checkedAt > GATEWAY_TOPOLOGY_STALE_MS
+  const lifecycleState = gateway.lifecycleState || 'active'
   const evidence = [
     `status:${gateway.status}`,
+    `lifecycle:${lifecycleState}`,
     `${gateway.stats?.connectedNodeCount || 0}/${gateway.stats?.nodeCount || 0} nodes`,
     `${gateway.stats?.availableEnvironmentCount || 0}/${gateway.stats?.environmentCount || 0} environments`,
   ]
@@ -106,6 +108,22 @@ function gatewayAttentionReason(gateway: GatewayProfile, now: number): {
     }
   }
 
+  if (lifecycleState === 'cordoned') {
+    return {
+      severity: 'medium',
+      summary: `${gateway.name} is cordoned from automatic new work.`,
+      evidence,
+    }
+  }
+
+  if (lifecycleState === 'draining') {
+    return {
+      severity: 'medium',
+      summary: `${gateway.name} is draining and will not receive automatic new work.`,
+      evidence,
+    }
+  }
+
   if (errorCount > 0) {
     return {
       severity: 'medium',

package/src/lib/validation/schemas.ts

@@ -364,6 +364,11 @@ export const ExternalAgentUpdateSchema = z.object({
   }).nullable().optional(),
 })
 
+export const GatewayControlSchema = z.object({
+  action: z.enum(['activate', 'drain', 'cordon', 'restart']),
+  reason: z.string().max(500).nullable().optional(),
+}).strict()
+
 export const ChatroomCreateSchema = z.object({
   name: z.string().min(1, 'Chatroom name is required'),
   agentIds: z.array(z.string()).min(1, 'Select at least one agent').default([]),

package/src/types/misc.ts

@@ -644,6 +644,8 @@ export interface McpServerConfig {
 
 export type GatewayProvider = 'openclaw'
 export type GatewayHealthState = 'unknown' | 'healthy' | 'degraded' | 'offline' | 'pending'
+export type GatewayLifecycleState = 'active' | 'draining' | 'cordoned'
+export type GatewayControlAction = 'activate' | 'drain' | 'cordon' | 'restart'
 export type OpenClawDeploymentMethod = 'local' | 'bundle' | 'ssh' | 'imported'
 export type OpenClawDeploymentProvider =
   | 'local'
@@ -714,6 +716,16 @@ export interface GatewayProfile {
   wsUrl?: string | null
   credentialId?: string | null
   status: GatewayHealthState
+  lifecycleState?: GatewayLifecycleState
+  lastControlAction?: GatewayControlAction | null
+  lastControlActionAt?: number | null
+  lastControlReason?: string | null
+  controlRequest?: {
+    action: 'restart'
+    requestedAt: number
+    source: 'swarmclaw'
+    reason?: string | null
+  } | null
   notes?: string | null
   tags?: string[]
   lastError?: string | null