Files
devclaw-gitea/lib/tools/setup.ts
Lauren ten Hoor 70af40e986 Refactor setup and tool helpers for improved modularity and clarity
- Moved setup logic into dedicated files: agent.ts, config.ts, index.ts, workspace.ts.
- Introduced tool-helpers.ts for shared functions across tools, reducing boilerplate.
- Updated tools (status, task-comment, task-create, task-update, work-finish, work-start) to utilize new helper functions for workspace resolution and provider creation.
- Enhanced error handling and context detection in tools.
- Improved project resolution logic to streamline tool execution.
- Added new functionality for agent creation and configuration management in setup.
2026-02-10 22:51:35 +08:00

63 lines
3.2 KiB
TypeScript

/**
* setup — Agent-driven DevClaw setup.
*
* Creates agent, configures model tiers, writes workspace files.
* Thin wrapper around lib/setup/.
*/
import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
import { jsonResult } from "openclaw/plugin-sdk";
import type { ToolContext } from "../types.js";
import { runSetup } from "../setup/index.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<string, unknown>) {
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<Record<Tier, string>> | 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") });
},
});
}