MMCPMarkets
TO

tuanminhhole/openclaw-setup

Developer tools
199 stars 품질 55 트렌드 55
Repository Install

Run one command → open the dashboard → your bot is live. Windows · macOS · Linux · VPS — Docker-powered, auto-installed for you.

개요

Run one command → open the dashboard → your bot is live. Windows · macOS · Linux · VPS — Docker-powered, auto-installed for you.

README

🆕 What’s New in v5.16.0

  • 🖥️ “Control PC” — let the bot open Chrome & apps on your machine: a new toggle on each bot card turns on the ability for the bot to open Chrome or an allow-listed app (TeamViewer, Zalo, …) on the computer running it. Off by default, token-gated, allow-list only, desktop-only.
  • 🌐 Browsing works out of the box on every OS: the bot drives your real Chrome on a desktop (your logged-in profile, so sites don’t flag it) and starts its own headless Chromium on a server — no more “no browser available” just because Chrome wasn’t running.

✨ Features

  • 🤖 Multi-Channel — Telegram (single or multi-bot relay), Zalo Bot API, Zalo Personal, and Facebook Messenger (Discord & Lark coming soon).
  • 🧑‍🤝‍🧑 Multi-Bot Team — Run multiple Telegram/Zalo bots simultaneously with synchronized workspaces and teamwork.
  • 🧠 Unified AI Routing via 9Router — Easily route messages to Google Gemini, Claude, GPT-4o, OpenRouter, and Ollama (local offline models).
  • 🧩 Built-in Skills — Web Search, Browser Automation (Chrome CDP), and Cron/Scheduler tasks.
  • 🔌 Integrated Marketplace — Install advanced plugins (like openclaw-zalo-mod, Facebook Crawler…) with a single click.
  • 🔀 9Router Integration — Open-source OAuth-based AI proxy that gets you up and running for free without individual API keys.
  • 🔒 Safe & Private — All configurations and API keys are stored locally on your own machine.

🗺️ Quick Start

Open your terminal and run this single command (works on macOS, Linux & Windows — needs Node.js 24 LTS):

npx create-openclaw-bot

It downloads the wizard, starts the local server, and opens the Setup UI in your browser at http://127.0.0.1:51789.

2️⃣ Method 2 — Run the newest GitHub source

Use this if you specifically want the newest code directly from GitHub:

npx github:tuanminhhole/openclaw-setup

Git is required for this method. Install Git and make sure the git command works in your terminal first; otherwise npm cannot download the GitHub repository.

3️⃣ Method 3 — Manual clone (for developers)

For contributors who want the full source. Run each line in order:

git clone https://github.com/tuanminhhole/openclaw-setup.git
cd openclaw-setup
npm install
npm start

Then open http://127.0.0.1:51789 if the browser doesn’t open by itself.

⚠️ npm install / npm start only work inside the cloned openclaw-setup folder. If you used either npx method, simply run the same npx command again when you want to reopen Setup.

🔁 Reopen the UI later

Run the recommended command again. Setup detects and reopens your existing project:

npx create-openclaw-bot

⬆️ Update to the newest version

Click Update in the top-right corner of the Setup interface. It downloads the newest version and restarts the UI automatically; the current browser tab reconnects on its own.

📋 System Prerequisites

  • Node.js 24 LTS (required) — the Setup wizard itself runs on Node, so it’s needed for both Docker and Native modes. Download Node.js.
  • Git: Installed and available in your environment PATH.
  • Docker Desktop (recommended, for the bot runtime): Docker Compose V2. Download Docker.

🚀 Step-by-step Setup Guide

First time? Follow these in order — no terminal needed beyond opening the UI.

1. Open the Setup UI — run the install command above; the dashboard opens in your browser.

2. Pick OS & run mode — first make sure Node.js 24 LTS is installed (the wizard runs on Node — needed for both modes). Then open the Setup tab, choose your OS and the run mode:

  • Docker (recommended) — isolated, and lets you create multiple projects/bots. Also install Docker Desktop.
  • Native — lighter, runs the bot directly on the host (no Docker needed).

3. Project path & name — enter a folder path and a project name (example name: bot), then click Install. Example paths:

  • Windows: D:\bot
  • macOS: /Users//bot
  • Linux: /home//bot

4. Log in to 9Router — click Open 9Router website, then log in with the default password 123456.

5. Create an API key (9Router) — in Endpoints, create a new API key. Then open your project folder → openclaw.json → scroll to the models section → paste the key into the empty apiKey field and save.

6. Connect a provider (9Router) — go to Providers, pick the provider you want; it connects automatically.

7. Create the routing combo (9Router) — go to Combos, create a combo named exactly smart-route and add the models it should route to.

8. Create your bot — back in the Setup UI, choose a channel, fill in the bot info + your personal info, then click Create bot.

9. Restart & test — restart the bot container, then message your bot to test it. 🎉

🧠 Supported AI Providers (via 9Router)

🔌 Supported Channels

  • Telegram: Acquire your official Bot Token from @BotFather.
  • Zalo Bot API: Obtain credentials from developers.zalo.me.
  • Zalo Personal: Scan the QR authorization image displayed on the OpenClaw Dashboard.
  • Facebook Messenger: Via the fb-messenger plugin (public on ClawHub, installable from the Setup UI) — just provide a Page token.
  • Discord: Coming soon.
  • Lark: Coming soon.

📁 Repository Structure

openclaw-setup/
|-- README.md                ← English documentation (You are here)
|-- README.vi.md             ← Vietnamese documentation
|-- package.json             ← NPM entry and runner scripts
|-- dist/                    ← Compiled Web UI and CLI bundles
`-- src/                     ← Source code (UI, local API backend, build tools)

❓ FAQ

🔗 Useful Links

⭐ Repository Stars

🙏 Acknowledgments

  • OpenClaw — Core AI Gateway framework
  • 9Router — Open-source AI proxy (OAuth-based, no API keys)
  • ClawHub — Bot skills registry
  • TheSVG — High-quality SVG brand icons

🙌 Author & Contributing

Built by tuanminhhole (Kent) as an open gift for the community. Suggestions and PRs are always welcome. If this saved you time, please ⭐ the repo so more people can find it!

🦞 OpenClaw Ecosystem (same author)

Companion repos to build a complete, self-running AI assistant:

🚀 Setup & framework

  • openclaw-setup — (this repo) Set up free AI bots with OpenClaw + 9Router (Telegram/Zalo/Messenger, Docker)
  • vietbrain — Vietnamese “Second Brain” framework for Obsidian (AI-ready)

🔌 Plugins (runtime)

🧩 Skills

View this README on GitHub

추천 도구

다른 키워드를 입력하거나 필터를 제거해 보세요.

설치

npx skillfish add tuanminhhole/openclaw-setup