/** * setup — Agent-driven DevClaw setup. * * Creates agent, configures model tiers, writes workspace files. * Thin wrapper around lib/setup.ts. */ import type { OpenClawPluginApi } from "openclaw/plugin-sdk"; import { jsonResult } from "openclaw/plugin-sdk"; import type { ToolContext } from "../types.js"; import { runSetup } from "../setup.js"; import { ALL_TIERS, DEFAULT_MODELS, type Tier } from "../tiers.js"; export function createSetupTool(api: OpenClawPluginApi) { return (ctx: ToolContext) => ({ name: "setup", label: "Setup", description: `Execute DevClaw setup. Creates AGENTS.md, HEARTBEAT.md, roles, memory/projects.json, and model tier config. Optionally creates a new agent with channel binding. Called after onboard collects configuration.`, parameters: { type: "object", properties: { newAgentName: { type: "string", description: "Create a new agent. Omit to configure current workspace." }, channelBinding: { type: "string", enum: ["telegram", "whatsapp"], description: "Channel to bind (optional, with newAgentName only)." }, migrateFrom: { type: "string", description: "Agent ID to migrate channel binding from. Check openclaw.json bindings first." }, models: { type: "object", description: "Model overrides per tier.", properties: { junior: { type: "string", description: `Default: ${DEFAULT_MODELS.junior}` }, medior: { type: "string", description: `Default: ${DEFAULT_MODELS.medior}` }, senior: { type: "string", description: `Default: ${DEFAULT_MODELS.senior}` }, qa: { type: "string", description: `Default: ${DEFAULT_MODELS.qa}` }, }, }, projectExecution: { type: "string", enum: ["parallel", "sequential"], description: "Project execution mode. Default: parallel." }, }, }, async execute(_id: string, params: Record) { const result = await runSetup({ newAgentName: params.newAgentName as string | undefined, channelBinding: (params.channelBinding as "telegram" | "whatsapp") ?? null, migrateFrom: params.migrateFrom as string | undefined, agentId: params.newAgentName ? undefined : ctx.agentId, workspacePath: params.newAgentName ? undefined : ctx.workspaceDir, models: params.models as Partial> | undefined, projectExecution: params.projectExecution as "parallel" | "sequential" | undefined, }); const lines = [ result.agentCreated ? `Agent "${result.agentId}" created` : `Configured "${result.agentId}"`, "", ]; if (result.bindingMigrated) { lines.push(`✅ Binding migrated: ${result.bindingMigrated.channel} (${result.bindingMigrated.from} → ${result.agentId})`, ""); } lines.push("Models:", ...ALL_TIERS.map((t) => ` ${t}: ${result.models[t]}`), "", "Files:", ...result.filesWritten.map((f) => ` ${f}`)); if (result.warnings.length > 0) lines.push("", "Warnings:", ...result.warnings.map((w) => ` ${w}`)); lines.push("", "Next: register a project, then create issues and pick them up."); return jsonResult({ success: true, ...result, summary: lines.join("\n") }); }, }); }