clawchef 0.1.7 → 0.1.9

package/AGENTS.md

@@ -0,0 +1,159 @@
+# AGENTS Guide for `clawchef`
+
+This file is for coding agents operating in this repository.
+It documents the current build/test workflow and code conventions inferred from the codebase.
+
+## Scope and Source of Truth
+
+- Primary language: TypeScript (ESM, NodeNext).
+- Runtime target: Node.js `>=20`.
+- Package manager: npm (`package-lock.json` is present).
+- Compiler config: `tsconfig.json` with `strict: true` and `rootDir: src`, `outDir: dist`.
+- Public entry points: CLI (`src/index.ts`) and Node API (`src/api.ts`).
+
+## Repository Rules Discovery
+
+I checked for additional agent instruction files:
+
+- `.cursor/rules/`: not present
+- `.cursorrules`: not present
+- `.github/copilot-instructions.md`: not present
+
+So this `AGENTS.md` is the repo-local guidance file for agents.
+
+## Build, Lint, and Test Commands
+
+## Install
+
+- `npm install`
+
+## Build
+
+- `npm run build`
+  - Runs `tsc -p tsconfig.json`
+  - Emits JS + declarations into `dist/`
+
+## Type Check
+
+- `npm run typecheck`
+  - Runs `tsc --noEmit -p tsconfig.json`
+  - Use this as the closest thing to linting gate today
+
+## Lint
+
+- There is currently **no configured lint script** (`npm run lint` does not exist).
+- Do not assume ESLint/Prettier are configured.
+- Keep formatting and style aligned with existing files.
+
+## Tests
+
+- There is currently **no test script** in this repository’s `package.json`.
+- There is no committed `test/` directory in this repo at the moment.
+- For now, validation is typically: build + typecheck + targeted manual CLI/API smoke checks.
+
+## Running a single test (when test files exist)
+
+If you add Node test files (for example `*.test.mjs`), run one test file directly with:
+
+- `node --test path/to/file.test.mjs`
+
+Example:
+
+- `node --test test/recipe-smoke.test.mjs`
+
+Notes:
+
+- Scaffolded recipe projects generated by `clawchef scaffold` include `test/recipe-smoke.test.mjs`.
+- Those scaffolded projects also include `npm run test:recipe` and `npm test`, but this repo currently does not.
+
+## Coding Style Guidelines
+
+These conventions are based on current source in `src/`.
+
+## Formatting and syntax
+
+- Use 2-space indentation.
+- Use semicolons.
+- Use double quotes for strings.
+- Prefer trailing commas in multiline literals/calls.
+- Keep functions focused and relatively small unless complexity requires expansion.
+
+## Module system and imports
+
+- Use ESM imports/exports only.
+- For local imports, include `.js` extension in import specifiers (important for NodeNext output).
+- Use `import type` for type-only imports.
+- Prefer Node built-ins via `node:` prefix.
+- Import ordering is not rigidly enforced; keep it consistent within each edited file.
+
+## Types and strictness
+
+- Preserve strict TypeScript compatibility (`strict: true`).
+- Avoid `any`; use `unknown` when needed and narrow safely.
+- Prefer explicit interfaces/types for structured data (see `src/types.ts`).
+- Prefer narrow unions for finite modes/options (`RunScope`, provider names, etc.).
+- Keep runtime validation in sync with static types.
+  - If a recipe shape changes, update both `src/types.ts` and `src/schema.ts`.
+
+## Naming conventions
+
+- `camelCase` for variables/functions.
+- `PascalCase` for classes, interfaces, and type aliases intended as entities.
+- `UPPER_SNAKE_CASE` for top-level constants with fixed meaning.
+- Keep naming domain-oriented (`workspace`, `channel`, `agent`, `bootstrap`, `scope`).
+
+## Error handling conventions
+
+- Throw `ClawChefError` for expected/user-facing failures.
+- Include actionable, specific messages.
+- For caught unknown errors, convert to readable message:
+  - `err instanceof Error ? err.message : String(err)`
+- At CLI top-level, only `ClawChefError` should map to normal error output; unknown errors become fatal.
+
+## Logging and output
+
+- Use `Logger` (`info`, `warn`, `debug`) for orchestration flow messages.
+- `debug` logs should remain behind `--verbose`.
+- Keep logs concise and operationally useful.
+- Use `process.stdout.write` / `process.stderr.write` for CLI I/O (consistent with existing code).
+
+## Async and filesystem patterns
+
+- Use async/await with `node:fs/promises` APIs.
+- Prefer non-blocking I/O, except tiny startup reads where sync is already established (`readPackageVersion`).
+- Wrap external command execution and network operations with clear errors.
+- Preserve cleanup behavior for temp dirs/files via `try/finally`.
+
+## Recipe/schema evolution rules
+
+- Schema is strict (`zod` `.strict()` used heavily); unknown keys are rejected.
+- Enforce semantic constraints in `semanticValidate` (`src/recipe.ts`) after schema parse.
+- Keep secret-handling guardrails intact:
+  - Inline secrets should be rejected where required.
+  - Template placeholders (`${var}`) are expected for secrets.
+
+## CLI/API change guidelines
+
+- Keep CLI flags in `src/cli.ts` aligned with Node API options in `src/api.ts` when feature parity is intended.
+- Validate mutually dependent options early (for example, scope + workspace pairing).
+- Maintain provider parity (`command`, `remote`, `mock`) when adding operations.
+- If provider interface changes, update all provider implementations and factory wiring.
+
+## Suggested pre-commit checklist for agents
+
+- `npm run typecheck`
+- `npm run build`
+- If tests were added: run relevant Node tests, at least one targeted file
+- Verify README snippets if CLI flags/behavior changed
+- Confirm `src/types.ts` and `src/schema.ts` remain synchronized
+
+## Quick architecture map
+
+- `src/cli.ts`: command parsing + CLI runtime wiring
+- `src/api.ts`: Node API (`cook`, `validate`, `scaffold`)
+- `src/recipe.ts`: recipe loading, template resolution, semantic validation
+- `src/orchestrator.ts`: execution flow across workspaces/agents/channels/files
+- `src/openclaw/*.ts`: provider abstraction and implementations
+- `src/schema.ts` + `src/types.ts`: validation schema and TS domain model
+
+When in doubt, follow existing patterns in adjacent files and keep changes minimal, explicit, and type-safe.

