clawchef 0.1.10 → 0.1.11

package/README.md

@@ -14,6 +14,7 @@ Recipe-driven OpenClaw environment orchestrator.
 - When installed OpenClaw version mismatches recipe version, prompts: ignore / abort / force reinstall (silent mode auto-picks force reinstall).
 - Supports scoped execution via `--scope full|files|workspace`.
 - `full` scope runs factory reset first (with confirmation prompt unless `-s/--silent` is used).
+- Factory reset includes removing local `~/.openclaw` directory.
 - If `openclaw` is missing, auto-installs the recipe version and skips factory reset.
 - Starts OpenClaw gateway after each recipe execution based on `--gateway-mode`.
 - Creates workspaces and agents (default workspace path: `~/.openclaw/workspace-<workspace-name>`).
@@ -392,6 +393,7 @@ channels:
     token: "${telegram_bot_token}"
     account: "default"
     agent: "main"
+    group_policy: "allowlist"
 
   - channel: "telegram"
     token: "${alerts_bot_token}"
@@ -412,11 +414,12 @@ channels:
 Supported common fields:
 
 - required: `channel`
-- optional: `account`, `agent`, `name`, `token`, `token_file`, `use_env`, `bot_token`, `access_token`, `app_token`, `webhook_url`, `webhook_path`, `signal_number`, `password`, `login`, `login_mode`, `login_account`
+- optional: `account`, `agent`, `group_policy`, `name`, `token`, `token_file`, `use_env`, `bot_token`, `access_token`, `app_token`, `webhook_url`, `webhook_path`, `signal_number`, `password`, `login`, `login_mode`, `login_account`
 - advanced passthrough: `extra_flags` (`snake_case` keys become `--kebab-case` CLI flags)
 
 `channels[].agent` currently supports `channel: "telegram"` only.
 If `agent` is set and `account` is omitted, clawchef defaults `account` to the same value as `agent`.
+`channels[].group_policy` currently supports `channel: "telegram"` only and is applied after `channels add` via `openclaw config set` so it is not overwritten by add-flow writes.
 
 ## Workspace path behavior
 

package/dist/openclaw/command-provider.js

@@ -1,4 +1,4 @@
-import { tmpdir } from "node:os";
+import { homedir, tmpdir } from "node:os";
 import path from "node:path";
 import process from "node:process";
 import { mkdtemp, rm, writeFile } from "node:fs/promises";
@@ -129,6 +129,13 @@ function parseVersionOutput(output) {
     const match = output.match(/\b(\d+\.\d+\.\d+)\b/);
     return match?.[1] ?? output.trim();
 }
