@2en/clawly-plugins 1.30.0-beta.5 → 1.30.0-beta.6

package/clawly-config-defaults.json5

@@ -179,9 +179,23 @@
     },
   },
 
+  // gateway.reload — use "hot" mode to prevent spurious SIGUSR1 restarts.
+  // config-setup writes restart-requiring keys (commands.*, gateway.*, env.*)
+  // after the gateway has already captured its startup config snapshot.
+  // In "hybrid" (default) mode, any subsequent config file write triggers the
+  // file watcher to diff against the stale snapshot, discover the config-setup
+  // changes as "new", and issue SIGUSR1. "hot" mode makes the watcher ignore
+  // restart-requiring diffs — only hot-reloadable changes (heartbeat, cron,
+  // hooks, browser) are applied. Direct SIGUSR1 from explicit restart commands
+  // and plugin auto-update is unaffected. If you manually edit a restart-
+  // requiring field in openclaw.json, run `openclaw restart` to apply it.
+  //
   // gateway.nodes — allowlist dangerous node commands so the AI agent can
   // invoke them on connected Clawly nodes (browser, reminders, calendar, device).
   gateway: {
+    reload: {
+      mode: "hot",
+    },
     nodes: {
       allowCommands: [
         // Browser commands (Mac nodes)

package/gateway/config-model.ts

@@ -0,0 +1,68 @@
+/**
+ * Model switch RPC: writes agents.defaults.model.primary to openclaw.json
+ * without triggering a gateway restart.
+ *
+ * OpenClaw reads agents.defaults.model.primary dynamically on each chat
+ * request (loadConfig() has a ~200ms cache). A disk write takes effect
+ * within that window — no SIGUSR1 needed.
+ *
+ * Uses the runtime config APIs (loadConfig + writeConfigFile) for atomic
+ * writes, env var preservation, and config validation.
+ *
+ * Methods:
+ * - clawly.config.setModel({ model }) → { changed, model }
+ */
+
+import type {PluginApi} from '../types'
+import type {OpenClawConfig} from '../types/openclaw'
+
+export function registerConfigModel(api: PluginApi) {
+  api.registerGatewayMethod('clawly.config.setModel', async ({params, respond}) => {
+    const model = typeof params.model === 'string' ? params.model : ''
+    if (!model) {
+      respond(true, {changed: false, model: '', error: 'Missing model param'})
+      return
+    }
+
+    let config: OpenClawConfig
+    try {
+      config = {...(api.runtime.config.loadConfig() as OpenClawConfig)}
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err)
+      respond(true, {changed: false, model, error: `Load failed: ${msg}`})
+      return
+    }
+
+    const current = (config.agents as Record<string, unknown> | undefined)?.defaults as
+      | Record<string, unknown>
+      | undefined
+    const currentModel = (current?.model as Record<string, unknown> | undefined)?.primary
+
+    if (currentModel === model) {
+      respond(true, {changed: false, model})
+      return
+    }
+
+    // Shallow-copy nested objects to avoid polluting the loadConfig() cache
+    // if writeConfigFile fails below.
+    const agents = {...((config.agents ?? {}) as Record<string, unknown>)}
+    const defaults = {...((agents.defaults ?? {}) as Record<string, unknown>)}
+    const modelObj = {...((defaults.model ?? {}) as Record<string, unknown>)}
+    modelObj.primary = model
+    defaults.model = modelObj
+    agents.defaults = defaults
+    config.agents = agents
+
+    try {
+      await api.runtime.config.writeConfigFile(config)
+      api.logger.info(`config-model: set model.primary to ${model}`)
+      respond(true, {changed: true, model})
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err)
+      api.logger.error(`config-model: write failed — ${msg}`)
+      respond(true, {changed: false, model, error: `Write failed: ${msg}`})
+    }
+  })
+
+  api.logger.info('config-model: registered clawly.config.setModel')
+}

package/gateway/config-timezone.ts

@@ -2,14 +2,15 @@
  * Timezone sync RPC: writes agents.defaults.userTimezone to openclaw.json
  * without triggering a gateway restart.
  *
+ * Uses the runtime config APIs (loadConfig + writeConfigFile) for atomic
+ * writes, env var preservation, and config validation.
+ *
  * Methods:
  * - clawly.config.setTimezone({ timezone }) → { changed, timezone }
  */
 
-import path from 'node:path'
-
 import type {PluginApi} from '../types'
-import {readOpenclawConfig, writeOpenclawConfig} from '../model-gateway-setup'
+import type {OpenClawConfig} from '../types/openclaw'
 
 export function registerConfigTimezone(api: PluginApi) {
   api.registerGatewayMethod('clawly.config.setTimezone', async ({params, respond}) => {
@@ -19,30 +20,34 @@ export function registerConfigTimezone(api: PluginApi) {
       return
     }
 
-    const stateDir = api.runtime.state.resolveStateDir()
-    if (!stateDir) {
-      respond(true, {changed: false, timezone, error: 'Cannot resolve state dir'})
+    let config: OpenClawConfig
+    try {
+      config = {...(api.runtime.config.loadConfig() as OpenClawConfig)}
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err)
+      respond(true, {changed: false, timezone, error: `Load failed: ${msg}`})
       return
     }
 
-    const configPath = path.join(stateDir, 'openclaw.json')
-    const config = readOpenclawConfig(configPath)
-
-    const agents = (config.agents ?? {}) as Record<string, unknown>
-    const defaults = (agents.defaults ?? {}) as Record<string, unknown>
-    const current = defaults.userTimezone
+    const currentDefaults = (config.agents as Record<string, unknown> | undefined)?.defaults as
+      | Record<string, unknown>
+      | undefined
 
-    if (current === timezone) {
+    if (currentDefaults?.userTimezone === timezone) {
       respond(true, {changed: false, timezone})
       return
     }
 
+    // Shallow-copy nested objects to avoid polluting the loadConfig() cache
+    // if writeConfigFile fails below.
+    const agents = {...((config.agents ?? {}) as Record<string, unknown>)}
+    const defaults = {...((agents.defaults ?? {}) as Record<string, unknown>)}
     defaults.userTimezone = timezone
     agents.defaults = defaults
     config.agents = agents
 
     try {
-      writeOpenclawConfig(configPath, config)
+      await api.runtime.config.writeConfigFile(config)
       api.logger.info(`config-timezone: set userTimezone to ${timezone}`)
       respond(true, {changed: true, timezone})
     } catch (err) {

package/gateway/index.ts

@@ -4,6 +4,7 @@ import {registerCalendarNative} from './calendar-native'
 import {registerAnalytics} from './analytics'
 import {registerAudit} from './audit'
 import {registerClawhub2gateway} from './clawhub2gateway'
+import {registerConfigModel} from './config-model'
 import {registerConfigRepair} from './config-repair'
 import {registerConfigTimezone} from './config-timezone'
 import {registerCronDelivery} from './cron-delivery'
@@ -57,6 +58,7 @@ export function registerGateway(api: PluginApi) {
   registerCronTelemetry(api)
   registerMessageLog(api)
   registerAnalytics(api)
+  registerConfigModel(api)
   registerConfigRepair(api)
   registerConfigTimezone(api)
   registerSessionSanitize(api)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2en/clawly-plugins",
-  "version": "1.30.0-beta.5",
+  "version": "1.30.0-beta.6",
   "module": "index.ts",
   "type": "module",
   "repository": {