clawchef 0.1.7 → 0.1.9

package/dist/orchestrator.js

@@ -55,6 +55,18 @@ function resolveWorkspacePath(recipeOrigin, name, configuredPath) {
     const workspaceName = trimmedName.startsWith("workspace-") ? trimmedName : `workspace-${trimmedName}`;
     return path.join(homedir(), ".openclaw", workspaceName);
 }
+function resolveOpenClawRootPath(recipeOrigin, configuredPath) {
+    if (configuredPath?.trim()) {
+        if (path.isAbsolute(configuredPath)) {
+            return configuredPath;
+        }
+        if (recipeOrigin.kind === "local") {
+            return path.resolve(recipeOrigin.recipeDir, configuredPath);
+        }
+        return path.resolve(configuredPath);
+    }
+    return path.join(homedir(), ".openclaw");
+}
 function isHttpUrl(value) {
     try {
         const url = new URL(value);
@@ -164,6 +176,72 @@ export async function runRecipe(recipe, recipeOrigin, options, logger) {
         await provider.installPlugin(recipe.openclaw, pluginSpec, options.dryRun);
         logger.info(`Plugin preinstalled: ${pluginSpec}`);
     }
+    const root = recipe.openclaw.root;
+    if (root && (root.assets?.trim() || (root.files?.length ?? 0) > 0)) {
+        if (remoteMode) {
+            throw new ClawChefError("openclaw.root assets/files are not supported with --provider remote");
+        }
+        const openclawRootPath = resolveOpenClawRootPath(recipeOrigin, root.path);
+        if (!options.dryRun) {
+            await mkdir(openclawRootPath, { recursive: true });
+        }
+        if (root.assets?.trim()) {
+            const resolvedAssets = resolveFileRef(recipeOrigin, root.assets);
+            if (resolvedAssets.kind !== "local") {
+                throw new ClawChefError(`openclaw.root.assets must resolve to a local directory: ${root.assets}. Direct URL recipes cannot use openclaw.root.assets.`);
+            }
+            let assetDirStat;
+            try {
+                assetDirStat = await stat(resolvedAssets.value);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                throw new ClawChefError(`openclaw.root.assets path is not accessible: ${resolvedAssets.value} (${message})`);
+            }
+            if (!assetDirStat.isDirectory()) {
+                throw new ClawChefError(`openclaw.root.assets must be a directory: ${resolvedAssets.value}`);
+            }
+            const assetFiles = await collectLocalAssetFiles(resolvedAssets.value);
+            for (const assetFile of assetFiles) {
+                const target = path.resolve(openclawRootPath, assetFile.relativePath);
+                if (!options.dryRun) {
+                    await mkdir(path.dirname(target), { recursive: true });
+                    await copyFile(assetFile.absolutePath, target);
+                }
+                logger.info(`OpenClaw root asset copied: ${assetFile.relativePath}`);
+            }
+        }
+        for (const file of root.files ?? []) {
+            const target = path.resolve(openclawRootPath, file.path);
+            const targetDir = path.dirname(target);
+            if (!options.dryRun) {
+                await mkdir(targetDir, { recursive: true });
+                const alreadyExists = await exists(target);
+                if (alreadyExists && file.overwrite === false) {
+                    logger.warn(`Skipping existing file: ${target}`);
+                }
+                else if (file.content !== undefined) {
+                    await writeFile(target, file.content, "utf8");
+                }
+                else if (file.content_from) {
+                    const rawContent = await readTextFromRef(recipeOrigin, file.content_from);
+                    const content = renderTemplateString(rawContent, options.vars, options.allowMissing);
+                    await writeFile(target, content, "utf8");
+                }
+                else if (file.source) {
+                    const resolved = resolveFileRef(recipeOrigin, file.source);
+                    if (resolved.kind === "local") {
+                        await copyFile(resolved.value, target);
+                    }
+                    else {
+                        const content = await readBinaryFromRef(recipeOrigin, file.source);
+                        await writeFile(target, content);
+                    }
+                }
+            }
+            logger.info(`OpenClaw root file materialized: ${file.path}`);
+        }
+    }
     for (const ws of recipe.workspaces ?? []) {
         const absPath = resolveWorkspacePath(recipeOrigin, ws.name, ws.path);
         workspacePaths.set(ws.name, absPath);
@@ -215,8 +293,15 @@ export async function runRecipe(recipe, recipeOrigin, options, logger) {
         logger.info(`Agent created: ${agent.workspace}/${agent.name}`);
     }
     for (const channel of recipe.channels ?? []) {
-        await provider.configureChannel(recipe.openclaw, channel, options.dryRun);
-        logger.info(`Channel configured: ${channel.channel}${channel.account ? `/${channel.account}` : ""}`);
+        const effectiveChannel = channel.agent?.trim() && !channel.account?.trim()
+            ? { ...channel, account: channel.agent.trim() }
+            : channel;
+        await provider.configureChannel(recipe.openclaw, effectiveChannel, options.dryRun);
+        logger.info(`Channel configured: ${effectiveChannel.channel}${effectiveChannel.account ? `/${effectiveChannel.account}` : ""}`);
+        if (effectiveChannel.agent?.trim()) {
+            await provider.bindChannelAgent(recipe.openclaw, effectiveChannel, effectiveChannel.agent, options.dryRun);
+            logger.info(`Channel bound to agent: ${effectiveChannel.channel}${effectiveChannel.account ? `/${effectiveChannel.account}` : ""} -> ${effectiveChannel.agent}`);
+        }
     }
     for (const workspace of recipe.workspaces ?? []) {
         const wsPath = workspacePaths.get(workspace.name);
@@ -316,17 +401,25 @@ export async function runRecipe(recipe, recipeOrigin, options, logger) {
         }
         logger.info(`Preset messages sent: ${conv.workspace}/${conv.agent}`);
     }
-    await provider.startGateway(recipe.openclaw, options.dryRun);
-    logger.info("Gateway started");
+    await provider.startGateway(recipe.openclaw, options.gatewayMode, options.dryRun);
+    if (options.gatewayMode === "none") {
+        logger.info("Gateway start skipped by gateway mode: none");
+    }
+    else {
+        logger.info(`Gateway started (${options.gatewayMode})`);
+    }
     for (const channel of recipe.channels ?? []) {
-        if (!channel.login) {
+        const effectiveChannel = channel.agent?.trim() && !channel.account?.trim()
+            ? { ...channel, account: channel.agent.trim() }
+            : channel;
+        if (!effectiveChannel.login) {
             continue;
         }
         if (!options.dryRun && !input.isTTY) {
-            throw new ClawChefError(`Channel login for ${channel.channel} requires an interactive terminal session`);
+            throw new ClawChefError(`Channel login for ${effectiveChannel.channel} requires an interactive terminal session`);
         }
-        await provider.loginChannel(recipe.openclaw, channel, options.dryRun);
-        logger.info(`Channel login completed: ${channel.channel}${channel.account ? `/${channel.account}` : ""}`);
+        await provider.loginChannel(recipe.openclaw, effectiveChannel, options.dryRun);
+        logger.info(`Channel login completed: ${effectiveChannel.channel}${effectiveChannel.account ? `/${effectiveChannel.account}` : ""}`);
     }
     logger.info("Recipe execution completed");
 }

package/dist/recipe.js

@@ -145,12 +145,26 @@ function filterRecipeByWorkspaceName(recipe, workspaceName) {
 }
 function semanticValidate(recipe) {
     const ws = new Set((recipe.workspaces ?? []).map((w) => w.name));
+    const agentNameCounts = new Map();
+    const root = recipe.openclaw.root;
+    if (root?.path !== undefined && !root.path.trim()) {
+        throw new ClawChefError("openclaw.root.path cannot be empty");
+    }
+    if (root?.assets !== undefined && !root.assets.trim()) {
+        throw new ClawChefError("openclaw.root.assets cannot be empty");
+    }
+    for (const file of root?.files ?? []) {
+        if (!file.path.trim()) {
+            throw new ClawChefError("openclaw.root.files[] has file with empty path");
+        }
+    }
     for (const workspace of recipe.workspaces ?? []) {
         if (workspace.assets !== undefined && !workspace.assets.trim()) {
             throw new ClawChefError(`Workspace ${workspace.name} has empty assets path`);
         }
     }
     for (const agent of recipe.agents ?? []) {
+        agentNameCounts.set(agent.name, (agentNameCounts.get(agent.name) ?? 0) + 1);
         if (!ws.has(agent.workspace)) {
             throw new ClawChefError(`Agent ${agent.name} references missing workspace: ${agent.workspace}`);
         }
@@ -179,6 +193,18 @@ function semanticValidate(recipe) {
             (channel.login || channel.login_mode !== undefined || channel.login_account !== undefined)) {
             throw new ClawChefError("channels[] entry for telegram does not support login/login_mode/login_account. Configure token (or use_env/token_file), then start gateway.");
         }
+        if (channel.agent?.trim()) {
+            if (channel.channel !== "telegram") {
+                throw new ClawChefError(`channels[] entry for ${channel.channel} does not support agent binding. Use channel: telegram with agent.`);
+            }
+            const matched = agentNameCounts.get(channel.agent) ?? 0;
+            if (matched === 0) {
+                throw new ClawChefError(`channels[] entry references missing agent by name: ${channel.agent}`);
+            }
+            if (matched > 1) {
+                throw new ClawChefError(`channels[] entry references duplicate agent name: ${channel.agent}. Agent names must be unique for channel binding.`);
+            }
+        }
         const hasAuth = Boolean(channel.use_env) ||
             Boolean(channel.token?.trim()) ||
             Boolean(channel.token_file?.trim()) ||

package/dist/schema.d.ts

@@ -20,6 +20,61 @@ export declare const recipeSchema: z.ZodObject<{
         version: z.ZodString;
         install: z.ZodOptional<z.ZodEnum<["auto", "always", "never"]>>;
         plugins: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        root: z.ZodOptional<z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+            assets: z.ZodOptional<z.ZodString>;
+            files: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+                path: z.ZodString;
+                content: z.ZodOptional<z.ZodString>;
+                content_from: z.ZodOptional<z.ZodString>;
+                source: z.ZodOptional<z.ZodString>;
+                overwrite: z.ZodOptional<z.ZodBoolean>;
+            }, "strict", z.ZodTypeAny, {
+                path: string;
+                content?: string | undefined;
+                overwrite?: boolean | undefined;
+                content_from?: string | undefined;
+                source?: string | undefined;
+            }, {
+                path: string;
+                content?: string | undefined;
+                overwrite?: boolean | undefined;
+                content_from?: string | undefined;
+                source?: string | undefined;
+            }>, {
+                path: string;
+                content?: string | undefined;
+                overwrite?: boolean | undefined;
+                content_from?: string | undefined;
+                source?: string | undefined;
+            }, {
+                path: string;
+                content?: string | undefined;
+                overwrite?: boolean | undefined;
+                content_from?: string | undefined;
+                source?: string | undefined;
+            }>, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            path?: string | undefined;
+            files?: {
+                path: string;
+                content?: string | undefined;
+                overwrite?: boolean | undefined;
+                content_from?: string | undefined;
+                source?: string | undefined;
+            }[] | undefined;
+            assets?: string | undefined;
+        }, {
+            path?: string | undefined;
+            files?: {
+                path: string;
+                content?: string | undefined;
+                overwrite?: boolean | undefined;
+                content_from?: string | undefined;
+                source?: string | undefined;
+            }[] | undefined;
+            assets?: string | undefined;
+        }>>;
         bootstrap: z.ZodOptional<z.ZodObject<{
             non_interactive: z.ZodOptional<z.ZodBoolean>;
             accept_risk: z.ZodOptional<z.ZodBoolean>;
@@ -48,9 +103,9 @@ export declare const recipeSchema: z.ZodObject<{
             token_provider?: string | undefined;
             token_profile_id?: string | undefined;
             llm_api_key?: string | undefined;
+            mode?: "remote" | "local" | undefined;
             non_interactive?: boolean | undefined;
             accept_risk?: boolean | undefined;
-            mode?: "remote" | "local" | undefined;
             flow?: "quickstart" | "advanced" | "manual" | undefined;
             auth_choice?: string | undefined;
             reset?: boolean | undefined;
@@ -68,9 +123,9 @@ export declare const recipeSchema: z.ZodObject<{
             token_provider?: string | undefined;
             token_profile_id?: string | undefined;
             llm_api_key?: string | undefined;
+            mode?: "remote" | "local" | undefined;
             non_interactive?: boolean | undefined;
             accept_risk?: boolean | undefined;
-            mode?: "remote" | "local" | undefined;
             flow?: "quickstart" | "advanced" | "manual" | undefined;
             auth_choice?: string | undefined;
             reset?: boolean | undefined;
@@ -88,7 +143,9 @@ export declare const recipeSchema: z.ZodObject<{
             install_plugin: z.ZodOptional<z.ZodString>;
             factory_reset: z.ZodOptional<z.ZodString>;
             start_gateway: z.ZodOptional<z.ZodString>;
+            run_gateway: z.ZodOptional<z.ZodString>;
             enable_plugin: z.ZodOptional<z.ZodString>;
+            bind_channel_agent: z.ZodOptional<z.ZodString>;
             login_channel: z.ZodOptional<z.ZodString>;
             create_workspace: z.ZodOptional<z.ZodString>;
             create_agent: z.ZodOptional<z.ZodString>;
@@ -102,7 +159,9 @@ export declare const recipeSchema: z.ZodObject<{
             install_plugin?: string | undefined;
             factory_reset?: string | undefined;
             start_gateway?: string | undefined;
+            run_gateway?: string | undefined;
             enable_plugin?: string | undefined;
+            bind_channel_agent?: string | undefined;
             login_channel?: string | undefined;
             create_agent?: string | undefined;
             install_skill?: string | undefined;
@@ -116,7 +175,9 @@ export declare const recipeSchema: z.ZodObject<{
             install_plugin?: string | undefined;
             factory_reset?: string | undefined;
             start_gateway?: string | undefined;
+            run_gateway?: string | undefined;
             enable_plugin?: string | undefined;
+            bind_channel_agent?: string | undefined;
             login_channel?: string | undefined;
             create_agent?: string | undefined;
             install_skill?: string | undefined;
@@ -129,6 +190,17 @@ export declare const recipeSchema: z.ZodObject<{
         bin?: string | undefined;
         install?: "auto" | "always" | "never" | undefined;
         plugins?: string[] | undefined;
+        root?: {
+            path?: string | undefined;
+            files?: {
+                path: string;
+                content?: string | undefined;
+                overwrite?: boolean | undefined;
+                content_from?: string | undefined;
+                source?: string | undefined;
+            }[] | undefined;
+            assets?: string | undefined;
+        } | undefined;
         bootstrap?: {
             workspace?: string | undefined;
             cloudflare_ai_gateway_account_id?: string | undefined;
@@ -137,9 +209,9 @@ export declare const recipeSchema: z.ZodObject<{
             token_provider?: string | undefined;
             token_profile_id?: string | undefined;
             llm_api_key?: string | undefined;
+            mode?: "remote" | "local" | undefined;
             non_interactive?: boolean | undefined;
             accept_risk?: boolean | undefined;
-            mode?: "remote" | "local" | undefined;
             flow?: "quickstart" | "advanced" | "manual" | undefined;
             auth_choice?: string | undefined;
             reset?: boolean | undefined;
@@ -157,7 +229,9 @@ export declare const recipeSchema: z.ZodObject<{
             install_plugin?: string | undefined;
             factory_reset?: string | undefined;
             start_gateway?: string | undefined;
+            run_gateway?: string | undefined;
             enable_plugin?: string | undefined;
+            bind_channel_agent?: string | undefined;
             login_channel?: string | undefined;
             create_agent?: string | undefined;
             install_skill?: string | undefined;
@@ -170,6 +244,17 @@ export declare const recipeSchema: z.ZodObject<{
         bin?: string | undefined;
         install?: "auto" | "always" | "never" | undefined;
         plugins?: string[] | undefined;
+        root?: {
+            path?: string | undefined;
+            files?: {
+                path: string;
+                content?: string | undefined;
+                overwrite?: boolean | undefined;
+                content_from?: string | undefined;
+                source?: string | undefined;
+            }[] | undefined;
+            assets?: string | undefined;
+        } | undefined;
         bootstrap?: {
             workspace?: string | undefined;
             cloudflare_ai_gateway_account_id?: string | undefined;
@@ -178,9 +263,9 @@ export declare const recipeSchema: z.ZodObject<{
             token_provider?: string | undefined;
             token_profile_id?: string | undefined;
             llm_api_key?: string | undefined;
+            mode?: "remote" | "local" | undefined;
             non_interactive?: boolean | undefined;
             accept_risk?: boolean | undefined;
-            mode?: "remote" | "local" | undefined;
             flow?: "quickstart" | "advanced" | "manual" | undefined;
             auth_choice?: string | undefined;
             reset?: boolean | undefined;
@@ -198,7 +283,9 @@ export declare const recipeSchema: z.ZodObject<{
             install_plugin?: string | undefined;
             factory_reset?: string | undefined;
             start_gateway?: string | undefined;
+            run_gateway?: string | undefined;
             enable_plugin?: string | undefined;
+            bind_channel_agent?: string | undefined;
             login_channel?: string | undefined;
             create_agent?: string | undefined;
             install_skill?: string | undefined;
@@ -268,6 +355,7 @@ export declare const recipeSchema: z.ZodObject<{
     channels: z.ZodOptional<z.ZodArray<z.ZodObject<{
         channel: z.ZodString;
         account: z.ZodOptional<z.ZodString>;
+        agent: z.ZodOptional<z.ZodString>;
         login: z.ZodOptional<z.ZodBoolean>;
         login_mode: z.ZodOptional<z.ZodEnum<["interactive"]>>;
         login_account: z.ZodOptional<z.ZodString>;
@@ -287,6 +375,7 @@ export declare const recipeSchema: z.ZodObject<{
         channel: string;
         token?: string | undefined;
         account?: string | undefined;
+        agent?: string | undefined;
         login?: boolean | undefined;
         login_mode?: "interactive" | undefined;
         login_account?: string | undefined;
@@ -305,6 +394,7 @@ export declare const recipeSchema: z.ZodObject<{
         channel: string;
         token?: string | undefined;
         account?: string | undefined;
+        agent?: string | undefined;
         login?: boolean | undefined;
         login_mode?: "interactive" | undefined;
         login_account?: string | undefined;
@@ -408,6 +498,17 @@ export declare const recipeSchema: z.ZodObject<{
         bin?: string | undefined;
         install?: "auto" | "always" | "never" | undefined;
         plugins?: string[] | undefined;
+        root?: {
+            path?: string | undefined;
+            files?: {
+                path: string;
+                content?: string | undefined;
+                overwrite?: boolean | undefined;
+                content_from?: string | undefined;
+                source?: string | undefined;
+            }[] | undefined;
+            assets?: string | undefined;
+        } | undefined;
         bootstrap?: {
             workspace?: string | undefined;
             cloudflare_ai_gateway_account_id?: string | undefined;
@@ -416,9 +517,9 @@ export declare const recipeSchema: z.ZodObject<{
             token_provider?: string | undefined;
             token_profile_id?: string | undefined;
             llm_api_key?: string | undefined;
+            mode?: "remote" | "local" | undefined;
             non_interactive?: boolean | undefined;
             accept_risk?: boolean | undefined;
-            mode?: "remote" | "local" | undefined;
             flow?: "quickstart" | "advanced" | "manual" | undefined;
             auth_choice?: string | undefined;
             reset?: boolean | undefined;
@@ -436,7 +537,9 @@ export declare const recipeSchema: z.ZodObject<{
             install_plugin?: string | undefined;
             factory_reset?: string | undefined;
             start_gateway?: string | undefined;
+            run_gateway?: string | undefined;
             enable_plugin?: string | undefined;
+            bind_channel_agent?: string | undefined;
             login_channel?: string | undefined;
             create_agent?: string | undefined;
             install_skill?: string | undefined;
@@ -468,6 +571,7 @@ export declare const recipeSchema: z.ZodObject<{
         channel: string;
         token?: string | undefined;
         account?: string | undefined;
+        agent?: string | undefined;
         login?: boolean | undefined;
         login_mode?: "interactive" | undefined;
         login_account?: string | undefined;
@@ -509,6 +613,17 @@ export declare const recipeSchema: z.ZodObject<{
         bin?: string | undefined;
         install?: "auto" | "always" | "never" | undefined;
         plugins?: string[] | undefined;
+        root?: {
+            path?: string | undefined;
+            files?: {
+                path: string;
+                content?: string | undefined;
+                overwrite?: boolean | undefined;
+                content_from?: string | undefined;
+                source?: string | undefined;
+            }[] | undefined;
+            assets?: string | undefined;
+        } | undefined;
         bootstrap?: {
             workspace?: string | undefined;
             cloudflare_ai_gateway_account_id?: string | undefined;
@@ -517,9 +632,9 @@ export declare const recipeSchema: z.ZodObject<{
             token_provider?: string | undefined;
             token_profile_id?: string | undefined;
             llm_api_key?: string | undefined;
+            mode?: "remote" | "local" | undefined;
             non_interactive?: boolean | undefined;
             accept_risk?: boolean | undefined;
-            mode?: "remote" | "local" | undefined;
             flow?: "quickstart" | "advanced" | "manual" | undefined;
             auth_choice?: string | undefined;
             reset?: boolean | undefined;
@@ -537,7 +652,9 @@ export declare const recipeSchema: z.ZodObject<{
             install_plugin?: string | undefined;
             factory_reset?: string | undefined;
             start_gateway?: string | undefined;
+            run_gateway?: string | undefined;
             enable_plugin?: string | undefined;
+            bind_channel_agent?: string | undefined;
             login_channel?: string | undefined;
             create_agent?: string | undefined;
             install_skill?: string | undefined;
@@ -569,6 +686,7 @@ export declare const recipeSchema: z.ZodObject<{
         channel: string;
         token?: string | undefined;
         account?: string | undefined;
+        agent?: string | undefined;
         login?: boolean | undefined;
         login_mode?: "interactive" | undefined;
         login_account?: string | undefined;

package/dist/schema.js

@@ -12,7 +12,9 @@ const openClawCommandsSchema = z
     install_plugin: z.string().optional(),
     factory_reset: z.string().optional(),
     start_gateway: z.string().optional(),
+    run_gateway: z.string().optional(),
     enable_plugin: z.string().optional(),
+    bind_channel_agent: z.string().optional(),
     login_channel: z.string().optional(),
     create_workspace: z.string().optional(),
     create_agent: z.string().optional(),
@@ -44,12 +46,32 @@ const openClawBootstrapSchema = z
     token_profile_id: z.string().optional(),
 })
     .strict();
+const rootFileSchema = z
+    .object({
+    path: z.string().min(1),
+    content: z.string().optional(),
+    content_from: z.string().min(1).optional(),
+    source: z.string().optional(),
+    overwrite: z.boolean().optional(),
+})
+    .strict()
+    .refine((v) => [v.content, v.content_from, v.source].filter((item) => item !== undefined).length === 1, {
+    message: "openclaw.root.files[] requires exactly one of content, content_from, or source",
+});
+const openClawRootSchema = z
+    .object({
+    path: z.string().min(1).optional(),
+    assets: z.string().min(1).optional(),
+    files: z.array(rootFileSchema).optional(),
+})
+    .strict();
 const openClawSchema = z
     .object({
     bin: z.string().optional(),
     version: z.string(),
     install: z.enum(["auto", "always", "never"]).optional(),
     plugins: z.array(z.string().min(1)).optional(),
+    root: openClawRootSchema.optional(),
     bootstrap: openClawBootstrapSchema.optional(),
     commands: openClawCommandsSchema.optional(),
 })
@@ -79,6 +101,7 @@ const channelSchema = z
     .object({
     channel: z.string().min(1),
     account: z.string().min(1).optional(),
+    agent: z.string().min(1).optional(),
     login: z.boolean().optional(),
     login_mode: z.enum(["interactive"]).optional(),
     login_account: z.string().min(1).optional(),

package/dist/types.d.ts

@@ -1,6 +1,7 @@
 export type InstallPolicy = "auto" | "always" | "never";
 export type OpenClawProvider = "command" | "mock" | "remote";
 export type RunScope = "full" | "files" | "workspace";
+export type GatewayMode = "service" | "run" | "none";
 export interface OpenClawRemoteConfig {
     base_url: string;
     api_key?: string;
@@ -21,7 +22,9 @@ export interface OpenClawCommandOverrides {
     install_plugin?: string;
     factory_reset?: string;
     start_gateway?: string;
+    run_gateway?: string;
     enable_plugin?: string;
+    bind_channel_agent?: string;
     login_channel?: string;
     create_workspace?: string;
     create_agent?: string;
@@ -55,9 +58,15 @@ export interface OpenClawSection {
     version: string;
     install?: InstallPolicy;
     plugins?: string[];
+    root?: OpenClawRootDef;
     bootstrap?: OpenClawBootstrap;
     commands?: OpenClawCommandOverrides;
 }
+export interface OpenClawRootDef {
+    path?: string;
+    assets?: string;
+    files?: WorkspaceFileDef[];
+}
 export interface WorkspaceDef {
     name: string;
     path?: string;
@@ -67,6 +76,7 @@ export interface WorkspaceDef {
 export interface ChannelDef {
     channel: string;
     account?: string;
+    agent?: string;
     login?: boolean;
     login_mode?: "interactive";
     login_account?: string;
@@ -127,6 +137,7 @@ export interface RunOptions {
     plugins: string[];
     scope: RunScope;
     workspaceName?: string;
+    gatewayMode: GatewayMode;
     dryRun: boolean;
     allowMissing: boolean;
     verbose: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawchef",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Recipe-driven OpenClaw environment orchestrator",
   "homepage": "https://renorzr.github.io/clawchef",
   "repository": {

package/recipes/sample.yaml

@@ -12,6 +12,13 @@ params:
 openclaw:
   version: "${openclaw_version}"
   install: "auto"
+  root:
+    files:
+      - path: "AGENTS.md"
+        overwrite: true
+        content: |
+          # OpenClaw Root
+          Project: ${project_name}
 
 workspaces:
   - name: "${project_name}"

package/src/api.ts

@@ -6,7 +6,7 @@ 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, RunScope } from "./types.js";
+import type { GatewayMode, OpenClawProvider, OpenClawRemoteConfig, RunOptions, RunScope } from "./types.js";
 import type { ScaffoldOptions, ScaffoldResult } from "./scaffold.js";
 
 export interface CookOptions {
@@ -18,6 +18,7 @@ export interface CookOptions {
   silent?: boolean;
   scope?: RunScope;
   workspaceName?: string;
+  gatewayMode?: GatewayMode;
   provider?: OpenClawProvider;
   remote?: Partial<OpenClawRemoteConfig>;
   envFile?: string;
@@ -39,6 +40,7 @@ function normalizeCookOptions(options: CookOptions): RunOptions {
     plugins,
     scope,
     workspaceName,
+    gatewayMode: options.gatewayMode ?? "service",
     dryRun: Boolean(options.dryRun),
     allowMissing: Boolean(options.allowMissing),
     verbose: Boolean(options.verbose),