Website · Discord · Skills Store · Demo Video

Demo Video · Join our Discord Server

Install

Node 22+ required.

npx denchclaw@latest

Opens at localhost:3100 after completing onboarding wizard.

---

Commands

npx denchclaw@latest # runs onboarding again for openclaw --profile dench
npx denchclaw@latest update # updates denchclaw web-runtime with current settings as is
npx denchclaw restart # restarts denchclaw web server
npx denchclaw start # starts denchclaw web server
npx denchclaw stop # stops denchclaw web server

# some examples
openclaw --profile dench <any openclaw command>
openclaw --profile dench gateway restart

openclaw --profile dench config set gateway.port 19001
openclaw --profile dench gateway install --force --port 19001
openclaw --profile dench gateway restart
openclaw --profile dench uninstall

Daemonless / Docker

For containers or environments without systemd/launchd, set the environment variable once:

export DENCHCLAW_DAEMONLESS=1

This skips all gateway daemon management (install/start/stop/restart) and launchd LaunchAgent installation across all commands. You must start the gateway yourself as a foreground process:

openclaw --profile dench gateway --port 19001

Alternatively, pass --skip-daemon-install to individual commands:

npx denchclaw --skip-daemon-install
npx denchclaw update --skip-daemon-install
npx denchclaw start --skip-daemon-install

---

Troubleshooting

pairing required

If the Control UI or CLI shows gateway connect failed: GatewayClientRequestError: pairing required, the local device is still waiting for approval.

Recent denchclaw bootstrap runs try to approve this automatically. If you are on an older install, or bootstrap skipped approval because there were multiple pending requests, list the pending devices first:

openclaw --profile dench devices list

Review the pending operator request, then approve it:

openclaw --profile dench devices approve --latest

# or approve the exact request you just reviewed
openclaw --profile dench devices approve <requestId>

If the client retries pairing, OpenClaw can replace the pending request with a new requestId, so run devices list immediately before approving. See the OpenClaw devices docs for more details.

After approval, refresh the browser. If the UI is still disconnected, restart the managed web runtime:

npx denchclaw restart

---

Development

git clone https://github.com/DenchHQ/DenchClaw.git
cd denchclaw

pnpm install
pnpm build

pnpm dev

Web UI development:

pnpm install
pnpm web:dev

---

Open Source

MIT Licensed. Fork it, extend it, make it yours.