package/README.md

@@ -15,10 +15,11 @@ Recipe-driven OpenClaw environment orchestrator.
 - Supports scoped execution via `--scope full|files|workspace`.
 - `full` scope runs factory reset first (with confirmation prompt unless `-s/--silent` is used).
 - If `openclaw` is missing, auto-installs the recipe version and skips factory reset.
-- Starts OpenClaw gateway service after each recipe execution.
+- Starts OpenClaw gateway after each recipe execution based on `--gateway-mode`.
 - Creates workspaces and agents (default workspace path: `~/.openclaw/workspace-<workspace-name>`).
 - Supports workspace-level assets copy via `workspaces[].assets`.
 - Materializes files into target workspaces.
+- Supports OpenClaw root-level assets/files via `openclaw.root` (default root path: `~/.openclaw`).
 - Installs skills.
 - Supports plugin preinstall via `openclaw.plugins[]` and runtime `--plugin` flags.
 - Configures channels with `openclaw channels add`.
@@ -90,6 +91,14 @@ Skip reset confirmation prompt:
 clawchef cook recipes/sample.yaml -s
 ```
 
+Control gateway startup mode:
+
+```bash
+clawchef cook recipes/sample.yaml --gateway-mode service
+clawchef cook recipes/sample.yaml --gateway-mode run
+clawchef cook recipes/sample.yaml --gateway-mode none
+```
+
 Warning: `-s/--silent` suppresses the factory-reset confirmation and auto-chooses force reinstall on version mismatch.
 Use it only in CI/non-interactive flows where destructive reset behavior is expected.
 
@@ -204,6 +213,7 @@ await scaffold("./my-recipe-project", {
 - `plugins`: plugin npm specs to preinstall for this run (`string[]`)
 - `scope`: `full | files | workspace` (default: `full`)
 - `workspaceName`: required when `scope: "workspace"`
+- `gatewayMode`: `service | run | none` (default: `service`)
 - `provider`: `command | remote | mock`
 - `remote`: remote provider config (same fields as CLI remote flags)
 - `envFile`: custom env file path/URL; when set, default cwd `.env` loading is skipped
@@ -304,9 +314,11 @@ Supported operation values sent by clawchef:
 - `ensure_version`, `factory_reset`, `start_gateway`
 - `install_plugin`
 - `create_workspace`, `create_agent`, `materialize_file`, `install_skill`
-- `configure_channel`, `login_channel`
+- `configure_channel`, `bind_channel_agent`, `login_channel`
 - `run_agent`
 
+For `start_gateway`, clawchef sends `{ mode: "service" | "run" }` in payload when gateway mode is enabled.
+
 For `run_agent`, clawchef expects `output` in response for assertions.
 
 `command` provider now defaults to the current OpenClaw CLI shape (`openclaw 2026.x`), including:
@@ -352,6 +364,8 @@ For `command` provider, default command templates are:
 - `install_plugin`: `${bin} plugins install ${plugin_spec_q}`
 - `factory_reset`: `${bin} reset --scope full --yes --non-interactive`
 - `start_gateway`: `${bin} gateway start`
+- `run_gateway`: `${bin} gateway run`
+- `bind_channel_agent`: built-in `openclaw config get/set bindings` upsert (override with `openclaw.commands.bind_channel_agent`)
 - `login_channel`: `${bin} channels login --channel ${channel_q}${account_arg}`
 - `create_workspace`: generated from `openclaw.bootstrap` (override with `openclaw.commands.create_workspace`)
 - `create_agent`: `${bin} agents add ${agent} --workspace ${workspace_path} --model ${model} --non-interactive --json`
@@ -377,6 +391,12 @@ channels:
   - channel: "telegram"
     token: "${telegram_bot_token}"
     account: "default"
+    agent: "main"
+
+  - channel: "telegram"
+    token: "${alerts_bot_token}"
+    account: "alerts"
+    agent: "alerts"
 
   - channel: "slack"
     bot_token: "${slack_bot_token}"
@@ -392,9 +412,12 @@ channels:
 Supported common fields:
 
 - required: `channel`
-- optional: `account`, `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`, `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`.
+
 ## Workspace path behavior
 
 - `workspaces[].path` is optional.
@@ -416,9 +439,31 @@ workspaces:
     assets: "./meetingbot-assets"
 ```
 