+function telegramGroupPolicyPath(account) {
+    const trimmed = account?.trim();
+    if (!trimmed) {
+        return "channels.telegram.groupPolicy";
+    }
+    return `channels.telegram.accounts[${trimmed}].groupPolicy`;
+}
 async function chooseVersionMismatchAction(currentVersion, expectedVersion, silent) {
     if (silent) {
         return "force";
@@ -341,10 +348,13 @@ export class CommandOpenClawProvider {
     async factoryReset(config, dryRun) {
         const bin = config.bin ?? "openclaw";
         const resetCmd = commandFor(config, "factory_reset", { bin, version: config.version });
-        if (!resetCmd.trim()) {
-            return;
+        if (resetCmd.trim()) {
+            await runShell(resetCmd, dryRun);
+        }
+        const openclawHome = path.join(homedir(), ".openclaw");
+        if (!dryRun) {
+            await rm(openclawHome, { recursive: true, force: true });
         }
-        await runShell(resetCmd, dryRun);
     }
     async installPlugin(config, pluginSpec, dryRun) {
         const trimmed = pluginSpec.trim();
@@ -443,6 +453,12 @@ export class CommandOpenClawProvider {
         }
         const cmd = `${bin} channels add ${flags.join(" ")}`;
         await runShell(cmd, dryRun);
+        if (channel.channel === "telegram" && channel.group_policy) {
+            const configPath = telegramGroupPolicyPath(channel.account);
+            const policyValue = JSON.stringify(channel.group_policy);
+            const setPolicyCmd = `${bin} config set ${shellQuote(configPath)} ${shellQuote(policyValue)} --strict-json`;
+            await runShell(setPolicyCmd, dryRun);
+        }
     }
     async bindChannelAgent(config, channel, agent, dryRun) {
         const account = channel.account?.trim();

package/dist/recipe.js

@@ -193,6 +193,9 @@ 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.group_policy !== undefined && channel.channel !== "telegram") {
+            throw new ClawChefError(`channels[] entry for ${channel.channel} does not support group_policy. Use channel: telegram.`);
+        }
         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.`);

package/dist/schema.d.ts

@@ -356,6 +356,7 @@ export declare const recipeSchema: z.ZodObject<{
         channel: z.ZodString;
         account: z.ZodOptional<z.ZodString>;
         agent: z.ZodOptional<z.ZodString>;
+        group_policy: z.ZodOptional<z.ZodEnum<["open", "allowlist", "disabled"]>>;
         login: z.ZodOptional<z.ZodBoolean>;
         login_mode: z.ZodOptional<z.ZodEnum<["interactive"]>>;
         login_account: z.ZodOptional<z.ZodString>;
@@ -376,6 +377,7 @@ export declare const recipeSchema: z.ZodObject<{
         token?: string | undefined;
         account?: string | undefined;
         agent?: string | undefined;
+        group_policy?: "open" | "allowlist" | "disabled" | undefined;
         login?: boolean | undefined;
         login_mode?: "interactive" | undefined;
         login_account?: string | undefined;
@@ -395,6 +397,7 @@ export declare const recipeSchema: z.ZodObject<{
         token?: string | undefined;
         account?: string | undefined;
         agent?: string | undefined;
+        group_policy?: "open" | "allowlist" | "disabled" | undefined;
         login?: boolean | undefined;
         login_mode?: "interactive" | undefined;
         login_account?: string | undefined;
@@ -572,6 +575,7 @@ export declare const recipeSchema: z.ZodObject<{
         token?: string | undefined;
         account?: string | undefined;
         agent?: string | undefined;
+        group_policy?: "open" | "allowlist" | "disabled" | undefined;
         login?: boolean | undefined;
         login_mode?: "interactive" | undefined;
         login_account?: string | undefined;
@@ -687,6 +691,7 @@ export declare const recipeSchema: z.ZodObject<{
         token?: string | undefined;
         account?: string | undefined;
         agent?: string | undefined;
+        group_policy?: "open" | "allowlist" | "disabled" | undefined;
         login?: boolean | undefined;
         login_mode?: "interactive" | undefined;
         login_account?: string | undefined;

package/dist/schema.js

@@ -102,6 +102,7 @@ const channelSchema = z
     channel: z.string().min(1),
     account: z.string().min(1).optional(),
     agent: z.string().min(1).optional(),
+    group_policy: z.enum(["open", "allowlist", "disabled"]).optional(),
     login: z.boolean().optional(),
     login_mode: z.enum(["interactive"]).optional(),
     login_account: z.string().min(1).optional(),

package/dist/types.d.ts

@@ -77,6 +77,7 @@ export interface ChannelDef {
     channel: string;
     account?: string;
     agent?: string;
+    group_policy?: "open" | "allowlist" | "disabled";
     login?: boolean;
     login_mode?: "interactive";
     login_account?: string;

package/package.json

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

package/src/openclaw/command-provider.ts

@@ -1,4 +1,4 @@
-import { tmpdir } from "node:os";
+import { homedir, tmpdir } from "node:os";
 import path from "node:path";
 import process from "node:process";
 import { mkdtemp, rm, writeFile } from "node:fs/promises";
@@ -178,6 +178,14 @@ function parseVersionOutput(output: string): string {
   return match?.[1] ?? output.trim();
 }
 
+function telegramGroupPolicyPath(account: string | undefined): string {
+  const trimmed = account?.trim();
+  if (!trimmed) {
+    return "channels.telegram.groupPolicy";
+  }
+  return `channels.telegram.accounts[${trimmed}].groupPolicy`;
+}
+
 type VersionMismatchChoice = "ignore" | "abort" | "force";
 
 async function chooseVersionMismatchAction(
@@ -440,10 +448,14 @@ export class CommandOpenClawProvider implements OpenClawProvider {
   async factoryReset(config: OpenClawSection, dryRun: boolean): Promise<void> {
     const bin = config.bin ?? "openclaw";
     const resetCmd = commandFor(config, "factory_reset", { bin, version: config.version });
-    if (!resetCmd.trim()) {
-      return;
+    if (resetCmd.trim()) {
+      await runShell(resetCmd, dryRun);
+    }
+
+    const openclawHome = path.join(homedir(), ".openclaw");
+    if (!dryRun) {
+      await rm(openclawHome, { recursive: true, force: true });
     }
-    await runShell(resetCmd, dryRun);
   }
 
   async installPlugin(config: OpenClawSection, pluginSpec: string, dryRun: boolean): Promise<void> {
@@ -554,6 +566,13 @@ export class CommandOpenClawProvider implements OpenClawProvider {
 
     const cmd = `${bin} channels add ${flags.join(" ")}`;
     await runShell(cmd, dryRun);
+
+    if (channel.channel === "telegram" && channel.group_policy) {
+      const configPath = telegramGroupPolicyPath(channel.account);
+      const policyValue = JSON.stringify(channel.group_policy);
+      const setPolicyCmd = `${bin} config set ${shellQuote(configPath)} ${shellQuote(policyValue)} --strict-json`;
+      await runShell(setPolicyCmd, dryRun);
+    }
   }
 
   async bindChannelAgent(config: OpenClawSection, channel: ChannelDef, agent: string, dryRun: boolean): Promise<void> {

package/src/recipe.ts

@@ -252,6 +252,12 @@ function semanticValidate(recipe: Recipe): void {
       );
     }
 
+    if (channel.group_policy !== undefined && channel.channel !== "telegram") {
+      throw new ClawChefError(
+        `channels[] entry for ${channel.channel} does not support group_policy. Use channel: telegram.`,
+      );
+    }
+
     if (channel.agent?.trim()) {
       if (channel.channel !== "telegram") {
         throw new ClawChefError(

package/src/schema.ts

@@ -112,6 +112,7 @@ const channelSchema = z
     channel: z.string().min(1),
     account: z.string().min(1).optional(),
     agent: z.string().min(1).optional(),
+    group_policy: z.enum(["open", "allowlist", "disabled"]).optional(),
     login: z.boolean().optional(),
     login_mode: z.enum(["interactive"]).optional(),
     login_account: z.string().min(1).optional(),

package/src/types.ts

@@ -85,6 +85,7 @@ export interface ChannelDef {
   channel: string;
   account?: string;
   agent?: string;
+  group_policy?: "open" | "allowlist" | "disabled";
   login?: boolean;
   login_mode?: "interactive";
   login_account?: string;