A fully dockerized, plug-and-play local AI agent powered by OpenClaw and OpenAI, featuring instant Telegram bot integration and a secure web dashboard.
Who is this for?
This repository is perfect for several types of users:
AI Tinkerers & Local First Advocates
Why: People who prefer their AI agents, prompts, and memory to be hosted locally and securely on their own hardware rather than relying on a third-party managed platform.
Automation Enthusiasts
Why: Anyone who wants their own 24/7 personal Telegram AI assistant but doesn't want to deal with complex webhooks, ngrok tunnels, or deploying code to the cloud.
OpenClaw Beginners & Developers
Why: Developers who want to test out the OpenClaw framework and dashboard without dealing with local Node.js version conflicts, npm installs, or environment variable headaches. Docker ensures it "just works" out of the box.
Homelabbers & Self-Hosters
Why: People running local servers, a Raspberry Pi, or a NAS setup (like Proxmox or Unraid). The single
docker-compose.yml
file makes it incredibly easy to spin up and keep alive 24/7.
OpenClaw Docker Agent is a complete, containerized solution for running your own personal AI assistant quickly and securely on your local machine. This repository provides a seamless docker-compose setup that packages the OpenClaw agent inside a lightweight Node.js environment.
With zero complicated local environment setup, it exposes a powerful native web dashboard for direct interaction and management. Furthermore, the environment is pre-configured to easily link with Telegram, allowing your agent to respond instantly to direct messages out of the box. All configuration and agent memory are persistently saved to your local machine using Docker volumes. Whether you want to tinker with local AI web controllers, build an automated Telegram assistant, or learn how to orchestrate AI integrations through OpenClaw, this template is the perfect, secure launchpad.
Technologies
Docker & Docker ComposeNode.js (v22 Alpine)OpenClawOpenAI APITelegram Bot API
Key features
🐳 Instant Deployment: Spin up your AI agent with a single docker compose up -d --build command.
💬 Seamless Telegram Integration: Pre-configured DM policies allow your agent to immediately interact with users natively on Telegram without tedious webhooks.
🎛️ Local Control Dashboard: A built-in, locally hosted web UI accessible on localhost:3000 to chat with your agent, view logs, and tweak configurations.
🔐 Secure Device Pairing: Enterprise-grade security mechanism that enforces explicit terminal-level approval for any browser attempting to access the dashboard.
💾 Persistent Agent Memory: All session data, agent memory, and gateway configurations are preserved safely on your host machine inside the claw-data volume.
🌐 LAN Enabled Gateway: Configured to safely expose the OpenClaw Gateway on port 18789, enabling advanced local area networking and cross-device controls.
Who is this for?
This repository is perfect for several types of users:
AI Tinkerers & Local First Advocates
Why: People who prefer their AI agents, prompts, and memory to be hosted locally and securely on their own hardware rather than relying on a third-party managed platform.
Automation Enthusiasts
Why: Anyone who wants their own 24/7 personal Telegram AI assistant but doesn't want to deal with complex webhooks, ngrok tunnels, or deploying code to the cloud.
OpenClaw Beginners & Developers
Why: Developers who want to test out the OpenClaw framework and dashboard without dealing with local Node.js version conflicts, npm installs, or environment variable headaches. Docker ensures it "just works" out of the box.
Homelabbers & Self-Hosters
Why: People running local servers, a Raspberry Pi, or a NAS setup (like Proxmox or Unraid). The single
docker-compose.yml
file makes it incredibly easy to spin up and keep alive 24/7.