+## OpenClaw root files
+
+- `openclaw.root.path` is optional.
+- If omitted, clawchef uses `~/.openclaw`.
+- `openclaw.root.assets` is optional and recursively copied into the root directory.
+- `openclaw.root.files[]` runs after assets copy, so explicit file entries can override copied assets.
+- `openclaw.root.assets` is resolved relative to the recipe file path (unless absolute path is given).
+- Direct URL recipes do not support `openclaw.root.assets` (assets must resolve to a local directory).
+- `openclaw.root` currently supports `command` and `mock` providers; `remote` provider is not supported.
+
+Example:
+
+```yaml
+openclaw:
+  version: "2026.2.9"
+  root:
+    assets: "./openclaw-root-assets"
+    files:
+      - path: "AGENTS.md"
+        content_from: "./snippets/agents-template.md"
+```
+
 ## File content references
 
-In `workspaces[].files[]`, set exactly one of:
+In `workspaces[].files[]` and `openclaw.root.files[]`, set exactly one of:
 
 - `content`: inline text in recipe
 - `content_from`: load text from another file/URL (loaded content supports `${var}` template rendering)

package/dist/api.d.ts

@@ -1,4 +1,4 @@
-import type { OpenClawProvider, OpenClawRemoteConfig, RunScope } from "./types.js";
+import type { GatewayMode, OpenClawProvider, OpenClawRemoteConfig, RunScope } from "./types.js";
 import type { ScaffoldOptions, ScaffoldResult } from "./scaffold.js";
 export interface CookOptions {
     vars?: Record<string, string>;
@@ -9,6 +9,7 @@ export interface CookOptions {
     silent?: boolean;
     scope?: RunScope;
     workspaceName?: string;
+    gatewayMode?: GatewayMode;
     provider?: OpenClawProvider;
     remote?: Partial<OpenClawRemoteConfig>;
     envFile?: string;

package/dist/api.js

@@ -21,6 +21,7 @@ function normalizeCookOptions(options) {
         plugins,
         scope,
         workspaceName,
+        gatewayMode: options.gatewayMode ?? "service",
         dryRun: Boolean(options.dryRun),
         allowMissing: Boolean(options.allowMissing),
         verbose: Boolean(options.verbose),

package/dist/cli.js

@@ -61,6 +61,12 @@ function parseScope(value) {
     }
     throw new ClawChefError(`Invalid --scope value: ${value}. Expected full, files, or workspace`);
 }
+function parseGatewayMode(value) {
+    if (value === "service" || value === "run" || value === "none") {
+        return value;
+    }
+    throw new ClawChefError(`Invalid --gateway-mode value: ${value}. Expected service, run, or none`);
+}
 function parseOptionalInt(value, fieldName) {
     if (value === undefined) {
         return undefined;
@@ -101,6 +107,7 @@ export function buildCli() {
         .option("-s, --silent", "Skip reset confirmation prompt", false)
         .option("--scope <scope>", "Run scope: full | files | workspace", "full")
         .option("--workspace <name>", "Workspace name (required when --scope workspace)")
+        .option("--gateway-mode <mode>", "Gateway mode: service | run | none", "service")
         .option("--dotenv-ref <path-or-url>", "Load env vars from local file or HTTP URL")
         .option("--provider <provider>", "Execution provider: command | remote | mock")
         .option("--plugin <npm-spec>", "Preinstall plugin package (repeatable)", (v, p) => p.concat([v]), [])
@@ -119,6 +126,7 @@ export function buildCli() {
         }
         const provider = parseProvider(opts.provider ?? readEnv("CLAWCHEF_PROVIDER") ?? "command");
         const scope = parseScope(String(opts.scope ?? "full"));
+        const gatewayMode = parseGatewayMode(String(opts.gatewayMode ?? "service"));
         const workspaceName = opts.workspace?.trim() ? String(opts.workspace).trim() : undefined;
         if (scope === "workspace" && !workspaceName) {
             throw new ClawChefError("--scope workspace requires --workspace <name>");
@@ -131,6 +139,7 @@ export function buildCli() {
             plugins: parsePluginFlags(opts.plugin),
             scope,
             workspaceName,
+            gatewayMode,
             dryRun: Boolean(opts.dryRun),
             allowMissing: Boolean(opts.allowMissing),
             verbose: Boolean(opts.verbose),

package/dist/openclaw/command-provider.d.ts

@@ -1,13 +1,14 @@
-import type { AgentDef, ChannelDef, ConversationDef, OpenClawSection } from "../types.js";
+import type { AgentDef, ChannelDef, ConversationDef, GatewayMode, OpenClawSection } from "../types.js";
 import type { EnsureVersionResult, OpenClawProvider, ResolvedWorkspaceDef } from "./provider.js";
 export declare class CommandOpenClawProvider implements OpenClawProvider {
     private readonly stagedMessages;
     ensureVersion(config: OpenClawSection, dryRun: boolean, silent: boolean, preserveExistingState: boolean): Promise<EnsureVersionResult>;
     factoryReset(config: OpenClawSection, dryRun: boolean): Promise<void>;
     installPlugin(config: OpenClawSection, pluginSpec: string, dryRun: boolean): Promise<void>;
-    startGateway(config: OpenClawSection, dryRun: boolean): Promise<void>;
+    startGateway(config: OpenClawSection, mode: GatewayMode, dryRun: boolean): Promise<void>;
     createWorkspace(config: OpenClawSection, workspace: ResolvedWorkspaceDef, dryRun: boolean): Promise<void>;
     configureChannel(config: OpenClawSection, channel: ChannelDef, dryRun: boolean): Promise<void>;
+    bindChannelAgent(config: OpenClawSection, channel: ChannelDef, agent: string, dryRun: boolean): Promise<void>;
     loginChannel(config: OpenClawSection, channel: ChannelDef, dryRun: boolean): Promise<void>;
     createAgent(config: OpenClawSection, agent: AgentDef, workspacePath: string, dryRun: boolean): Promise<void>;
     installSkill(config: OpenClawSection, workspace: string, agent: string, skill: string, dryRun: boolean): Promise<void>;

package/dist/openclaw/command-provider.js

@@ -13,7 +13,9 @@ const DEFAULT_COMMANDS = {
     install_plugin: "${bin} plugins install ${plugin_spec_q}",
     factory_reset: "${bin} reset --scope full --yes --non-interactive",
     start_gateway: "${bin} gateway start",
+    run_gateway: "${bin} gateway run",
     enable_plugin: "",
+    bind_channel_agent: "",
     login_channel: "${bin} channels login --channel ${channel_q}${account_arg}",
     create_agent: "${bin} agents add ${agent} --workspace ${workspace_path} --model ${model} --non-interactive --json",
     install_skill: "${bin} skills check",
@@ -227,6 +229,36 @@ function bootstrapRuntimeEnv(bootstrap) {
     }
     return env;
 }
+function isAccountLevelBinding(item, channel, account) {
+    const match = item.match;
+    if (!match || typeof match !== "object") {
+        return false;
+    }
+    if (match.channel !== channel || match.accountId !== account) {
+        return false;
+    }
+    return (match.peer === undefined
+        && match.parentPeer === undefined
+        && match.guildId === undefined
+        && match.teamId === undefined
+        && match.roles === undefined);
+}
+function parseBindingsJson(raw) {
+    if (!raw.trim()) {
+        return [];
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed)) {
+            throw new ClawChefError("openclaw config bindings is not an array");
+        }
+        return parsed;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new ClawChefError(`Failed to parse openclaw bindings JSON: ${message}`);
+    }
+}
 export class CommandOpenClawProvider {
     stagedMessages = new Map();
     async ensureVersion(config, dryRun, silent, preserveExistingState) {
@@ -331,9 +363,13 @@ export class CommandOpenClawProvider {
         }
         await runShell(cmd, dryRun);
     }
-    async startGateway(config, dryRun) {
+    async startGateway(config, mode, dryRun) {
+        if (mode === "none") {
+            return;
+        }
         const bin = config.bin ?? "openclaw";
-        const startCmd = commandFor(config, "start_gateway", { bin, version: config.version });
+        const key = mode === "run" ? "run_gateway" : "start_gateway";
+        const startCmd = commandFor(config, key, { bin, version: config.version });
         if (!startCmd.trim()) {
             return;
         }
@@ -408,6 +444,53 @@ export class CommandOpenClawProvider {
         const cmd = `${bin} channels add ${flags.join(" ")}`;
         await runShell(cmd, dryRun);
     }
+    async bindChannelAgent(config, channel, agent, dryRun) {
+        const account = channel.account?.trim();
+        if (!account) {
+            throw new ClawChefError(`Channel ${channel.channel} requires account for agent binding`);
+        }
+        const bin = config.bin ?? "openclaw";
+        const customTemplate = config.commands?.bind_channel_agent;
+        if (customTemplate?.trim()) {
+            const customCmd = fillTemplate(customTemplate, {
+                bin,
+                version: config.version,
+                channel: channel.channel,
+                channel_q: shellQuote(channel.channel),
+                account,
+                account_q: shellQuote(account),
+                agent,
+                agent_q: shellQuote(agent),
+            });
+            if (customCmd.trim()) {
+                await runShell(customCmd, dryRun);
+            }
+            return;
+        }
+        if (dryRun) {
+            return;
+        }
+        const getCmd = `${bin} config get bindings --json 2>/dev/null || printf '[]'`;
+        const rawBindings = await runShell(getCmd, false);
+        const bindings = parseBindingsJson(rawBindings);
+        const nextBinding = {
+            agentId: agent,
+            match: {
+                channel: channel.channel,
+                accountId: account,
+            },
+        };
+        const index = bindings.findIndex((item) => isAccountLevelBinding(item, channel.channel, account));
+        if (index >= 0) {
+            bindings[index] = nextBinding;
+        }
+        else {
+            bindings.push(nextBinding);
+        }
+        const json = JSON.stringify(bindings);
+        const setCmd = `${bin} config set bindings ${shellQuote(json)} --json`;
+        await runShell(setCmd, false);
+    }
     async loginChannel(config, channel, dryRun) {
         if (!channel.login) {
             return;

package/dist/openclaw/mock-provider.d.ts

@@ -1,13 +1,14 @@
-import type { AgentDef, ChannelDef, ConversationDef, OpenClawSection } from "../types.js";
+import type { AgentDef, ChannelDef, ConversationDef, GatewayMode, OpenClawSection } from "../types.js";
 import type { EnsureVersionResult, OpenClawProvider, ResolvedWorkspaceDef } from "./provider.js";
 export declare class MockOpenClawProvider implements OpenClawProvider {
     private state;
     ensureVersion(config: OpenClawSection, _dryRun: boolean, _silent: boolean, _preserveExistingState: 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>;
+    startGateway(_config: OpenClawSection, _mode: GatewayMode, _dryRun: boolean): Promise<void>;
     createWorkspace(_config: OpenClawSection, workspace: ResolvedWorkspaceDef, _dryRun: boolean): Promise<void>;
     configureChannel(_config: OpenClawSection, channel: ChannelDef, _dryRun: boolean): Promise<void>;
+    bindChannelAgent(_config: OpenClawSection, _channel: ChannelDef, _agent: string, _dryRun: boolean): Promise<void>;
     loginChannel(_config: OpenClawSection, _channel: ChannelDef, _dryRun: boolean): Promise<void>;
     createAgent(_config: OpenClawSection, agent: AgentDef, _workspacePath: string, _dryRun: boolean): Promise<void>;
     installSkill(_config: OpenClawSection, workspace: string, agent: string, skill: string, _dryRun: boolean): Promise<void>;

package/dist/openclaw/mock-provider.js

@@ -35,7 +35,7 @@ export class MockOpenClawProvider {
         this.state.skills.clear();
         this.state.messages.clear();
     }
-    async startGateway(_config, _dryRun) {
+    async startGateway(_config, _mode, _dryRun) {
         return;
     }
     async createWorkspace(_config, workspace, _dryRun) {
@@ -44,6 +44,9 @@ export class MockOpenClawProvider {
     async configureChannel(_config, channel, _dryRun) {
         this.state.channels.add(`${channel.channel}::${channel.account ?? "default"}`);
     }
+    async bindChannelAgent(_config, _channel, _agent, _dryRun) {
+        return;
+    }
     async loginChannel(_config, _channel, _dryRun) {
         return;
     }

package/dist/openclaw/provider.d.ts

@@ -1,4 +1,4 @@
-import type { AgentDef, ChannelDef, ConversationDef, OpenClawSection, WorkspaceDef } from "../types.js";
+import type { AgentDef, ChannelDef, ConversationDef, GatewayMode, OpenClawSection, WorkspaceDef } from "../types.js";
 export type ResolvedWorkspaceDef = WorkspaceDef & {
     path: string;
 };
@@ -9,9 +9,10 @@ export interface OpenClawProvider {
     ensureVersion(config: OpenClawSection, dryRun: boolean, silent: boolean, preserveExistingState: 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>;
+    startGateway(config: OpenClawSection, mode: GatewayMode, dryRun: boolean): Promise<void>;
     createWorkspace(config: OpenClawSection, workspace: ResolvedWorkspaceDef, dryRun: boolean): Promise<void>;
     configureChannel(config: OpenClawSection, channel: ChannelDef, dryRun: boolean): Promise<void>;
+    bindChannelAgent(config: OpenClawSection, channel: ChannelDef, agent: string, dryRun: boolean): Promise<void>;
     loginChannel(config: OpenClawSection, channel: ChannelDef, dryRun: boolean): Promise<void>;
     materializeFile?(config: OpenClawSection, workspace: string, filePath: string, content: string, overwrite: boolean | undefined, dryRun: boolean): Promise<void>;
     createAgent(config: OpenClawSection, agent: AgentDef, workspacePath: string, dryRun: boolean): Promise<void>;

package/dist/openclaw/remote-provider.d.ts

@@ -1,4 +1,4 @@
-import type { AgentDef, ChannelDef, ConversationDef, OpenClawRemoteConfig, OpenClawSection } from "../types.js";
+import type { AgentDef, ChannelDef, ConversationDef, GatewayMode, OpenClawRemoteConfig, OpenClawSection } from "../types.js";
 import type { EnsureVersionResult, OpenClawProvider, ResolvedWorkspaceDef } from "./provider.js";
 export declare class RemoteOpenClawProvider implements OpenClawProvider {
     private readonly stagedMessages;
@@ -8,9 +8,10 @@ export declare class RemoteOpenClawProvider implements OpenClawProvider {
     ensureVersion(config: OpenClawSection, dryRun: boolean, _silent: boolean, _preserveExistingState: 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>;
+    startGateway(config: OpenClawSection, mode: GatewayMode, dryRun: boolean): Promise<void>;
     createWorkspace(config: OpenClawSection, workspace: ResolvedWorkspaceDef, dryRun: boolean): Promise<void>;
     configureChannel(config: OpenClawSection, channel: ChannelDef, dryRun: boolean): Promise<void>;
+    bindChannelAgent(config: OpenClawSection, channel: ChannelDef, agent: string, dryRun: boolean): Promise<void>;
     loginChannel(config: OpenClawSection, channel: ChannelDef, dryRun: boolean): Promise<void>;
     materializeFile(config: OpenClawSection, workspace: string, filePath: string, content: string, overwrite: boolean | undefined, dryRun: boolean): Promise<void>;
     createAgent(config: OpenClawSection, agent: AgentDef, workspacePath: string, dryRun: boolean): Promise<void>;

package/dist/openclaw/remote-provider.js

@@ -110,8 +110,11 @@ export class RemoteOpenClawProvider {
     async factoryReset(config, dryRun) {
         await this.perform(config, "factory_reset", undefined, dryRun);
     }
-    async startGateway(config, dryRun) {
-        await this.perform(config, "start_gateway", undefined, dryRun);
+    async startGateway(config, mode, dryRun) {
+        if (mode === "none") {
+            return;
+        }
+        await this.perform(config, "start_gateway", { mode }, dryRun);
     }
     async createWorkspace(config, workspace, dryRun) {
         await this.perform(config, "create_workspace", { workspace }, dryRun);
@@ -119,6 +122,13 @@ export class RemoteOpenClawProvider {
     async configureChannel(config, channel, dryRun) {
         await this.perform(config, "configure_channel", { channel }, dryRun);
     }
+    async bindChannelAgent(config, channel, agent, dryRun) {
+        await this.perform(config, "bind_channel_agent", {
+            channel: channel.channel,
+            account: channel.account,
+            agent,
+        }, dryRun);
+    }
     async loginChannel(config, channel, dryRun) {
         await this.perform(config, "login_channel", { channel }, dryRun);
     }