clawchef 0.1.0 → 0.1.2

package/dist/scaffold.d.ts

@@ -0,0 +1,8 @@
+export interface ScaffoldOptions {
+    projectName?: string;
+}
+export interface ScaffoldResult {
+    targetDir: string;
+    projectName: string;
+}
+export declare function scaffoldProject(targetDirArg?: string, options?: ScaffoldOptions): Promise<ScaffoldResult>;

package/dist/scaffold.js

@@ -0,0 +1,172 @@
+import path from "node:path";
+import { access, mkdir, readdir, writeFile } from "node:fs/promises";
+import { constants } from "node:fs";
+import { ClawChefError } from "./errors.js";
+function normalizeProjectName(value) {
+    const normalized = value
+        .trim()
+        .toLowerCase()
+        .replace(/[\s_]+/g, "-")
+        .replace(/[^a-z0-9-]/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+    if (!normalized) {
+        throw new ClawChefError("Project name is empty after normalization. Use letters, numbers, spaces, underscore, or dash.");
+    }
+    return normalized;
+}
+async function pathExists(filePath) {
+    try {
+        await access(filePath, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function ensureDirectoryEmpty(targetDir) {
+    const exists = await pathExists(targetDir);
+    if (!exists) {
+        await mkdir(targetDir, { recursive: true });
+        return;
+    }
+    const entries = await readdir(targetDir);
+    if (entries.length > 0) {
+        throw new ClawChefError(`Target directory is not empty: ${targetDir}`);
+    }
+}
+function makePackageJson(projectName) {
+    const content = {
+        name: `${projectName}-recipe`,
+        version: "0.1.0",
+        private: true,
+        type: "module",
+        scripts: {
+            "test:recipe": "node --test test/recipe-smoke.test.mjs",
+            test: "node --test \"test/**/*.test.mjs\"",
+        },
+        devDependencies: {
+            "telegram-api-mock-server": "^0.1.5",
+        },
+    };
+    return `${JSON.stringify(content, null, 2)}\n`;
+}
+function makeRecipeYaml(projectName) {
+    return `version: "1"
+name: "${projectName}"
+
+params:
+  openclaw_version:
+    default: "2026.2.9"
+  workspace_name:
+    default: "${projectName}"
+  agent_name:
+    default: "${projectName}"
+  agent_model:
+    default: "openai/gpt-4.1"
+  telegram_mock_api_key:
+    required: true
+
+openclaw:
+  bin: "openclaw"
+  version: "\${openclaw_version}"
+  install: "never"
+  plugins:
+    - "openclaw-telegram-mock-channel"
+
+workspaces:
+  - name: "\${workspace_name}"
+    assets: "./${projectName}-assets"
+
+agents:
+  - workspace: "\${workspace_name}"
+    name: "\${agent_name}"
+    model: "\${agent_model}"
+
+channels:
+  - channel: "telegram-mock"
+    account: "default"
+    token: "\${telegram_mock_api_key}"
+    extra_flags:
+      mock_bind: "127.0.0.1:18790"
+      mock_api_key: "\${telegram_mock_api_key}"
+      mode: "webhook"
+`;
+}
+function makeAgentsDoc(projectName) {
+    return `# ${projectName}
+
+Project scaffold generated by clawchef.
+`;
+}
+function makeIdentityDoc(projectName) {
+    return `# Identity
+
+You are the ${projectName} assistant.
+`;
+}
+function makeSoulDoc() {
+    return `# Soul
+
+Keep responses practical, concise, and action-oriented.
+`;
+}
+function makeToolsDoc() {
+    return `# Tools
+
+- Use available workspace files first.
+- Ask for missing secrets explicitly.
+`;
+}
+function makeSchedulingScript() {
+    return `#!/usr/bin/env node
+import process from "node:process";
+
+const message = process.argv.slice(2).join(" ").trim();
+if (!message) {
+  console.error("Usage: node scripts/scheduling.mjs <message>");
+  process.exit(1);
+}
+
+console.log("[scheduling] " + message);
+`;
+}
+function makeRecipeSmokeTest() {
+    return `import test from "node:test";
+import assert from "node:assert/strict";
+import { access } from "node:fs/promises";
+
+test("recipe scaffold files exist", async () => {
+  await access("src/recipe.yaml");
+  await access("package.json");
+  assert.ok(true);
+});
+`;
+}
+export async function scaffoldProject(targetDirArg, options = {}) {
+    const targetDir = path.resolve(targetDirArg?.trim() ? targetDirArg : process.cwd());
+    await ensureDirectoryEmpty(targetDir);
+    const defaultName = path.basename(targetDir);
+    const rawProjectName = options.projectName?.trim() || defaultName;
+    const projectName = normalizeProjectName(rawProjectName);
+    const srcDir = path.join(targetDir, "src");
+    const assetsDir = path.join(srcDir, `${projectName}-assets`);
+    const assetsScriptsDir = path.join(assetsDir, "scripts");
+    const testDir = path.join(targetDir, "test");
+    await mkdir(srcDir, { recursive: true });
+    await mkdir(assetsDir, { recursive: true });
+    await mkdir(assetsScriptsDir, { recursive: true });
+    await mkdir(testDir, { recursive: true });
+    await writeFile(path.join(targetDir, "package.json"), makePackageJson(projectName), "utf8");
+    await writeFile(path.join(srcDir, "recipe.yaml"), makeRecipeYaml(projectName), "utf8");
+    await writeFile(path.join(assetsDir, "AGENTS.md"), makeAgentsDoc(projectName), "utf8");
+    await writeFile(path.join(assetsDir, "IDENTITY.md"), makeIdentityDoc(projectName), "utf8");
+    await writeFile(path.join(assetsDir, "SOUL.md"), makeSoulDoc(), "utf8");
+    await writeFile(path.join(assetsDir, "TOOLS.md"), makeToolsDoc(), "utf8");
+    await writeFile(path.join(assetsScriptsDir, "scheduling.mjs"), makeSchedulingScript(), "utf8");
+    await writeFile(path.join(testDir, "recipe-smoke.test.mjs"), makeRecipeSmokeTest(), "utf8");
+    return {
+        targetDir,
+        projectName,
+    };
+}

package/dist/schema.d.ts

@@ -19,6 +19,7 @@ export declare const recipeSchema: z.ZodObject<{
         bin: z.ZodOptional<z.ZodString>;
         version: z.ZodString;
         install: z.ZodOptional<z.ZodEnum<["auto", "always", "never"]>>;
+        plugins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         bootstrap: z.ZodOptional<z.ZodObject<{
             non_interactive: z.ZodOptional<z.ZodBoolean>;
             accept_risk: z.ZodOptional<z.ZodBoolean>;
@@ -102,6 +103,7 @@ export declare const recipeSchema: z.ZodObject<{
             use_version: z.ZodOptional<z.ZodString>;
             install_version: z.ZodOptional<z.ZodString>;
             uninstall_version: z.ZodOptional<z.ZodString>;
+            install_plugin: z.ZodOptional<z.ZodString>;
             factory_reset: z.ZodOptional<z.ZodString>;
             start_gateway: z.ZodOptional<z.ZodString>;
             enable_plugin: z.ZodOptional<z.ZodString>;
@@ -115,6 +117,7 @@ export declare const recipeSchema: z.ZodObject<{
             use_version?: string | undefined;
             install_version?: string | undefined;
             uninstall_version?: string | undefined;
+            install_plugin?: string | undefined;
             factory_reset?: string | undefined;
             start_gateway?: string | undefined;
             enable_plugin?: string | undefined;
@@ -128,6 +131,7 @@ export declare const recipeSchema: z.ZodObject<{
             use_version?: string | undefined;
             install_version?: string | undefined;
             uninstall_version?: string | undefined;
+            install_plugin?: string | undefined;
             factory_reset?: string | undefined;
             start_gateway?: string | undefined;
             enable_plugin?: string | undefined;
@@ -142,6 +146,7 @@ export declare const recipeSchema: z.ZodObject<{
         version: string;
         bin?: string | undefined;
         install?: "auto" | "always" | "never" | undefined;
+        plugins?: string[] | undefined;
         bootstrap?: {
             openai_api_key?: string | undefined;
             anthropic_api_key?: string | undefined;
@@ -173,6 +178,7 @@ export declare const recipeSchema: z.ZodObject<{
             use_version?: string | undefined;
             install_version?: string | undefined;
             uninstall_version?: string | undefined;
+            install_plugin?: string | undefined;
             factory_reset?: string | undefined;
             start_gateway?: string | undefined;
             enable_plugin?: string | undefined;
@@ -187,6 +193,7 @@ export declare const recipeSchema: z.ZodObject<{
         version: string;
         bin?: string | undefined;
         install?: "auto" | "always" | "never" | undefined;
+        plugins?: string[] | undefined;
         bootstrap?: {
             openai_api_key?: string | undefined;
             anthropic_api_key?: string | undefined;
@@ -218,6 +225,7 @@ export declare const recipeSchema: z.ZodObject<{
             use_version?: string | undefined;
             install_version?: string | undefined;
             uninstall_version?: string | undefined;
+            install_plugin?: string | undefined;
             factory_reset?: string | undefined;
             start_gateway?: string | undefined;
             enable_plugin?: string | undefined;
@@ -232,12 +240,15 @@ export declare const recipeSchema: z.ZodObject<{
     workspaces: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         path: z.ZodOptional<z.ZodString>;
+        assets: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
         name: string;
         path?: string | undefined;
+        assets?: string | undefined;
     }, {
         name: string;
         path?: string | undefined;
+        assets?: string | undefined;
     }>, "many">>;
     channels: z.ZodOptional<z.ZodArray<z.ZodObject<{
         channel: z.ZodString;
@@ -417,6 +428,7 @@ export declare const recipeSchema: z.ZodObject<{
         version: string;
         bin?: string | undefined;
         install?: "auto" | "always" | "never" | undefined;
+        plugins?: string[] | undefined;
         bootstrap?: {
             openai_api_key?: string | undefined;
             anthropic_api_key?: string | undefined;
@@ -448,6 +460,7 @@ export declare const recipeSchema: z.ZodObject<{
             use_version?: string | undefined;
             install_version?: string | undefined;
             uninstall_version?: string | undefined;
+            install_plugin?: string | undefined;
             factory_reset?: string | undefined;
             start_gateway?: string | undefined;
             enable_plugin?: string | undefined;
@@ -469,6 +482,7 @@ export declare const recipeSchema: z.ZodObject<{
     workspaces?: {
         name: string;
         path?: string | undefined;
+        assets?: string | undefined;
     }[] | undefined;
     channels?: {
         channel: string;
@@ -522,6 +536,7 @@ export declare const recipeSchema: z.ZodObject<{
         version: string;
         bin?: string | undefined;
         install?: "auto" | "always" | "never" | undefined;
+        plugins?: string[] | undefined;
         bootstrap?: {
             openai_api_key?: string | undefined;
             anthropic_api_key?: string | undefined;
@@ -553,6 +568,7 @@ export declare const recipeSchema: z.ZodObject<{
             use_version?: string | undefined;
             install_version?: string | undefined;
             uninstall_version?: string | undefined;
+            install_plugin?: string | undefined;
             factory_reset?: string | undefined;
             start_gateway?: string | undefined;
             enable_plugin?: string | undefined;
@@ -574,6 +590,7 @@ export declare const recipeSchema: z.ZodObject<{
     workspaces?: {
         name: string;
         path?: string | undefined;
+        assets?: string | undefined;
     }[] | undefined;
     channels?: {
         channel: string;

package/dist/schema.js

@@ -9,6 +9,7 @@ const openClawCommandsSchema = z
     use_version: z.string().optional(),
     install_version: z.string().optional(),
     uninstall_version: z.string().optional(),
+    install_plugin: z.string().optional(),
     factory_reset: z.string().optional(),
     start_gateway: z.string().optional(),
     enable_plugin: z.string().optional(),
@@ -54,6 +55,7 @@ const openClawSchema = z
     bin: z.string().optional(),
     version: z.string(),
     install: z.enum(["auto", "always", "never"]).optional(),
+    plugins: z.array(z.string().min(1)).optional(),
     bootstrap: openClawBootstrapSchema.optional(),
     commands: openClawCommandsSchema.optional(),
 })
@@ -62,6 +64,7 @@ const workspaceSchema = z
     .object({
     name: z.string().min(1),
     path: z.string().min(1).optional(),
+    assets: z.string().min(1).optional(),
 })
     .strict();
 const channelSchema = z

package/dist/types.d.ts

@@ -17,6 +17,7 @@ export interface OpenClawCommandOverrides {
     use_version?: string;
     install_version?: string;
     uninstall_version?: string;
+    install_plugin?: string;
     factory_reset?: string;
     start_gateway?: string;
     enable_plugin?: string;
@@ -58,12 +59,14 @@ export interface OpenClawSection {
     bin?: string;
     version: string;
     install?: InstallPolicy;
+    plugins?: string[];
     bootstrap?: OpenClawBootstrap;
     commands?: OpenClawCommandOverrides;
 }
 export interface WorkspaceDef {
     name: string;
     path?: string;
+    assets?: string;
 }
 export interface ChannelDef {
     channel: string;
@@ -127,6 +130,7 @@ export interface Recipe {
 }
 export interface RunOptions {
     vars: Record<string, string>;
+    plugins: string[];
     dryRun: boolean;
     allowMissing: boolean;
     verbose: boolean;

package/package.json

@@ -1,7 +1,15 @@
 {
   "name": "clawchef",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Recipe-driven OpenClaw environment orchestrator",
+  "homepage": "https://renorzr.github.io/clawchef",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/renorzr/clawchef.git"
+  },
+  "bugs": {
+    "url": "https://github.com/renorzr/clawchef/issues"
+  },
   "type": "module",
   "main": "dist/api.js",
   "types": "dist/api.d.ts",

package/recipes/openclaw-local.yaml

@@ -52,7 +52,6 @@ channels:
   - channel: "telegram"
     token: "${telegram_bot_token}"
     account: "default"
-    login: true
 
 conversations:
   - workspace: "${project_name}"

package/recipes/openclaw-telegram-mock.yaml

@@ -11,6 +11,8 @@ openclaw:
   bin: "openclaw"
   version: "${openclaw_version}"
   install: "never"
+  plugins:
+    - "openclaw-telegram-mock-channel"
 
 channels:
   - channel: "telegram-mock"

package/recipes/openclaw-telegram.yaml

@@ -16,4 +16,3 @@ channels:
   - channel: "telegram"
     token: "${telegram_bot_token}"
     account: "default"
-    login: true

package/src/api.ts

@@ -4,11 +4,14 @@ import { importDotEnvFromCwd } from "./env.js";
 import { Logger } from "./logger.js";
 import { runRecipe } from "./orchestrator.js";
 import { loadRecipe, loadRecipeText } from "./recipe.js";
+import { scaffoldProject } from "./scaffold.js";
 import { recipeSchema } from "./schema.js";
 import type { OpenClawProvider, OpenClawRemoteConfig, RunOptions } from "./types.js";
+import type { ScaffoldOptions, ScaffoldResult } from "./scaffold.js";
 
 export interface CookOptions {
   vars?: Record<string, string>;
+  plugins?: string[];
   dryRun?: boolean;
   allowMissing?: boolean;
   verbose?: boolean;
@@ -19,8 +22,10 @@ export interface CookOptions {
 }
 
 function normalizeCookOptions(options: CookOptions): RunOptions {
+  const plugins = Array.from(new Set((options.plugins ?? []).map((value) => value.trim()).filter((value) => value.length > 0)));
   return {
     vars: options.vars ?? {},
+    plugins,
     dryRun: Boolean(options.dryRun),
     allowMissing: Boolean(options.allowMissing),
     verbose: Boolean(options.verbose),
@@ -62,4 +67,9 @@ export async function validate(recipeRef: string): Promise<void> {
   }
 }
 
+export async function scaffold(targetDir?: string, options: ScaffoldOptions = {}): Promise<ScaffoldResult> {
+  return scaffoldProject(targetDir, options);
+}
+
 export type { OpenClawProvider, OpenClawRemoteConfig };
+export type { ScaffoldOptions, ScaffoldResult };

package/src/cli.ts

@@ -4,8 +4,12 @@ import { Logger } from "./logger.js";
 import { runRecipe } from "./orchestrator.js";
 import { loadRecipe, loadRecipeText } from "./recipe.js";
 import { recipeSchema } from "./schema.js";
+import { scaffoldProject } from "./scaffold.js";
 import type { RunOptions } from "./types.js";
 import YAML from "js-yaml";
+import path from "node:path";
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
 
 function parseVarFlags(values: string[]): Record<string, string> {
   const out: Record<string, string> = {};
@@ -21,6 +25,10 @@ function parseVarFlags(values: string[]): Record<string, string> {
   return out;
 }
 
+function parsePluginFlags(values: string[]): string[] {
+  return Array.from(new Set(values.map((value) => value.trim()).filter((value) => value.length > 0)));
+}
+
 function readEnv(name: string): string | undefined {
   const value = process.env[name];
   if (value === undefined) {
@@ -48,6 +56,21 @@ function parseOptionalInt(value: string | undefined, fieldName: string): number
   return parsed;
 }
 
+async function promptProjectName(defaultValue: string): Promise<string> {
+  if (!input.isTTY) {
+    return defaultValue;
+  }
+
+  const rl = createInterface({ input, output });
+  try {
+    const answer = await rl.question(`Project name [${defaultValue}]: `);
+    const value = answer.trim();
+    return value || defaultValue;
+  } finally {
+    rl.close();
+  }
+}
+
 export function buildCli(): Command {
   const program = new Command();
 
@@ -65,6 +88,7 @@ export function buildCli(): Command {
     .option("--verbose", "Verbose logging", false)
     .option("-s, --silent", "Skip reset confirmation prompt", false)
     .option("--provider <provider>", "Execution provider: command | remote | mock")
+    .option("--plugin <npm-spec>", "Preinstall plugin package (repeatable)", (v, p: string[]) => p.concat([v]), [])
     .option("--remote-base-url <url>", "Remote OpenClaw API base URL")
     .option("--remote-api-key <key>", "Remote OpenClaw API key")
     .option("--remote-api-header <header>", "Remote auth header name")
@@ -75,6 +99,7 @@ export function buildCli(): Command {
       const provider = parseProvider(opts.provider ?? readEnv("CLAWCHEF_PROVIDER") ?? "command");
       const options: RunOptions = {
         vars: parseVarFlags(opts.var),
+        plugins: parsePluginFlags(opts.plugin),
         dryRun: Boolean(opts.dryRun),
         allowMissing: Boolean(opts.allowMissing),
         verbose: Boolean(opts.verbose),
@@ -100,6 +125,20 @@ export function buildCli(): Command {
       }
     });
 
+  program
+    .command("scaffold")
+    .argument("[dir]", "Target directory (default: current directory)")
+    .option("--name <project-name>", "Project name (default: directory name)")
+    .action(async (dir: string | undefined, opts) => {
+      const resolvedDir = path.resolve(dir?.trim() ? dir : process.cwd());
+      const defaultName = path.basename(resolvedDir);
+      const projectName = opts.name?.trim() ? opts.name.trim() : await promptProjectName(defaultName);
+      const result = await scaffoldProject(resolvedDir, { projectName });
+      process.stdout.write(`Scaffold created at ${result.targetDir}\n`);
+      process.stdout.write(`Project name: ${result.projectName}\n`);
+      process.stdout.write("Next: run npm install\n");
+    });
+
   program
     .command("validate")
     .argument("<recipe>", "Recipe path/URL/dir/archive[:file]")

package/src/openclaw/command-provider.ts

@@ -13,9 +13,10 @@ const DEFAULT_COMMANDS = {
   use_version: "${bin} --version",
   install_version: "npm install -g openclaw@${version}",
   uninstall_version: "npm uninstall -g openclaw",
+  install_plugin: "${bin} plugins install ${plugin_spec_q}",
   factory_reset: "${bin} reset --scope full --yes --non-interactive",
   start_gateway: "${bin} gateway start",
-  enable_plugin: "${bin} plugins enable ${channel_q}",
+  enable_plugin: "",
   login_channel: "${bin} channels login --channel ${channel_q}${account_arg}",
   create_agent:
     "${bin} agents add ${agent} --workspace ${workspace_path} --model ${model} --non-interactive --json",
@@ -377,6 +378,25 @@ export class CommandOpenClawProvider implements OpenClawProvider {
     await runShell(resetCmd, dryRun);
   }
 
+  async installPlugin(config: OpenClawSection, pluginSpec: string, dryRun: boolean): Promise<void> {
+    const trimmed = pluginSpec.trim();
+    if (!trimmed) {
+      return;
+    }
+
+    const bin = config.bin ?? "openclaw";
+    const cmd = commandFor(config, "install_plugin", {
+      bin,
+      version: config.version,
+      plugin_spec: trimmed,
+      plugin_spec_q: shellQuote(trimmed),
+    });
+    if (!cmd.trim()) {
+      return;
+    }
+    await runShell(cmd, dryRun);
+  }
+
   async startGateway(config: OpenClawSection, dryRun: boolean): Promise<void> {
     const bin = config.bin ?? "openclaw";
     const startCmd = commandFor(config, "start_gateway", { bin, version: config.version });
@@ -405,14 +425,17 @@ export class CommandOpenClawProvider implements OpenClawProvider {
 
   async configureChannel(config: OpenClawSection, channel: ChannelDef, dryRun: boolean): Promise<void> {
     const bin = config.bin ?? "openclaw";
-    const enablePluginCmd = commandFor(config, "enable_plugin", {
-      bin,
-      version: config.version,
-      channel: channel.channel,
-      channel_q: shellQuote(channel.channel),
-    });
-    if (enablePluginCmd.trim()) {
-      await runShell(enablePluginCmd, dryRun);
+    const enablePluginTemplate = config.commands?.enable_plugin;
+    if (enablePluginTemplate?.trim()) {
+      const enablePluginCmd = fillTemplate(enablePluginTemplate, {
+        bin,
+        version: config.version,
+        channel: channel.channel,
+        channel_q: shellQuote(channel.channel),
+      });
+      if (enablePluginCmd.trim()) {
+        await runShell(enablePluginCmd, dryRun);
+      }
     }
 
     const flags: string[] = [

package/src/openclaw/mock-provider.ts

@@ -40,6 +40,10 @@ export class MockOpenClawProvider implements OpenClawProvider {
     return { installedThisRun };
   }
 
+  async installPlugin(_config: OpenClawSection, _pluginSpec: string, _dryRun: boolean): Promise<void> {
+    return;
+  }
+
   async factoryReset(_config: OpenClawSection, _dryRun: boolean): Promise<void> {
     this.state.workspaces.clear();
     this.state.channels.clear();

package/src/openclaw/provider.ts

@@ -8,6 +8,7 @@ export interface EnsureVersionResult {
 
 export interface OpenClawProvider {
   ensureVersion(config: OpenClawSection, dryRun: boolean, silent: boolean): Promise<EnsureVersionResult>;
+  installPlugin(config: OpenClawSection, pluginSpec: string, dryRun: boolean): Promise<void>;
   factoryReset(config: OpenClawSection, dryRun: boolean): Promise<void>;
   startGateway(config: OpenClawSection, dryRun: boolean): Promise<void>;
   createWorkspace(config: OpenClawSection, workspace: ResolvedWorkspaceDef, dryRun: boolean): Promise<void>;

package/src/openclaw/remote-provider.ts

@@ -156,6 +156,17 @@ export class RemoteOpenClawProvider implements OpenClawProvider {
     };
   }
 
+  async installPlugin(config: OpenClawSection, pluginSpec: string, dryRun: boolean): Promise<void> {
+    await this.perform(
+      config,
+      "install_plugin",
+      {
+        plugin_spec: pluginSpec,
+      },
+      dryRun,
+    );
+  }
+
   async factoryReset(config: OpenClawSection, dryRun: boolean): Promise<void> {
     await this.perform(config, "factory_reset", undefined, dryRun);
   }