Skip to content
Back to search

openclaw-coolify

OpenClaw aka (Clawdbot, MoltBot) is an open agent platform that runs on your machine and works from the chat apps you already use. WhatsApp, Telegram, Discord, Slack, Teams—wherever you are, your AI assistant follows.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/essamamdani--openclaw-coolify/badge.svg)](/listings/essamamdani--openclaw-coolify)

HTML

<a href="/listings/essamamdani--openclaw-coolify"><img src="/api/listings/essamamdani--openclaw-coolify/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Open your Coolify Dashboard. 2. Navigate to **Project** > **New**. 3. Select **Public Repository**. 4. Enter the URL: `https://github.com/essamamdani/openclaw-coolify` 5. Click **Continue**.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 178 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # OpenClaw aka (Clawdbot, MoltBot) (Coolify Edition)
  2. **Your Assistant. Your Machine. Your Rules.**
  3. OpenClaw aka (Clawdbot, MoltBot) is an open agent platform that runs on your machine and works from the chat apps you already use. WhatsApp, Telegram, Discord, Slack, Teams—wherever you are, your AI assistant follows.
  4. Unlike SaaS assistants where your data lives on someone else’s servers, OpenClaw runs where you choose—laptop, homelab, or VPS. Your infrastructure. Your keys. Your data.
  5. ---
  6. ## 🚀 Easy Setup on Coolify
  7. 1. Open your Coolify Dashboard.
  8. 2. Navigate to **Project** > **New**.
  9. 3. Select **Public Repository**.
  10. 4. Enter the URL: `https://github.com/essamamdani/openclaw-coolify`
  11. 5. Click **Continue**.
  12. ---
  13. ## 📦 Post-Deployment (Ready)
  14. Once the container is running and healthy:
  15. 1. **Access the Dashboard**:
  16. - Open the **Service Logs** in Coolify.
  17. - Look for: `🦞 OPENCLAW READY`.
  18. - You will see a **Dashboard URL** with a token (e.g., `https://.../?token=xyz`).
  19. - **Click that link** to access your OpenClaw Gateway UI.
  20. 2. **Approve Your Device**:
  21. - You will see an "Unauthorized" or pairing screen (this is normal).
  22. - Open the **Service Terminal** in Coolify.
  23. - Run: `openclaw-approve`
  24. - > [!WARNING]
  25. - > **Security Note**: `openclaw-approve` is a break-glass utility that auto-accepts ALL pending pairing requests. Only run this immediately after accessing the URL yourself. Do not leave it running or use it when you don't recognize a request.
  26. 3. **Guided Onboarding**: To configure your agent's personality and skills:
  27. - In the terminal, run: `openclaw onboard`
  28. - Follow the interactive wizard.
  29. 4. **Configure Channels**: Go to the **Channels** tab in the dashboard to link WhatsApp, Telegram, etc.
  30. ---
  31. ## � Channel Setup
  32. OpenClaw lives where you work. You can connect it to WhatsApp, Telegram, Discord, etc.
  33. ### 📱 Telegram
  34. **Fastest setup.**
  35. 1. Talk to **@BotFather** on Telegram.
  36. 2. Create a new bot (`/newbot`) and get the **Token**.
  37. 3. Add `TELEGRAM_BOT_TOKEN` to your Coolify Environment Variables.
  38. 4. **Redeploy** (or just restart).
  39. 5. DM your new bot. It will ask for a **Pairing Code**.
  40. 6. Go to your OpenClaw Dashboard > **Pairing** to approve it.
  41. * *Docs: [Telegram Channel Guide](docs/channels/telegram.md)*
  42. ### 🟢 WhatsApp
  43. **Requires scanning a QR code.**
  44. 1. Go to your OpenClaw Dashboard (from the logs).
  45. 2. Navigate to **Channels** > **WhatsApp**.
  46. 3. Open WhatsApp on your phone > **Linked Devices** > **Link a Device**.
  47. 4. Scan the QR code shown on the dashboard.
  48. 5. **Done!** You can now chat with OpenClaw.
  49. * *Docs: [WhatsApp Channel Guide](docs/channels/whatsapp.md)*
  50. ### ⚡ Other Channels
  51. You can verify status or manage other channels (Discord, Slack) via the dashboard or CLI.
  52. * *CLI Docs: [Channel Management](docs/cli/channels.md)*
  53. ---
  54. ## 📦 ClawHub & Skills
  55. **ClawHub** is the public skill registry for OpenClaw. It allows you to easily find, install, and share capabilities for your agent.
  56. ### Quick Start
  57. 1. **Search** for a skill:
  58. ```bash
  59. clawhub search "calendar"
  60. ```
  61. 2. **Install** it:
  62. ```bash
  63. clawhub install <skill-slug>
  64. ```
  65. 3. **Use it**: Restart your session, and the agent will have the new capabilities.
  66. ### CLI Commands
  67. The `clawhub` CLI is pre-installed in your container.
  68. | Command | Description |
  69. | :--- | :--- |
  70. | `clawhub search "query"` | Find skills by name or tag. |
  71. | `clawhub install <slug>` | Install a skill into your workspace. |
  72. | `clawhub update --all` | Update all installed skills to the latest version. |
  73. | `clawhub login` | Login to publish your own skills. |
  74. | `clawhub publish` | Publish a skill from the current directory. |
  75. ### How it Works
  76. A skill is a folder containing a `SKILL.md` (instructions) and supporting files. When you install a skill, it is downloaded to your workspace. OpenClaw automatically loads these skills, giving your agent new powers without writing code.
  77. ---
  78. ## � Architecture: The AI Office
  79. Think of this Docker container not as an app, but as an **Office Building**.
  80. ### 1. The Staff (Multi-Agent System)
  81. * **The Manager (Gateway)**: The main `openclaw` process. It hires "staff" to do work.
  82. * **The Workers (Sandboxes)**: When you ask for a complex coding task, the Manager spins up **isolated Docker containers** (sub-agents).
  83. * They have their own Linux tools (Python, Node, Go).
  84. * They work safely in a sandbox, then report back.
  85. * *Managed via: Docker Socket Proxy (Secure Sidecar).*
  86. ### 2. Corporate Memory (Long-Term Storage)
  87. Your office never forgets, thanks to a 3-tier memory architecture:
  88. * **The Filing Cabinet (`openclaw-workspace`)**: A persistent Docker Volume where agents write code, save files, and store heavy data. Survives restarts.
  89. * **The Brain (Internal SQLite)**: OpenClaw's native transactional memory for conversations and facts.
  90. * **Web Search (SearXNG)**: A private, tracking-free search engine (`searxng:8080`) for the agent's research.
  91. ### 3. The Security Vault
  92. Your agent can securely manage credentials without leaking them:
  93. * **Bitwarden (`rbw`)**: Securely fetch secrets from your Bitwarden vault.
  94. * **Pass**: Local GPG-encrypted password storage for the agent's exclusive use.
  95. ### 4. The Public Front Door (Cloudflare Tunnel)
  96. Need to show a client your work?
  97. * The agent can start a web server (e.g., Next.js on port 3000).
  98. * It uses `cloudflared` to instantly create a **secure public URL** (e.g., `https://project-viz.trycloudflare.com`).
  99. * *No router port forwarding required.*
  100. ### 5. Advanced Web Utilities
  101. * **Universal Scraper**: 5-stage fallback engine (Curl -> AI Browser -> Anti-Detect) to read any website.
  102. * **Research Tools**: `hackernews-cli`, `tuir` (Reddit), `newsboat` (RSS), `sonos` control.
  103. ### 6. Zero-Config & Production Ready
  104. * **Pre-installed Tools**: `gh` (GitHub), `vercel`, `bun`, `python`, `ripgrep`.
  105. * **Office Suite**: `pandoc` (Docs), `marp` (Slides), `csvkit` (Excel), `qmd` (Local AI Search).
  106. * **Secure**: All sub-agents are firewalled.
  107. * **Self-Healing**: Docker volumes ensure `openclaw-config` and `openclaw-workspace` persist forever.
  108. ---
  109. ## 🔒 Security & Sandboxing
  110. - **Authentication**: Dashboard is token-protected. New chat users must be "paired" (approved) first.
  111. - **Docker Proxy**: This setup uses a **Sockety Proxy (Sidecar)** pattern.
  112. - OpenClaw talks to a restricted Docker API proxy (`tcp://docker-proxy:2375`).
  113. - **Blocked**: Swarm, Secrets, System, Volumes, and other critical host functions.
  114. - **Allowed**: Only what's needed for sandboxing (Containers, Images, Networks).
  115. - **Isolation**: Sub-agents run in disposable containers. `SOUL.md` rules forbid the agent from touching your other Coolify services.
  116. ---
  117. ## ❓ FAQ & Troubleshooting
  118. ### Usage
  119. * **Q: How do I install extra tools like `nmap` or `ffmpeg`?**
  120. * **A**: Don't edit the Dockerfile! Use **Skills**.
  121. * Create a folder `skills/my-tools` with a `SKILL.md` file instructing the agent to "Use apt-get to install ffmpeg".
  122. * Or install a pre-made skill: `clawhub install web-utils`.
  123. ### Requirements
  124. * **Q: How much space do I need on my Coolify server to install openclaw-coolify ?**
  125. * **A**: Make sure to have approximately 13 GB of free space, even if all are not used, this is what is required in docker build cache during the install process.
  126. ### Connection Issues
  127. * **Q: "No available server" or "502 Bad Gateway" on Coolify?**
  128. * **A**: Ensure your `docker-compose.yaml` has `expose: ["18789"]` (fixed in latest version).
  129. * **A**: Check logs for `OpenClaw listening on 18789`. If it says `127.0.0.1`, Traefik cannot reach it. It *must* listen on `0.0.0.0` or `lan` (default).
  130. * **Q: I can't connect from my Mac/PC?**
  131. * **A**: Use the **Public URL** generated by Coolify (e.g., `https://openclaw.my-server.com`).
  132. * **A**: DO NOT try to connect to `http://<server-ip>:18789` directly unless you manually opened that port in your server's firewall (UFW/AWS Security Group). The default setup uses reverse proxying for security.
  133. * **Q: `minimax-portal-auth` failed to load?**
  134. * **A**: This is a known warning from an optional plugin. You can safely ignore it; it does not affect the agent's core functionality.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.