ClawKit Logo
ClawKitReliability Toolkit

Fix: Exec Approval Socket Not Created - Gateway Hangs Indefinitely

TL;DR โ€” Quick Fix

The OpenClaw gateway doesn't create the exec approval Unix socket; the approval flow stalls because the web UI can't connect. The immediate workaround is to remove or comment out the `exec-approvals.json` configuration.

Run Diagnostics

Next Step

Fix now, then reduce repeat incidents

If this issue keeps coming back, validate your setup in Doctor first, then harden your config.

Error Signal

No error messageno timeoutno feedback

What's Happening

Your OpenClaw gateway isn't creating the necessary Unix socket file for command approvals. This means the web UI can't connect to send approval requests, causing the entire execution flow to hang indefinitely. You won't see any explicit errors or timeouts.

The Fix

The fastest workaround is to disable the exec approval socket configuration entirely. Edit your gateway's configuration to remove or comment out the exec-approvals.json file reference. If you're using the default setup, you might need to modify your gateway.config.json or similar.

For example, if you have a section like this:

{
  "exec-approvals": {
    "path": "/home/jackm/.openclaw/exec-approvals.sock"
  }
}

Comment it out or remove it:

{
  // "exec-approvals": {
  //   "path": "/home/jackm/.openclaw/exec-approvals.sock"
  // }
}

Restart your gateway after making this change.

Why This Occurs

This is a regression and appears to be a missing feature rather than a bug in existing code. The gateway loads the socket configuration from exec-approvals.json but never actually implements or starts a Unix socket server. The code responsible for creating the socket server is simply not present in the gateway. The configuration path specified (/home/jackm/.openclaw/exec-approvals.sock) is intended for an external process (like the web UI) to connect to, but the gateway itself doesn't host this server. When the gateway restarts, the socket file disappears, and there's no code to recreate it or the server listening on it.

Prevention

Always test your OpenClaw setup after upgrades, especially for critical features like command execution approval. Keep an eye on the official OpenClaw GitHub issues for regressions and new feature announcements. Ensure your configuration files are correctly referencing features that are actually implemented and functional in your installed version.


Last Updated: March 2026

Did this guide solve your problem?