\n\n \n\n## Install\n\n### Are you an AI agent reading this? In that case, use the prompt below to setup DenchClaw.\n\n```\nInstall DenchClaw (an OpenClaw CRM Framwork) by running \"npx denchclaw bootstrap\", when it asks to update OpenClaw, update it as DenchClaw requires up to date OpenClaw. When it asks for my Dench API Key, help me fetch it from dench.com/api and set it up. Remember that DenchClaw creates a new OpenClaw Gateway (~/.openclaw-dench) on port 19001 by default, and a new main agent in that gateway working in ~/.openclaw-dench/workspace directory (Separate from the usual non-DenchClaw OpenClaw gateway that usually sits in ~/.openclaw). All DenchClaw config sits in ~/.openclaw-dench/openclaw.json. Remember that anytime you interface with DenchClaw using openclaw commands, you must use \"openclaw --profile dench\" as a prefix, for example, to restart gateway, run \"openclaw --profile dench gateway restart\". After everything is setup, DenchClaw will be accessible at localhost:3100 by default. If for some reason that Port 19001 and 3100 or those ranges are taken, make sure to kill those ports/processes and then retry npx denchclaw bootstrap. Also, sometimes if the Web UI on port 3100 crashes, just run \"npx denchclaw update\" to boot it back up. Remember to refer to https://github.com/DenchHQ/DenchClaw (DenchClaw's official GitHub Repository) for more information.\n```\n\n### Manual Install\n\n**Node 22+ required.**\n\n```bash\nnpx denchclaw@latest bootstrap\n```\n\nOpens at `localhost:3100` after completing onboarding wizard.\n\n---\n\n## Commands\n\n```bash\nnpx denchclaw@latest bootstrap # runs onboarding again for openclaw --profile dench\nnpx denchclaw@latest update # updates denchclaw web-runtime with current settings as is\nnpx denchclaw restart # restarts denchclaw web server\nnpx denchclaw start # starts denchclaw web server\nnpx denchclaw stop # stops denchclaw web server\n\n# some examples\nopenclaw --profile dench \nopenclaw --profile dench gateway restart\n\nopenclaw --profile dench config set gateway.port 19001\nopenclaw --profile dench gateway install --force --port 19001\nopenclaw --profile dench gateway restart\nopenclaw --profile dench uninstall\n```\n\n### Daemonless / Docker\n\nFor containers or environments without systemd/launchd, set the environment variable once:\n\n```bash\nexport DENCHCLAW_DAEMONLESS=1\n```\n\nThis 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:\n\n```bash\nopenclaw --profile dench gateway --port 19001\n```\n\nAlternatively, pass `--skip-daemon-install` to individual commands:\n\n```bash\nnpx denchclaw bootstrap --skip-daemon-install\nnpx denchclaw update --skip-daemon-install\nnpx denchclaw start --skip-daemon-install\n```\n\n---\n\n## Troubleshooting\n\n### `pairing required`\n\nIf the Control UI or CLI shows `gateway connect failed: GatewayClientRequestError: pairing required`, the local device is still waiting for approval.\n\nRecent `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:\n\n```bash\nopenclaw --profile dench devices list\n```\n\nReview the pending `operator` request, then approve it:\n\n```bash\nopenclaw --profile dench devices approve --latest\n\n# or approve the exact request you just reviewed\nopenclaw --profile dench devices approve \n```\n\nIf 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](https://docs.openclaw.ai/cli/devices#openclaw-devices-list) for more details.\n\nAfter approval, refresh the browser. If the UI is still disconnected, restart the managed web runtime:\n\n```bash\nnpx denchclaw restart\n```\n\n---\n\n## Development\n\n```bash\ngit clone https://github.com/DenchHQ/DenchClaw.git\ncd denchclaw\n\npnpm install\npnpm build\n\npnpm dev\n```\n\nWeb UI development:\n\n```bash\npnpm install\npnpm web:dev\n```\n\n---\n\n## Open Source\n\nMIT Licensed. Fork it, extend it, make it yours.\n\n
![\"DenchClaw](\"assets/denchclaw-hero.png\")
\n \n![\"npm](\"https://img.shields.io/npm/v/denchclaw?style=for-the-badge&color=000\")
![\"Discord\"](\"https://img.shields.io/discord/1456350064065904867?label=Discord&logo=discord&logoColor=white&color=5865F2&style=for-the-badge\")
![\"MIT](\"https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge\"){kind=icon}
\n![\"DenchClaw](\"assets/denchclaw-app.png\")
\n \n ![\"GitHub](\"https://img.shields.io/github/stars/DenchHQ/DenchClaw?style=for-the-badge\")