selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
openclaw-coolify logo

Self-host openclaw-coolify

1.0.0

AI agent platform on your machine with chat integrations

ReleaseOpen Source
Updated5 months ago
LanguageShell
Setup difficultyAdvanced
Stars
154
Storage
13 GB free space
Port
18789 (OpenClaw Gateway HTTP API and dashboard)
Requires
Docker Registry (registry:2), Docker socket proxy (tecnativa/docker-socket-proxy), SearXNG
Install with Docker Compose
openclaw-coolify screenshot 1

What is openclaw-coolify?

OpenClaw is a self-hosted AI agent platform that operates on your own hardware and connects to messaging apps like WhatsApp, Telegram, Discord, Slack, and Microsoft Teams. All data and infrastructure stay under your control rather than on external servers. The system uses a multi-agent design where a gateway process launches isolated Docker sandboxes for demanding tasks such as coding, research, and file handling. It provides a persistent workspace volume, SQLite-backed conversation memory, and a built-in SearXNG search engine. Capabilities can be extended by installing skills from the ClawHub registry. Security measures include a token-gated dashboard, device pairing approval, a restricted Docker socket proxy, and integration with Bitwarden and Pass for secret storage. Cloudflare Tunnel creates public URLs without port forwarding. The Coolify edition installs with a single click via docker-compose.

Should you self-host openclaw-coolify?

openclaw-coolify scores 43/100 on selfhost.directory (how scoring works) and ranks #153 of 209 in AI Agents. It has 154 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is advanced: plan for several services and some ongoing maintenance. It is written mostly in Shell.

Its closest alternative on selfhost.directory is Orca (91/100, 108 642 stars). It scores higher overall, so compare the two before you pick. See openclaw-coolify vs Orca side by side.

Features

  • Chat app integrations
  • Conversation memory
  • Multi-Agent Orchestration
  • Persistent workspace
  • Pre-installed Development Tools
  • Private web search
  • Research tools
  • Secure credential management
  • Skill registry (ClawHub)
  • Token-protected dashboard
  • Universal web scraper

openclaw-coolify README

How to install openclaw-coolify

Install openclaw-coolify with Docker Compose

  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.

Once the container is running and healthy:

  1. Access the Dashboard:
    • Open the Service Logs in Coolify.
    • Look for: 🦞 OPENCLAW READY.
    • You will see a Dashboard URL with a token (e.g., https://.../?token=xyz).
    • Click that link to access your OpenClaw Gateway UI.
  2. Approve Your Device:
    • You will see an "Unauthorized" or pairing screen (this is normal).
    • Open the Service Terminal in Coolify.
    • Run: openclaw-approve
  3. Guided Onboarding: To configure your agent's personality and skills:
    • In the terminal, run: openclaw onboard
    • Follow the interactive wizard.
  4. Configure Channels: Go to the Channels tab in the dashboard to link WhatsApp, Telegram, etc.

One-click deployment via Coolify template

How to configure openclaw-coolify

  • ANTHROPIC_API_KEYAnthropic Claude API key

    Anthropic Claude API key

  • CF_TUNNEL_TOKENCloudflare Tunnel token for public access

    Cloudflare Tunnel token for public access

  • CHOKIDAR_USEPOLLINGtrueUse polling for file watching

    Use polling for file watching

  • ELEVENLABS_API_KEYElevenLabs API key for text-to-speech

    ElevenLabs API key for text-to-speech

  • GATEWAY_TRUSTED_PROXIES*Trusted proxies for gateway

    Trusted proxies for gateway

  • GEMINI_API_KEYGoogle Gemini/AI Studio API key

    Google Gemini/AI Studio API key

  • GITHUB_EMAILGitHub email for git operations

    GitHub email for git operations

  • GITHUB_TOKENGitHub personal access token

    GitHub personal access token

  • GITHUB_USERNAMEGitHub username

    GitHub username

  • GOOGLE_MAPS_API_KEYGoogle Maps API key for location features

    Google Maps API key for location features

  • KIMI_API_KEYKimi CLI API key

    Kimi CLI API key

  • MINIMAX_API_KEYMiniMax M2.1 API key

    MiniMax M2.1 API key

  • NANOBANANA_API_KEYNanoBanana API key

    NanoBanana API key

  • NODE_ENVproductionNode.js environment mode

    Node.js environment mode

  • OPENAI_API_KEYOpenAI API key for Codex/GPT models

    OpenAI API key for Codex/GPT models

  • OPENCLAW_AUTO_BOOTSTRAP1Auto-run bootstrap on startup

    Auto-run bootstrap on startup

  • OPENCLAW_BETAfalseEnable beta version of OpenClaw

    Enable beta version of OpenClaw

    values: true, false

  • OPENCLAW_GATEWAY_BINDlanGateway bind address

    Gateway bind address

  • OPENCLAW_GATEWAY_PORT18789Gateway port

    Gateway port

  • OPENCLAW_PRINT_ACCESS1Print access URL to logs

    Print access URL to logs

  • OPENCLAW_STATE_DIR/data/.openclawDirectory for OpenClaw state

    Directory for OpenClaw state

  • OPENCLAW_WORKSPACE/data/openclaw-workspaceWorkspace directory for agent files

    Workspace directory for agent files

  • OPENCODE_API_KEYOpenCode AI API key

    OpenCode AI API key

  • PORT18789Port for the OpenClaw gateway

    Port for the OpenClaw gateway

  • SANDBOX_CONTAINERfalseEnable sandbox container mode

    Enable sandbox container mode

    values: true, false

  • TELEGRAM_BOT_TOKENTelegram bot token from BotFather

    Telegram bot token from BotFather

  • VERCEL_ORG_IDVercel organization ID

    Vercel organization ID

  • VERCEL_PROJECT_IDVercel project ID

    Vercel project ID

  • VERCEL_TOKENVercel deployment token

    Vercel deployment token

FAQ

What does the `minimax-portal-auth` warning mean?

This is a known warning from an optional plugin that does not affect the agent's core functionality and can be safely ignored.

How do I connect from my Mac/PC?

Use the public URL generated by Coolify (e.g., `https://openclaw.my-server.com`). Do not try to connect directly to the server IP and port 18789 unless you manually opened that port in your firewall.

Why do I get "No available server" or "502 Bad Gateway" on Coolify?

Ensure docker-compose.yaml has `expose: ["18789"]` and check logs for `OpenClaw listening on 18789`. The gateway must listen on `0.0.0.0` or `lan`, not `127.0.0.1`.

How much disk space do I need on my Coolify server?

Approximately 13 GB of free space is required for the Docker build cache during installation.

How do I install extra tools like nmap or ffmpeg?

Don't edit the Dockerfile. Use Skills instead — create a skill folder with a SKILL.md instructing the agent to install the tool, or install a pre-made skill like `clawhub install web-utils`.

More in Chat

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…