openclaw - 💡(How to fix) Fix Feature request: Approval gate for restart-required config changes

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Root Cause

A Dropbox sync modified plugins.allow in ~/.openclaw/openclaw.json. The gateway detected the restart-required config change and auto-executed a restart — 5-minute drain timeout → SIGUSR1 → full restart. No API actor was logged (because it wasn't an API call), and no approval was requested.

Fix Action

Fix / Workaround

When a restart-required config field (e.g. plugins.allow) is modified via direct file write (not the config.patch API), the gateway auto-detects the change and executes a restart without any human approval gate.

RAW_BUFFERClick to expand / collapse

Problem

When a restart-required config field (e.g. plugins.allow) is modified via direct file write (not the config.patch API), the gateway auto-detects the change and executes a restart without any human approval gate.

This is a problem in environments where:

  • The config file is synced via Dropbox/iCloud/etc. and external changes can arrive unexpectedly
  • Operational protocols require human approval before any gateway restart (e.g., in multi-agent production environments)

What happened

A Dropbox sync modified plugins.allow in ~/.openclaw/openclaw.json. The gateway detected the restart-required config change and auto-executed a restart — 5-minute drain timeout → SIGUSR1 → full restart. No API actor was logged (because it wasn't an API call), and no approval was requested.

This caused ~6 minutes of downtime and 4 failed message deliveries during an active conversation.

Proposed solution

Add a restartApproval config option (or similar) that, when enabled:

  1. Detects restart-required config changes as it does today
  2. Instead of auto-restarting, queues the restart and notifies the configured admin (via Slack/webhook/etc.)
  3. Waits for explicit approval (e.g., a CLI command like openclaw gateway approve-restart or an API call) before executing the restart

Alternative (lighter touch)

A restartPolicy field with options:

  • auto (current behavior — restart immediately)
  • notify (restart, but send a notification first with a configurable delay)
  • manual (queue the restart, require explicit approval)

Environment

  • OpenClaw 2026.4.15
  • macOS (LaunchAgent service)
  • Config synced via Dropbox

extent analysis

TL;DR

To prevent unexpected gateway restarts, consider adding a restartApproval config option or a restartPolicy field to require explicit approval before restarting.

Guidance

  • Review the proposed restartApproval config option to understand how it can be implemented to queue restarts and notify admins.
  • Evaluate the alternative restartPolicy field with options like auto, notify, and manual to determine which approach best fits your operational protocols.
  • Consider the trade-offs between auto-restarting, notifying with a delay, and requiring manual approval for restarts in your production environment.
  • Assess the feasibility of implementing a CLI command like openclaw gateway approve-restart or an API call for explicit approval.

Example

No code snippet is provided as the issue does not contain sufficient technical details for a specific implementation.

Notes

The solution requires modifications to the OpenClaw configuration and potentially its underlying code. The restartApproval option or restartPolicy field should be carefully evaluated to ensure they meet the operational requirements of your environment.

Recommendation

Apply a workaround by exploring the proposed restartApproval config option or restartPolicy field, as they offer a way to introduce an approval gate before restarts, aligning with operational protocols requiring human approval.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING