create-openclaw-bot 5.17.1 → 5.17.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -2,12 +2,12 @@
2
2
 
3
3
  # 🦞 OpenClaw Setup
4
4
 
5
- ### One **Web UI** to scaffold, deploy & run free multi-bot AI assistants zero terminal required
5
+ ### One **Web UI** to scaffold, deploy & run free multi-bot AI assistants - zero terminal required
6
6
 
7
- *Run one command → open the dashboard → your bot is live. Windows, macOS, Linux, VPS Docker-powered, auto-installed for you.*
7
+ *Run one command → open the dashboard → your bot is live. Windows, macOS, Linux, VPS - Docker-powered, auto-installed for you.*
8
8
 
9
9
  <p align="center">
10
- <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.17.1-0EA5E9?style=for-the-badge" alt="Version 5.17.1" /></a>
10
+ <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.17.3-0EA5E9?style=for-the-badge" alt="Version 5.17.3" /></a>
11
11
  <a href="https://github.com/tuanminhhole/openclaw-setup?tab=MIT-1-ov-file"><img src="https://img.shields.io/badge/LICENSE-MIT-success?style=for-the-badge" alt="MIT License" /></a>
12
12
  <a href="https://www.npmjs.com/package/create-openclaw-bot"><img src="https://img.shields.io/npm/v/create-openclaw-bot?style=for-the-badge&label=CLI&color=2563EB&logo=npm&logoColor=white" alt="NPM Version" /></a>
13
13
  <a href="https://github.com/tuanminhhole/openclaw-setup/stargazers"><img src="https://img.shields.io/github/stars/tuanminhhole/openclaw-setup?style=for-the-badge&color=eab308&logo=github&logoColor=white" alt="GitHub Stars" /></a>
@@ -15,7 +15,7 @@
15
15
 
16
16
  [![Tiếng Việt](https://flagcdn.com/20x15/vn.png) Tiếng Việt](README.vi.md) · ![English](https://flagcdn.com/20x15/gb.png) **English**
17
17
 
18
- > 💡 Open-source & free. A management dashboard that automates 100% of project scaffolding, deployment, and control for AI bots on **Telegram · Zalo · Facebook Messenger** (Discord & Lark soon) set up in minutes, no coding needed.
18
+ > 💡 Open-source & free. A management dashboard that automates 100% of project scaffolding, deployment, and control for AI bots on **Telegram · Zalo · Facebook Messenger** (Discord & Lark soon) - set up in minutes, no coding needed.
19
19
 
20
20
  <p align="center" style="margin: 24px 0;">
21
21
  <img src="https://raw.githubusercontent.com/tuanminhhole/openclaw-setup/main/docs/openclaw-setup.png" alt="OpenClaw Setup" width="90%" style="border-radius: 8px; border: 1px solid #333; margin-bottom: 16px;" />
@@ -37,7 +37,7 @@
37
37
 
38
38
  ---
39
39
 
40
- ## 🆕 What's New in v5.17.1
40
+ ## 🆕 What's New in v5.17.3
41
41
 
42
42
  - 🩹 **Native installs on OpenClaw 2026.8 are smooth from the first run** - this wave patches the remaining chain of issues measured on fresh customer machines: generated configs pass the new strict checks 100%, install steps run in the right order, and restarts/plugin installs no longer get blocked midway.
43
43
  - 🔑 **9Router login works on Docker**: the new 9Router blocks the default password for "remote" access - and inside Docker every request counts as remote, so 123456 could never log in. It works now (still change the password once you're in).
@@ -59,7 +59,7 @@
59
59
  <summary><b>Previous: What's new in v5.15.3</b></summary>
60
60
 
61
61
  - 🖥️ **"Control PC" - let the bot use your machine**: a toggle on each bot card lets the bot take screenshots, move the mouse, click, type and drag on the computer running it, using OpenClaw's own computer tool. Because it operates the machine the way a person would, it can open any installed application - including one installed yesterday - with no app list to maintain. **Off by default**, and only on a machine with a screen.
62
- - 🌐 **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.
62
+ - 🌐 **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.
63
63
 
64
64
  </details>
65
65
 
@@ -73,22 +73,22 @@
73
73
  <details>
74
74
  <summary><b>Previous: What's new in v5.14.0</b></summary>
75
75
 
76
- - 🛠️ **Bots build their own skills**: ask your bot for a reusable capability ("make me a skill for X") and it writes the skill and puts it to work in the same reply no approval step, no config editing. The skill is saved to `skills/<name>/SKILL.md` in the bot's workspace and loads itself. **Existing bots pick this up automatically on update.**
76
+ - 🛠️ **Bots build their own skills**: ask your bot for a reusable capability ("make me a skill for X") and it writes the skill and puts it to work in the same reply - no approval step, no config editing. The skill is saved to `skills/<name>/SKILL.md` in the bot's workspace and loads itself. **Existing bots pick this up automatically on update.**
77
77
 
78
78
  </details>
79
79
 
80
80
  <details>
81
81
  <summary><b>Previous: What's new in v5.13.9</b></summary>
82
82
 
83
- - 🧠 **Always-on memory for every bot (learning-memory)**: a new context-engine plugin injects your curated `MEMORY.md` + `USER.md` into **every** turn including group chats, which the default recall skips. Bots stop forgetting context and rules over time: no more chiming in when nobody called them, or re-asking things you already told them. Auto-installed for new bots + a 1-click card in the dashboard.
84
- - 🧹 **Retired TencentDB Agent Memory** in favor of the always-on engine above (no external service needed). Existing bots are auto-migrated on update the old learning-memory *skill* and the TencentDB plugin are removed automatically.
83
+ - 🧠 **Always-on memory for every bot (learning-memory)**: a new context-engine plugin injects your curated `MEMORY.md` + `USER.md` into **every** turn - including group chats, which the default recall skips. Bots stop forgetting context and rules over time: no more chiming in when nobody called them, or re-asking things you already told them. Auto-installed for new bots + a 1-click card in the dashboard.
84
+ - 🧹 **Retired TencentDB Agent Memory** in favor of the always-on engine above (no external service needed). Existing bots are auto-migrated on update - the old learning-memory *skill* and the TencentDB plugin are removed automatically.
85
85
 
86
86
  </details>
87
87
 
88
88
  <details>
89
89
  <summary><b>Previous: What's new in v5.13.4</b></summary>
90
90
 
91
- - ⚙️ **New Settings page**: pick your theme (light/dark toggle), language (VI/EN) and timezone right from the dashboard available in both the sidebar and the mobile nav bar.
91
+ - ⚙️ **New Settings page**: pick your theme (light/dark toggle), language (VI/EN) and timezone right from the dashboard - available in both the sidebar and the mobile nav bar.
92
92
  - 🕒 **Schedules & cron run in the correct local time**: newly created bots carry an explicit timezone, so reminders/cron no longer drift a day off around midnight (a UTC-vs-local bug that could schedule into the past). Scheduling guidance was hardened end-to-end (local time + timezone, explicit delivery target, raw group id).
93
93
 
94
94
  </details>
@@ -114,15 +114,15 @@
114
114
  <details>
115
115
  <summary><b>Previous: What's new in v5.11.1</b></summary>
116
116
 
117
- - 📄 **Workspace defaults, rebuilt on OpenClaw's canonical files**: new bots get all 7 upstream default workspace files (`AGENTS`/`BOOTSTRAP`/`HEARTBEAT`/`IDENTITY`/`SOUL`/`TOOLS`/`USER.md`) as the base, with this project's extra rules appended as clearly-marked add-ons VI + EN, every bot variant.
118
- - 🗄️ **SQLite "disk I/O error" on Docker Desktop fixed**: `.openclaw/state` now lives in a named volume on macOS/Windows (WAL locking doesn't survive virtiofs); Linux/VPS keeps the bind mount.
117
+ - 📄 **Workspace defaults, rebuilt on OpenClaw's canonical files**: new bots get all 7 upstream default workspace files (`AGENTS`/`BOOTSTRAP`/`HEARTBEAT`/`IDENTITY`/`SOUL`/`TOOLS`/`USER.md`) as the base, with this project's extra rules appended as clearly-marked add-ons - VI + EN, every bot variant.
118
+ - 🗄️ **SQLite "disk I/O error" on Docker Desktop - fixed**: `.openclaw/state` now lives in a named volume on macOS/Windows (WAL locking doesn't survive virtiofs); Linux/VPS keeps the bind mount.
119
119
 
120
120
  </details>
121
121
 
122
122
  <details>
123
123
  <summary><b>Previous: What's new in v5.11.0</b></summary>
124
124
 
125
- - 🚀 **Facebook Messenger, 1-click**: the `fb-messenger` plugin is now **public on ClawHub** and installs straight from the dashboard create a Messenger bot, open **Bot → Plugins**, and hit **Install** on the `openclaw-fb-messenger` card. Webhook + Graph API, auto User→Page token, HMAC verify.
125
+ - 🚀 **Facebook Messenger, 1-click**: the `fb-messenger` plugin is now **public on ClawHub** and installs straight from the dashboard - create a Messenger bot, open **Bot → Plugins**, and hit **Install** on the `openclaw-fb-messenger` card. Webhook + Graph API, auto User→Page token, HMAC verify.
126
126
  - 🐳 **Docker-only, rock-solid**: dropped the native (non-Docker) install path to focus on the Docker flow that runs flawlessly and stably across Windows / macOS / Linux / VPS, with cross-OS Docker auto-install.
127
127
  - 🖥️ **Chrome-debug on headless VPS**: the browser-automation Chrome-debug relay now works on a headless VPS (bridge-IP-scoped, auto-opens ufw); the bot file editor also saves non-`.md` text files.
128
128
 
@@ -132,10 +132,10 @@
132
132
  <summary><b>Previous: What's new in v5.10.1</b></summary>
133
133
 
134
134
  - 🔧 **Docker fixes**: plugin updates keep the zalo-mod dashboard port, and granted disk/folder mounts (including whole Windows drives like `D:\`) now survive a rebuild instead of being dropped.
135
- - 🔄 **Native auto-restart (process supervision)**: native installs now register the gateway + 9router as OS services (macOS launchd, Linux systemd, Windows detached) that restart on crash/reboot mirroring Docker's `restart: always`. Best-effort, falls back to a plain detached process.
136
- - 🔐 **9router first-install sync fixed**: no longer permanently disables "Require login". The generated `sync.js` logs in with 9router's default password `123456`, builds the `smart-route` combo from active providers **once**, then stops. Require login stays ON (change the password later); `/v1` model calls are unaffected.
137
- - 📁 **Native workspace path fixed**: agent `workspace` is now relative, so persona/memory/skills resolve correctly on native installs (previously a container-absolute path pointing nowhere on the host).
138
- - 🧩 **Config `meta` no longer clobbered**: the generator stops seeding `meta`, so OpenClaw owns it prevents config parse failures from a version-range `lastTouchedVersion`.
135
+ - 🔄 **Native auto-restart (process supervision)**: native installs now register the gateway + 9router as OS services (macOS launchd, Linux systemd, Windows detached) that restart on crash/reboot - mirroring Docker's `restart: always`. Best-effort, falls back to a plain detached process.
136
+ - 🔐 **9router first-install sync - fixed**: no longer permanently disables "Require login". The generated `sync.js` logs in with 9router's default password `123456`, builds the `smart-route` combo from active providers **once**, then stops. Require login stays ON (change the password later); `/v1` model calls are unaffected.
137
+ - 📁 **Native workspace path - fixed**: agent `workspace` is now relative, so persona/memory/skills resolve correctly on native installs (previously a container-absolute path pointing nowhere on the host).
138
+ - 🧩 **Config `meta` no longer clobbered**: the generator stops seeding `meta`, so OpenClaw owns it - prevents config parse failures from a version-range `lastTouchedVersion`.
139
139
  - 💅 **Dashboard UI polish**: Bot/Setup hero shortcuts, plugin version badges, cleaner feature-toggle layout, responsive/mobile fixes, and no more duplicate page title on the dashboard tab.
140
140
 
141
141
  </details>
@@ -143,12 +143,12 @@
143
143
  <details>
144
144
  <summary><b>Previous: What's new in v5.9.0</b></summary>
145
145
 
146
- - 🧠 **TencentDB Agent Memory 1-click install**: New memory plugin in the UI. A 4-tier (L0L3) layered-memory + context-compression engine that keeps long sessions coherent and **cuts token usage by up to ~61%**. Fully local (SQLite), no API key, Docker-ready.
147
- - ⚡ **Token-lean defaults for every new bot**: Ships with context pruning (cache-TTL) + `safeguard` compaction **cheaper & sharper long conversations** with zero tuning.
146
+ - 🧠 **TencentDB Agent Memory - 1-click install**: New memory plugin in the UI. A 4-tier (L0-L3) layered-memory + context-compression engine that keeps long sessions coherent and **cuts token usage by up to ~61%**. Fully local (SQLite), no API key, Docker-ready.
147
+ - ⚡ **Token-lean defaults for every new bot**: Ships with context pruning (cache-TTL) + `safeguard` compaction - **cheaper & sharper long conversations** with zero tuning.
148
148
  - 🎯 **Per-bot & per-channel Skills/Plugins**: Install/enable/disable a skill for **one bot only** (no more leaking across bots); the panel shows only what fits each channel (Zalo / Telegram / Messenger).
149
- - 📤 **Reliable file sending on Zalo & Telegram**: Bots now know the correct outbound ritual (`media/outbound` + `message` tool) and to use modern formats like `.xlsx` no more "the file won't send".
150
- - 🐳 **One-click Docker controls**: Restart / Rebuild the bot container and grant it disk access (mount any host folder at `/mnt/<name>`, cross-OS) right from the dashboard restart your bot without touching the command line.
151
- - ⚡ **Faster Dashboard & Bot pages**: Runtime/version detection now probes **once** and is cached instead of re-running on every page load bot status dropped from ~4s to ~3ms on repeat loads. Cache auto-invalidates on update/rebuild/restart/install.
149
+ - 📤 **Reliable file sending on Zalo & Telegram**: Bots now know the correct outbound ritual (`media/outbound` + `message` tool) and to use modern formats like `.xlsx` - no more "the file won't send".
150
+ - 🐳 **One-click Docker controls**: Restart / Rebuild the bot container and grant it disk access (mount any host folder at `/mnt/<name>`, cross-OS) right from the dashboard - restart your bot without touching the command line.
151
+ - ⚡ **Faster Dashboard & Bot pages**: Runtime/version detection now probes **once** and is cached instead of re-running on every page load - bot status dropped from ~4s to ~3ms on repeat loads. Cache auto-invalidates on update/rebuild/restart/install.
152
152
 
153
153
  </details>
154
154
 
@@ -183,21 +183,21 @@
183
183
 
184
184
  ## ✨ Features
185
185
 
186
- - 🤖 **Multi-Channel** Telegram (single or multi-bot relay), Zalo Bot API, Zalo Personal, and Facebook Messenger (Discord & Lark coming soon).
187
- - 🧑‍🤝‍🧑 **Multi-Bot Team** Run multiple Telegram/Zalo bots simultaneously with synchronized workspaces and teamwork.
188
- - 🧠 **Unified AI Routing via 9Router** Easily route messages to Google Gemini, Claude, GPT-4o, OpenRouter, and Ollama (local offline models).
189
- - 🧩 **Built-in Skills** Web Search, Browser Automation (Chrome CDP), and Cron/Scheduler tasks.
190
- - 🔌 **Integrated Marketplace** Install advanced plugins (like `openclaw-zalo-mod`, Facebook Crawler...) with a single click.
191
- - 🔀 **9Router Integration** Open-source OAuth-based AI proxy that gets you up and running for free without individual API keys.
192
- - 🔒 **Safe & Private** All configurations and API keys are stored locally on your own machine.
186
+ - 🤖 **Multi-Channel** - Telegram (single or multi-bot relay), Zalo Bot API, Zalo Personal, and Facebook Messenger (Discord & Lark coming soon).
187
+ - 🧑‍🤝‍🧑 **Multi-Bot Team** - Run multiple Telegram/Zalo bots simultaneously with synchronized workspaces and teamwork.
188
+ - 🧠 **Unified AI Routing via 9Router** - Easily route messages to Google Gemini, Claude, GPT-4o, OpenRouter, and Ollama (local offline models).
189
+ - 🧩 **Built-in Skills** - Web Search, Browser Automation (Chrome CDP), and Cron/Scheduler tasks.
190
+ - 🔌 **Integrated Marketplace** - Install advanced plugins (like `openclaw-zalo-mod`, Facebook Crawler...) with a single click.
191
+ - 🔀 **9Router Integration** - Open-source OAuth-based AI proxy that gets you up and running for free without individual API keys.
192
+ - 🔒 **Safe & Private** - All configurations and API keys are stored locally on your own machine.
193
193
 
194
194
  ---
195
195
 
196
196
  ## 🗺️ Quick Start
197
197
 
198
- ### 1️⃣ Method 1 Quick install (Recommended)
198
+ ### 1️⃣ Method 1 - Quick install (Recommended)
199
199
 
200
- Open your terminal and run this single command (works on macOS, Linux & Windows needs Node.js 24 LTS):
200
+ Open your terminal and run this single command (works on macOS, Linux & Windows - needs Node.js 24 LTS):
201
201
 
202
202
  ```bash
203
203
  npx create-openclaw-bot
@@ -205,7 +205,7 @@ npx create-openclaw-bot
205
205
 
206
206
  It downloads the wizard, starts the local server, and opens the Setup UI in your browser at **http://127.0.0.1:51789**.
207
207
 
208
- ### 2️⃣ Method 2 Run the newest GitHub source
208
+ ### 2️⃣ Method 2 - Run the newest GitHub source
209
209
 
210
210
  Use this if you specifically want the newest code directly from GitHub:
211
211
 
@@ -215,7 +215,7 @@ npx github:tuanminhhole/openclaw-setup
215
215
 
216
216
  > **Git is required for this method.** Install [Git](https://git-scm.com/downloads) and make sure the `git` command works in your terminal first; otherwise npm cannot download the GitHub repository.
217
217
 
218
- ### 3️⃣ Method 3 Manual clone (for developers)
218
+ ### 3️⃣ Method 3 - Manual clone (for developers)
219
219
 
220
220
  For contributors who want the full source. Run each line in order:
221
221
 
@@ -246,7 +246,7 @@ Click **Update** in the **top-right corner of the Setup interface**. It download
246
246
 
247
247
  ## 📋 System Prerequisites
248
248
 
249
- - **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](https://nodejs.org/).
249
+ - **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](https://nodejs.org/).
250
250
  - **Git**: Installed and available in your environment PATH.
251
251
  - **Docker Desktop** (recommended, for the bot runtime): Docker Compose V2. [Download Docker](https://www.docker.com/products/docker-desktop/).
252
252
 
@@ -254,30 +254,30 @@ Click **Update** in the **top-right corner of the Setup interface**. It download
254
254
 
255
255
  ## 🚀 Step-by-step Setup Guide
256
256
 
257
- > First time? Follow these in order no terminal needed beyond opening the UI.
257
+ > First time? Follow these in order - no terminal needed beyond opening the UI.
258
258
 
259
- **1. Open the Setup UI** run the install command above; the dashboard opens in your browser.
259
+ **1. Open the Setup UI** - run the install command above; the dashboard opens in your browser.
260
260
 
261
- **2. Pick OS & run mode** first make sure [Node.js 24 LTS](https://nodejs.org/) is installed (the wizard runs on Node needed for **both** modes). Then open the **Setup** tab, choose your OS and the run mode:
262
- - **Docker** (recommended) isolated, and lets you create **multiple projects/bots**. Also install [Docker Desktop](https://www.docker.com/products/docker-desktop/).
263
- - **Native** lighter, runs the bot directly on the host (no Docker needed).
261
+ **2. Pick OS & run mode** - first make sure [Node.js 24 LTS](https://nodejs.org/) is installed (the wizard runs on Node - needed for **both** modes). Then open the **Setup** tab, choose your OS and the run mode:
262
+ - **Docker** (recommended) - isolated, and lets you create **multiple projects/bots**. Also install [Docker Desktop](https://www.docker.com/products/docker-desktop/).
263
+ - **Native** - lighter, runs the bot directly on the host (no Docker needed).
264
264
 
265
- **3. Project path & name** enter a folder path and a project name (example name: `bot`), then click **Install**. Example paths:
265
+ **3. Project path & name** - enter a folder path and a project name (example name: `bot`), then click **Install**. Example paths:
266
266
  - Windows: `D:\bot`
267
267
  - macOS: `/Users/<you>/bot`
268
268
  - Linux: `/home/<you>/bot`
269
269
 
270
- **4. Log in to 9Router** click **Open 9Router website**, then log in with the default password **`123456`**.
270
+ **4. Log in to 9Router** - click **Open 9Router website**, then log in with the default password **`123456`**.
271
271
 
272
- **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.
272
+ **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.
273
273
 
274
- **6. Connect a provider (9Router)** go to **Providers**, pick the provider you want; it connects automatically.
274
+ **6. Connect a provider (9Router)** - go to **Providers**, pick the provider you want; it connects automatically.
275
275
 
276
- **7. Create the routing combo (9Router)** go to **Combos**, create a combo named exactly **`smart-route`** and add the models it should route to.
276
+ **7. Create the routing combo (9Router)** - go to **Combos**, create a combo named exactly **`smart-route`** and add the models it should route to.
277
277
 
278
- **8. Create your bot** back in the Setup UI, choose a channel, fill in the bot info + your personal info, then click **Create bot**.
278
+ **8. Create your bot** - back in the Setup UI, choose a channel, fill in the bot info + your personal info, then click **Create bot**.
279
279
 
280
- **9. Restart & test** restart the bot container, then message your bot to test it. 🎉
280
+ **9. Restart & test** - restart the bot container, then message your bot to test it. 🎉
281
281
 
282
282
  ---
283
283
 
@@ -292,7 +292,7 @@ Click **Update** in the **top-right corner of the Setup interface**. It download
292
292
  - **Telegram**: Acquire your official Bot Token from `@BotFather`.
293
293
  - **Zalo Bot API**: Obtain credentials from [developers.zalo.me](https://developers.zalo.me).
294
294
  - **Zalo Personal**: Scan the QR authorization image displayed on the OpenClaw Dashboard.
295
- - **Facebook Messenger**: Via the `fb-messenger` plugin (public on ClawHub, installable from the Setup UI) just provide a Page token.
295
+ - **Facebook Messenger**: Via the `fb-messenger` plugin (public on ClawHub, installable from the Setup UI) - just provide a Page token.
296
296
  - **Discord**: _Coming soon._
297
297
  - **Lark**: _Coming soon._
298
298
 
@@ -355,10 +355,10 @@ Yes. You can edit the config JSON directly via the integrated File Editor in the
355
355
 
356
356
  ## 🙏 Acknowledgments
357
357
 
358
- - [OpenClaw](https://openclaw.ai) Core AI Gateway framework
359
- - [9Router](https://github.com/decolua/9router) Open-source AI proxy (OAuth-based, no API keys)
360
- - [ClawHub](https://clawhub.com) Bot skills registry
361
- - [TheSVG](https://thesvg.org) High-quality SVG brand icons
358
+ - [OpenClaw](https://openclaw.ai) - Core AI Gateway framework
359
+ - [9Router](https://github.com/decolua/9router) - Open-source AI proxy (OAuth-based, no API keys)
360
+ - [ClawHub](https://clawhub.com) - Bot skills registry
361
+ - [TheSVG](https://thesvg.org) - High-quality SVG brand icons
362
362
 
363
363
  ---
364
364
 
@@ -374,21 +374,21 @@ Suggestions and PRs are always welcome. If this saved you time, please ⭐ the r
374
374
  Companion repos to build a complete, self-running AI assistant:
375
375
 
376
376
  **🚀 Setup & framework**
377
- - [openclaw-setup](https://github.com/tuanminhhole/openclaw-setup) *(this repo)* Set up free AI bots with OpenClaw + 9Router (Telegram/Zalo/Messenger, Docker)
378
- - [vietbrain](https://github.com/tuanminhhole/vietbrain) Vietnamese "Second Brain" framework for Obsidian (AI-ready)
377
+ - [openclaw-setup](https://github.com/tuanminhhole/openclaw-setup) - *(this repo)* Set up free AI bots with OpenClaw + 9Router (Telegram/Zalo/Messenger, Docker)
378
+ - [vietbrain](https://github.com/tuanminhhole/vietbrain) - Vietnamese "Second Brain" framework for Obsidian (AI-ready)
379
379
 
380
380
  **🔌 Plugins (runtime)**
381
- - [openclaw-fb-messenger](https://github.com/tuanminhhole/openclaw-fb-messenger) Facebook Messenger channel (webhook + Graph API), installable from the Setup UI
382
- - [openclaw-telegram-multibot-relay](https://github.com/tuanminhhole/openclaw-telegram-multibot-relay) Multibot Telegram relay, delegation & native cron reminders
383
- - [openclaw-zalo-connect](https://github.com/tuanminhhole/openclaw-zalo-connect) Personal Zalo channel/runtime with QR login, native mentions and group actions
384
- - [openclaw-zalo-mod](https://github.com/tuanminhhole/openclaw-zalo-mod) Zero-token Zalo group management (slash commands, anti-spam, warn, memory)
385
- - [openclaw-browser-automation](https://github.com/tuanminhhole/openclaw-browser-automation) Smart Search & Browser Automation
386
- - [openclaw-facebook-crawler](https://github.com/tuanminhhole/openclaw-facebook-crawler) Facebook data crawler
387
- - [openclaw-n8n-facebook-poster](https://github.com/tuanminhhole/openclaw-n8n-facebook-poster) Auto-post to Facebook via n8n
381
+ - [openclaw-fb-messenger](https://github.com/tuanminhhole/openclaw-fb-messenger) - Facebook Messenger channel (webhook + Graph API), installable from the Setup UI
382
+ - [openclaw-telegram-multibot-relay](https://github.com/tuanminhhole/openclaw-telegram-multibot-relay) - Multibot Telegram relay, delegation & native cron reminders
383
+ - [openclaw-zalo-connect](https://github.com/tuanminhhole/openclaw-zalo-connect) - Personal Zalo channel/runtime with QR login, native mentions and group actions
384
+ - [openclaw-zalo-mod](https://github.com/tuanminhhole/openclaw-zalo-mod) - Zero-token Zalo group management (slash commands, anti-spam, warn, memory)
385
+ - [openclaw-browser-automation](https://github.com/tuanminhhole/openclaw-browser-automation) - Smart Search & Browser Automation
386
+ - [openclaw-facebook-crawler](https://github.com/tuanminhhole/openclaw-facebook-crawler) - Facebook data crawler
387
+ - [openclaw-n8n-facebook-poster](https://github.com/tuanminhhole/openclaw-n8n-facebook-poster) - Auto-post to Facebook via n8n
388
388
 
389
389
  **🧩 Skills**
390
- - [openclaw-learning-memory](https://github.com/tuanminhhole/openclaw-learning-memory) Always-on memory context engine (injects curated MEMORY.md + USER.md into every turn, incl. groups)
391
- - [openclaw-skill-infographic](https://github.com/tuanminhhole/openclaw-skill-infographic) Infographic generation
390
+ - [openclaw-learning-memory](https://github.com/tuanminhhole/openclaw-learning-memory) - Always-on memory context engine (injects curated MEMORY.md + USER.md into every turn, incl. groups)
391
+ - [openclaw-skill-infographic](https://github.com/tuanminhhole/openclaw-skill-infographic) - Infographic generation
392
392
 
393
393
  ---
394
394
 
package/README.vi.md CHANGED
@@ -2,12 +2,12 @@
2
2
 
3
3
  # 🦞 OpenClaw Setup
4
4
 
5
- ### Một **giao diện Web** để tạo, triển khai & vận hành trợ lý AI đa bot miễn phí không cần gõ terminal
5
+ ### Một **giao diện Web** để tạo, triển khai & vận hành trợ lý AI đa bot miễn phí - không cần gõ terminal
6
6
 
7
7
  *Chạy một lệnh, mở dashboard, bot lên sóng. Windows, macOS, Linux, VPS. Bot chạy thẳng trên máy, không cần Docker.*
8
8
 
9
9
  <p align="center">
10
- <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.17.1-0EA5E9?style=for-the-badge" alt="Version 5.17.1" /></a>
10
+ <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.17.3-0EA5E9?style=for-the-badge" alt="Version 5.17.3" /></a>
11
11
  <a href="https://github.com/tuanminhhole/openclaw-setup?tab=MIT-1-ov-file"><img src="https://img.shields.io/badge/LICENSE-MIT-success?style=for-the-badge" alt="MIT License" /></a>
12
12
  <a href="https://www.npmjs.com/package/create-openclaw-bot"><img src="https://img.shields.io/npm/v/create-openclaw-bot?style=for-the-badge&label=CLI&color=2563EB&logo=npm&logoColor=white" alt="NPM Version" /></a>
13
13
  <a href="https://github.com/tuanminhhole/openclaw-setup/stargazers"><img src="https://img.shields.io/github/stars/tuanminhhole/openclaw-setup?style=for-the-badge&color=eab308&logo=github&logoColor=white" alt="GitHub Stars" /></a>
@@ -15,7 +15,7 @@
15
15
 
16
16
  ![Tiếng Việt](https://flagcdn.com/20x15/vn.png) **Tiếng Việt** · [![English](https://flagcdn.com/20x15/gb.png) English](README.md)
17
17
 
18
- > 🇻🇳 Mã nguồn mở & miễn phí. Dashboard tự động hóa 100% việc tạo dự án, triển khai và quản lý bot AI trên **Telegram · Zalo · Facebook Messenger** (Discord & Lark sắp ra mắt) cài trong vài phút, không cần biết code.
18
+ > 🇻🇳 Mã nguồn mở & miễn phí. Dashboard tự động hóa 100% việc tạo dự án, triển khai và quản lý bot AI trên **Telegram · Zalo · Facebook Messenger** (Discord & Lark sắp ra mắt) - cài trong vài phút, không cần biết code.
19
19
 
20
20
  <p align="center" style="margin: 24px 0;">
21
21
  <img src="https://raw.githubusercontent.com/tuanminhhole/openclaw-setup/main/docs/openclaw-setup-vi.png" alt="OpenClaw Setup" width="90%" style="border-radius: 8px; border: 1px solid #333; margin-bottom: 16px;" />
@@ -37,7 +37,7 @@
37
37
 
38
38
  ---
39
39
 
40
- ## 🆕 Có gì mới trong v5.17.1
40
+ ## 🆕 Có gì mới trong v5.17.3
41
41
 
42
42
  - 🩹 **Cài native trên OpenClaw 2026.8 mượt từ phát đầu** - đợt này vá nốt chuỗi lỗi đo được khi dựng máy khách mới: cấu hình sinh ra sạch 100% với bộ soát khắt khe của OpenClaw mới, các bước cài tự chạy đúng thứ tự, và mọi thao tác khởi động lại/cài plugin không còn bị chặn giữa chừng.
43
43
  - 🔑 **Đăng nhập 9Router hoạt động trên Docker**: bản 9Router mới chặn mật khẩu mặc định với truy cập "từ xa" - mà trong Docker thì mọi truy cập đều bị tính là từ xa, nên trước đây không cách nào vào được bằng 123456. Giờ đăng nhập bình thường (vào rồi vẫn nên đổi mật khẩu).
@@ -59,7 +59,7 @@
59
59
  <summary><b>Trước đó: Có gì mới trong v5.15.3</b></summary>
60
60
 
61
61
  - 🖥️ **"Điều khiển máy" - cho bot dùng máy của bạn**: nút trên thẻ mỗi bot, bật lên là bot chụp được màn hình, rê chuột, bấm, gõ phím và kéo thả trên máy đang chạy bot, bằng chính công cụ computer của OpenClaw. Vì nó thao tác như người ngồi trước máy nên mở được mọi ứng dụng đang cài, kể cả app vừa cài hôm qua, không cần khai báo danh sách. **Mặc định TẮT**, và chỉ dùng trên máy có màn hình.
62
- - 🌐 **Duyệt web chạy ngay trên mọi hệ điều hành**: máy để bàn thì bot dùng **Chrome thật** (profile đã đăng nhập, web ít nghi là bot), server thì tự mở Chromium headless hết cảnh "không có trình duyệt" chỉ vì chưa mở Chrome.
62
+ - 🌐 **Duyệt web chạy ngay trên mọi hệ điều hành**: máy để bàn thì bot dùng **Chrome thật** (profile đã đăng nhập, web ít nghi là bot), server thì tự mở Chromium headless - hết cảnh "không có trình duyệt" chỉ vì chưa mở Chrome.
63
63
 
64
64
  </details>
65
65
 
@@ -73,22 +73,22 @@
73
73
  <details>
74
74
  <summary><b>Trước đó: Có gì mới trong v5.14.0</b></summary>
75
75
 
76
- - 🛠️ **Bot tự tạo skill cho chính nó**: nhờ bot làm một kỹ năng dùng lại ("tạo cho anh skill X") là nó viết xong và dùng được ngay trong cùng câu trả lời không còn bước chờ duyệt, không phải sửa cấu hình. Skill lưu vào `skills/<tên>/SKILL.md` trong workspace của bot và tự nạp. **Bot cũ tự nhận khi cập nhật.**
76
+ - 🛠️ **Bot tự tạo skill cho chính nó**: nhờ bot làm một kỹ năng dùng lại ("tạo cho anh skill X") là nó viết xong và dùng được ngay trong cùng câu trả lời - không còn bước chờ duyệt, không phải sửa cấu hình. Skill lưu vào `skills/<tên>/SKILL.md` trong workspace của bot và tự nạp. **Bot cũ tự nhận khi cập nhật.**
77
77
 
78
78
  </details>
79
79
 
80
80
  <details>
81
81
  <summary><b>Trước đó: Có gì mới trong v5.13.9</b></summary>
82
82
 
83
- - 🧠 **Trí nhớ always-on cho mọi bot (learning-memory)**: plugin context-engine mới nạp `MEMORY.md` + `USER.md` đã chắt lọc vào **MỌI lượt** kể cả trong nhóm (điều recall mặc định bỏ qua). Bot hết quên ngữ cảnh/quy tắc theo thời gian: không còn "nói leo" khi không ai gọi, không hỏi lại điều bạn đã dặn. Tự cài cho bot mới + có card 1-chạm trên dashboard.
84
- - 🧹 **Bỏ TencentDB Agent Memory**, thay bằng engine always-on ở trên (không cần dịch vụ ngoài). Bot cũ tự migrate khi cập nhật *skill* learning-memory cũ và plugin TencentDB được gỡ tự động.
83
+ - 🧠 **Trí nhớ always-on cho mọi bot (learning-memory)**: plugin context-engine mới nạp `MEMORY.md` + `USER.md` đã chắt lọc vào **MỌI lượt** - kể cả trong nhóm (điều recall mặc định bỏ qua). Bot hết quên ngữ cảnh/quy tắc theo thời gian: không còn "nói leo" khi không ai gọi, không hỏi lại điều bạn đã dặn. Tự cài cho bot mới + có card 1-chạm trên dashboard.
84
+ - 🧹 **Bỏ TencentDB Agent Memory**, thay bằng engine always-on ở trên (không cần dịch vụ ngoài). Bot cũ tự migrate khi cập nhật - *skill* learning-memory cũ và plugin TencentDB được gỡ tự động.
85
85
 
86
86
  </details>
87
87
 
88
88
  <details>
89
89
  <summary><b>Trước đó: Có gì mới trong v5.13.4</b></summary>
90
90
 
91
- - ⚙️ **Trang Cài đặt mới**: chọn giao diện (nút gạt Sáng/Tối), ngôn ngữ (VI/EN) và múi giờ ngay trong dashboard có ở cả sidebar lẫn thanh điều hướng mobile.
91
+ - ⚙️ **Trang Cài đặt mới**: chọn giao diện (nút gạt Sáng/Tối), ngôn ngữ (VI/EN) và múi giờ ngay trong dashboard - có ở cả sidebar lẫn thanh điều hướng mobile.
92
92
  - 🕒 **Lịch & cron chạy đúng giờ địa phương**: bot tạo mới nhận múi giờ rõ ràng, nên nhắc hẹn/cron không còn lệch 1 ngày quanh nửa đêm (lỗi UTC-vs-local có thể đặt lịch vào quá khứ). Đã siết hướng dẫn lập lịch toàn diện (giờ local + múi giờ, nơi gửi rõ ràng, ID nhóm dạng thô).
93
93
 
94
94
  </details>
@@ -114,7 +114,7 @@
114
114
  <details>
115
115
  <summary><b>Trước đó: Có gì mới trong v5.11.1</b></summary>
116
116
 
117
- - 📄 **Workspace mặc định dựng lại theo bộ file chuẩn OpenClaw**: bot tạo mới nhận đủ 7 file workspace gốc (`AGENTS`/`BOOTSTRAP`/`HEARTBEAT`/`IDENTITY`/`SOUL`/`TOOLS`/`USER.md`) làm khung, quy tắc riêng của dự án gắn thành mục bổ sung đánh dấu rõ đủ VI + EN, mọi kiểu bot.
117
+ - 📄 **Workspace mặc định dựng lại theo bộ file chuẩn OpenClaw**: bot tạo mới nhận đủ 7 file workspace gốc (`AGENTS`/`BOOTSTRAP`/`HEARTBEAT`/`IDENTITY`/`SOUL`/`TOOLS`/`USER.md`) làm khung, quy tắc riêng của dự án gắn thành mục bổ sung đánh dấu rõ - đủ VI + EN, mọi kiểu bot.
118
118
  - 🗄️ **Hết lỗi SQLite "disk I/O error" trên Docker Desktop**: `.openclaw/state` chuyển sang named volume trên macOS/Windows (khóa WAL không sống nổi qua virtiofs); Linux/VPS vẫn bind mount như cũ.
119
119
 
120
120
  </details>
@@ -122,7 +122,7 @@
122
122
  <details>
123
123
  <summary><b>Trước đó: Có gì mới trong v5.11.0</b></summary>
124
124
 
125
- - 🚀 **Facebook Messenger, cài 1 chạm**: plugin `fb-messenger` giờ đã **public trên ClawHub** và cài ngay trên dashboard tạo bot Messenger, mở **Bot → Plugins**, bấm **Cài** ở thẻ `openclaw-fb-messenger`. Webhook + Graph API, tự đổi User→Page token, xác minh HMAC.
125
+ - 🚀 **Facebook Messenger, cài 1 chạm**: plugin `fb-messenger` giờ đã **public trên ClawHub** và cài ngay trên dashboard - tạo bot Messenger, mở **Bot → Plugins**, bấm **Cài** ở thẻ `openclaw-fb-messenger`. Webhook + Graph API, tự đổi User→Page token, xác minh HMAC.
126
126
  - 🐳 **Chỉ còn Docker, cực ổn định**: loại bỏ kiểu cài native (không Docker) để tập trung cho luồng Docker chạy hoàn hảo & ổn định trên Windows / macOS / Linux / VPS, kèm tự cài Docker đa hệ điều hành.
127
127
  - 🖥️ **Chrome-debug trên VPS headless**: relay Chrome-debug của browser-automation giờ chạy được trên VPS headless (giới hạn theo bridge-IP, tự mở ufw); trình sửa file bot cũng lưu được file text không phải `.md`.
128
128
 
@@ -132,10 +132,10 @@
132
132
  <summary><b>Trước đó: Có gì mới trong v5.10.1</b></summary>
133
133
 
134
134
  - 🔧 **Sửa lỗi Docker**: update plugin giữ nguyên port dashboard zalo-mod, và ổ đĩa/thư mục đã cấp quyền (kể cả nguyên ổ Windows như `D:\`) không còn bị mất sau khi rebuild.
135
- - 🔄 **Tự khởi động lại tiến trình (native)**: cài native giờ đăng ký gateway + 9router thành service hệ điều hành (macOS launchd, Linux systemd, Windows detached), tự chạy lại khi crash/reboot như `restart: always` của Docker. Best-effort, lỗi thì fallback chạy detached.
136
- - 🔐 **Sync 9router lần đầu đã sửa**: không còn tắt vĩnh viễn "Require login". `sync.js` đăng nhập bằng mật khẩu mặc định `123456`, tạo combo `smart-route` từ provider đang active **một lần** rồi dừng. Require login giữ ON (đổi mật khẩu sau); model-call `/v1` không bị ảnh hưởng.
137
- - 📁 **Đường dẫn workspace native đã sửa**: `workspace` của agent giờ là tương đối, persona/memory/skills nằm đúng chỗ khi cài native (trước là đường dẫn tuyệt đối kiểu container → trỏ sai trên host).
138
- - 🧩 **Không ghi đè khối `meta` trong config**: generator ngừng seed `meta` để OpenClaw tự quản tránh lỗi parse config do `lastTouchedVersion` là dải version.
135
+ - 🔄 **Tự khởi động lại tiến trình (native)**: cài native giờ đăng ký gateway + 9router thành service hệ điều hành (macOS launchd, Linux systemd, Windows detached), tự chạy lại khi crash/reboot - như `restart: always` của Docker. Best-effort, lỗi thì fallback chạy detached.
136
+ - 🔐 **Sync 9router lần đầu - đã sửa**: không còn tắt vĩnh viễn "Require login". `sync.js` đăng nhập bằng mật khẩu mặc định `123456`, tạo combo `smart-route` từ provider đang active **một lần** rồi dừng. Require login giữ ON (đổi mật khẩu sau); model-call `/v1` không bị ảnh hưởng.
137
+ - 📁 **Đường dẫn workspace native - đã sửa**: `workspace` của agent giờ là tương đối, persona/memory/skills nằm đúng chỗ khi cài native (trước là đường dẫn tuyệt đối kiểu container → trỏ sai trên host).
138
+ - 🧩 **Không ghi đè khối `meta` trong config**: generator ngừng seed `meta` để OpenClaw tự quản - tránh lỗi parse config do `lastTouchedVersion` là dải version.
139
139
  - 💅 **UI dashboard gọn hơn**: nút tắt Bot/Cài đặt ở hero, badge version plugin, layout toggle tính năng, responsive/mobile, bỏ tiêu đề trùng ở tab dashboard.
140
140
 
141
141
  </details>
@@ -143,12 +143,12 @@
143
143
  <details>
144
144
  <summary><b>Trước đó: Có gì mới trong v5.9.0</b></summary>
145
145
 
146
- - 🧠 **TencentDB Agent Memory cài 1 chạm**: Plugin bộ nhớ mới ngay trên UI. Bộ nhớ phân tầng 4 lớp (L0L3) + nén ngữ cảnh, giữ session dài mạch lạc và **tiết kiệm tới ~61% token**. Chạy local hoàn toàn (SQLite), không cần API key, sẵn sàng cho Docker.
147
- - ⚡ **Cấu hình tiết kiệm token mặc định cho mọi bot mới**: Tự có context pruning (cache-TTL) + compaction `safeguard` **hội thoại dài rẻ hơn & sắc nét hơn**, không cần chỉnh tay.
146
+ - 🧠 **TencentDB Agent Memory - cài 1 chạm**: Plugin bộ nhớ mới ngay trên UI. Bộ nhớ phân tầng 4 lớp (L0-L3) + nén ngữ cảnh, giữ session dài mạch lạc và **tiết kiệm tới ~61% token**. Chạy local hoàn toàn (SQLite), không cần API key, sẵn sàng cho Docker.
147
+ - ⚡ **Cấu hình tiết kiệm token mặc định cho mọi bot mới**: Tự có context pruning (cache-TTL) + compaction `safeguard` - **hội thoại dài rẻ hơn & sắc nét hơn**, không cần chỉnh tay.
148
148
  - 🎯 **Skills/Plugins theo từng bot & từng kênh**: Cài/bật/tắt skill chỉ cho **đúng 1 bot** (không lan sang bot khác); bảng chỉ hiện thứ phù hợp với kênh (Zalo / Telegram / Messenger).
149
- - 📤 **Gửi file ổn định trên Zalo & Telegram**: Bot đã biết quy trình gửi đúng (`media/outbound` + tool `message`) và dùng định dạng hiện đại như `.xlsx` hết cảnh "không gửi được file".
150
- - 🐳 **Nút điều khiển Docker 1 chạm**: Restart / Rebuild container bot và cấp quyền ổ đĩa (mount thư mục host bất kỳ vào `/mnt/<tên>`, đa OS) ngay trên dashboard khởi động lại bot mà không cần gõ lệnh.
151
- - ⚡ **Trang Dashboard & Bot load nhanh hơn**: Việc dò runtime/version giờ chỉ chạy **một lần** rồi cache thay vì lặp lại mỗi lần tải trang bot status giảm từ ~4s xuống ~3ms ở các lần tải sau. Cache tự xoá khi update/rebuild/restart/cài đặt.
149
+ - 📤 **Gửi file ổn định trên Zalo & Telegram**: Bot đã biết quy trình gửi đúng (`media/outbound` + tool `message`) và dùng định dạng hiện đại như `.xlsx` - hết cảnh "không gửi được file".
150
+ - 🐳 **Nút điều khiển Docker 1 chạm**: Restart / Rebuild container bot và cấp quyền ổ đĩa (mount thư mục host bất kỳ vào `/mnt/<tên>`, đa OS) ngay trên dashboard - khởi động lại bot mà không cần gõ lệnh.
151
+ - ⚡ **Trang Dashboard & Bot load nhanh hơn**: Việc dò runtime/version giờ chỉ chạy **một lần** rồi cache thay vì lặp lại mỗi lần tải trang - bot status giảm từ ~4s xuống ~3ms ở các lần tải sau. Cache tự xoá khi update/rebuild/restart/cài đặt.
152
152
 
153
153
  </details>
154
154
 
@@ -183,21 +183,21 @@
183
183
 
184
184
  ## ✨ Tính năng nổi bật
185
185
 
186
- - 🤖 **Đa kênh** Telegram (1 hoặc nhiều bot), Zalo Bot API, Zalo Personal (Cá nhân), và Facebook Messenger (Discord & Lark sắp ra mắt).
187
- - 🧑‍🤝‍🧑 **Đội bot (Multi-bot Team)** Chạy đồng thời nhiều bot Telegram/Zalo, tự động đồng bộ hóa tài liệu và phối hợp làm việc theo nhóm.
188
- - 🧠 **Đa nhà cung cấp AI qua 9Router** Dễ dàng định tuyến đến Google Gemini, Claude, GPT-4o, OpenRouter, Ollama (chạy local offline).
189
- - 🧩 **Kỹ năng (Skills)** Web Search, Browser Automation (Chrome CDP thực tế), Cron/Scheduler lập lịch.
190
- - 🔌 **Plugin tích hợp** Cài đặt nhanh các plugin nâng cao (`openclaw-zalo-mod`, Facebook Crawler...) chỉ bằng 1 nút nhấn trên UI.
191
- - 🔀 **9Router tích hợp** Cầu nối AI proxy miễn phí không cần API key thông qua đăng nhập OAuth.
192
- - 🔒 **An toàn & Riêng tư** Toàn bộ cấu hình và API key chỉ lưu trên thiết bị của bạn.
186
+ - 🤖 **Đa kênh** - Telegram (1 hoặc nhiều bot), Zalo Bot API, Zalo Personal (Cá nhân), và Facebook Messenger (Discord & Lark sắp ra mắt).
187
+ - 🧑‍🤝‍🧑 **Đội bot (Multi-bot Team)** - Chạy đồng thời nhiều bot Telegram/Zalo, tự động đồng bộ hóa tài liệu và phối hợp làm việc theo nhóm.
188
+ - 🧠 **Đa nhà cung cấp AI qua 9Router** - Dễ dàng định tuyến đến Google Gemini, Claude, GPT-4o, OpenRouter, Ollama (chạy local offline).
189
+ - 🧩 **Kỹ năng (Skills)** - Web Search, Browser Automation (Chrome CDP thực tế), Cron/Scheduler lập lịch.
190
+ - 🔌 **Plugin tích hợp** - Cài đặt nhanh các plugin nâng cao (`openclaw-zalo-mod`, Facebook Crawler...) chỉ bằng 1 nút nhấn trên UI.
191
+ - 🔀 **9Router tích hợp** - Cầu nối AI proxy miễn phí không cần API key thông qua đăng nhập OAuth.
192
+ - 🔒 **An toàn & Riêng tư** - Toàn bộ cấu hình và API key chỉ lưu trên thiết bị của bạn.
193
193
 
194
194
  ---
195
195
 
196
196
  ## 🗺️ Cách cài đặt nhanh nhất
197
197
 
198
- ### 1️⃣ Cách 1 Cài nhanh (Khuyên dùng)
198
+ ### 1️⃣ Cách 1 - Cài nhanh (Khuyên dùng)
199
199
 
200
- Mở terminal và chạy đúng một lệnh (chạy trên macOS, Linux & Windows cần Node.js 24 LTS):
200
+ Mở terminal và chạy đúng một lệnh (chạy trên macOS, Linux & Windows - cần Node.js 24 LTS):
201
201
 
202
202
  ```bash
203
203
  npx create-openclaw-bot
@@ -205,7 +205,7 @@ npx create-openclaw-bot
205
205
 
206
206
  Lệnh này tự tải wizard, chạy server và **mở giao diện Setup** trên trình duyệt tại **http://127.0.0.1:51789**.
207
207
 
208
- ### 2️⃣ Cách 2 Chạy mã mới nhất trực tiếp từ GitHub
208
+ ### 2️⃣ Cách 2 - Chạy mã mới nhất trực tiếp từ GitHub
209
209
 
210
210
  Dùng cách này nếu bạn muốn lấy code mới nhất trực tiếp từ GitHub:
211
211
 
@@ -215,7 +215,7 @@ npx github:tuanminhhole/openclaw-setup
215
215
 
216
216
  > **Cách này bắt buộc máy phải cài Git.** Hãy cài [Git](https://git-scm.com/downloads) và kiểm tra lệnh `git` chạy được trong terminal trước; nếu thiếu Git, npm không thể tải repository từ GitHub.
217
217
 
218
- ### 3️⃣ Cách 3 Clone thủ công (dành cho developer)
218
+ ### 3️⃣ Cách 3 - Clone thủ công (dành cho developer)
219
219
 
220
220
  Dành cho người muốn lấy full source. Chạy lần lượt từng dòng:
221
221
 
@@ -249,35 +249,35 @@ Bấm nút **Cập nhật** ở **góc trên bên phải giao diện Setup**. H
249
249
  - **Node.js 24 LTS** (bắt buộc). Cả trình cài đặt lẫn bot đều chạy bằng Node. [Tải Node.js](https://nodejs.org/).
250
250
  Máy chưa có Node thì trình cài đặt tự cài giúp bạn.
251
251
  - **Git**: Đã cài đặt và có trong biến môi trường PATH.
252
- - **Không cần Docker nữa.** Từ bản 5.17.1 bot chạy thẳng trên máy.
252
+ - **Không cần Docker nữa.** Từ bản 5.17.3 bot chạy thẳng trên máy.
253
253
 
254
254
  ---
255
255
 
256
256
  ## 🚀 Hướng dẫn cài đặt từng bước
257
257
 
258
- > Lần đầu dùng? Làm lần lượt theo thứ tự không cần gõ terminal ngoài bước mở giao diện.
258
+ > Lần đầu dùng? Làm lần lượt theo thứ tự - không cần gõ terminal ngoài bước mở giao diện.
259
259
 
260
- **1. Mở giao diện Setup** chạy lệnh cài ở trên, dashboard sẽ mở trên trình duyệt.
260
+ **1. Mở giao diện Setup** - chạy lệnh cài ở trên, dashboard sẽ mở trên trình duyệt.
261
261
 
262
262
  **2. Chọn Hệ điều hành** rồi bấm tiếp. Chế độ chạy giờ chỉ còn **Native**, tức bot chạy thẳng trên máy bạn.
263
263
  Ô Docker vẫn hiện nhưng đã khoá, bấm không được. Lý do ghi ngay trên màn hình.
264
264
 
265
- **3. Nhập đường dẫn & tên project** nhập đường dẫn thư mục và tên project (ví dụ tên: `bot`), rồi bấm **Cài đặt**. Ví dụ đường dẫn:
265
+ **3. Nhập đường dẫn & tên project** - nhập đường dẫn thư mục và tên project (ví dụ tên: `bot`), rồi bấm **Cài đặt**. Ví dụ đường dẫn:
266
266
  - Windows: `D:\bot`
267
267
  - macOS: `/Users/<tên-bạn>/bot`
268
268
  - Linux: `/home/<tên-bạn>/bot`
269
269
 
270
- **4. Đăng nhập 9Router** bấm nút **Mở website 9Router**, đăng nhập bằng mật khẩu mặc định **`123456`**.
270
+ **4. Đăng nhập 9Router** - bấm nút **Mở website 9Router**, đăng nhập bằng mật khẩu mặc định **`123456`**.
271
271
 
272
- **5. Tạo API key (9Router)** vào mục **Endpoints**, tạo một API key mới. Sau đó mở thư mục project → file `openclaw.json` → kéo xuống mục **`models`** → dán key vào ô `apiKey` còn trống rồi lưu.
272
+ **5. Tạo API key (9Router)** - vào mục **Endpoints**, tạo một API key mới. Sau đó mở thư mục project → file `openclaw.json` → kéo xuống mục **`models`** → dán key vào ô `apiKey` còn trống rồi lưu.
273
273
 
274
- **6. Kết nối Provider (9Router)** vào mục **Providers**, chọn provider bạn muốn; hệ thống tự kết nối.
274
+ **6. Kết nối Provider (9Router)** - vào mục **Providers**, chọn provider bạn muốn; hệ thống tự kết nối.
275
275
 
276
- **7. Tạo Combo định tuyến (9Router)** vào mục **Combos**, tạo combo đặt tên **đúng** là **`smart-route`** và thêm các models cần dùng.
276
+ **7. Tạo Combo định tuyến (9Router)** - vào mục **Combos**, tạo combo đặt tên **đúng** là **`smart-route`** và thêm các models cần dùng.
277
277
 
278
- **8. Tạo bot** quay lại giao diện Setup, chọn kênh, nhập thông tin bot + thông tin cá nhân, rồi bấm **Tạo bot**.
278
+ **8. Tạo bot** - quay lại giao diện Setup, chọn kênh, nhập thông tin bot + thông tin cá nhân, rồi bấm **Tạo bot**.
279
279
 
280
- **9. Restart & test** khởi động lại container bot, rồi nhắn tin cho bot để kiểm tra. 🎉
280
+ **9. Restart & test** - khởi động lại container bot, rồi nhắn tin cho bot để kiểm tra. 🎉
281
281
 
282
282
  ---
283
283
 
@@ -292,7 +292,7 @@ Bấm nút **Cập nhật** ở **góc trên bên phải giao diện Setup**. H
292
292
  - **Telegram**: Lấy token bot chính thức từ `@BotFather`.
293
293
  - **Zalo Bot API**: Lấy thông tin kết nối chính thức từ [developers.zalo.me](https://developers.zalo.me).
294
294
  - **Zalo Cá nhân (Zalo Personal)**: Kích hoạt cực nhanh bằng cách quét mã QR hiển thị ngay trên Dashboard OpenClaw.
295
- - **Facebook Messenger**: Qua plugin `fb-messenger` (public trên ClawHub, cài ngay trên giao diện Setup) chỉ cần dùng Page token.
295
+ - **Facebook Messenger**: Qua plugin `fb-messenger` (public trên ClawHub, cài ngay trên giao diện Setup) - chỉ cần dùng Page token.
296
296
  - **Discord**: _Sắp ra mắt._
297
297
  - **Lark**: _Sắp ra mắt._
298
298
 
@@ -355,10 +355,10 @@ Hoàn toàn được. Bạn có thể sửa trực tiếp file `openclaw.json`
355
355
 
356
356
  ## 🙏 Lời cảm ơn
357
357
 
358
- - [OpenClaw](https://openclaw.ai) AI Gateway framework
359
- - [9Router](https://github.com/decolua/9router) Open-source AI proxy (OAuth-based, no API keys)
360
- - [ClawHub](https://clawhub.com) Kho đăng ký các kỹ năng của bot
361
- - [TheSVG](https://thesvg.org) Kho biểu tượng nhãn hiệu SVG chất lượng cao
358
+ - [OpenClaw](https://openclaw.ai) - AI Gateway framework
359
+ - [9Router](https://github.com/decolua/9router) - Open-source AI proxy (OAuth-based, no API keys)
360
+ - [ClawHub](https://clawhub.com) - Kho đăng ký các kỹ năng của bot
361
+ - [TheSVG](https://thesvg.org) - Kho biểu tượng nhãn hiệu SVG chất lượng cao
362
362
 
363
363
  ---
364
364
 
@@ -374,21 +374,21 @@ Mọi góp ý / PR cải tiến đều được hoan nghênh. Nếu thấy hữu
374
374
  Các repo đi kèm để bạn dựng một trợ lý AI "tự vận hành" hoàn chỉnh:
375
375
 
376
376
  **🚀 Cài đặt & khung nền**
377
- - [openclaw-setup](https://github.com/tuanminhhole/openclaw-setup) *(repo này)* Setup bot AI miễn phí bằng OpenClaw + 9Router (Telegram/Zalo/Messenger, Docker)
378
- - [vietbrain](https://github.com/tuanminhhole/vietbrain) Bộ khung "Bộ Não Thứ Hai" tiếng Việt cho Obsidian (sẵn sàng AI)
377
+ - [openclaw-setup](https://github.com/tuanminhhole/openclaw-setup) - *(repo này)* Setup bot AI miễn phí bằng OpenClaw + 9Router (Telegram/Zalo/Messenger, Docker)
378
+ - [vietbrain](https://github.com/tuanminhhole/vietbrain) - Bộ khung "Bộ Não Thứ Hai" tiếng Việt cho Obsidian (sẵn sàng AI)
379
379
 
380
380
  **🔌 Plugin (runtime)**
381
- - [openclaw-fb-messenger](https://github.com/tuanminhhole/openclaw-fb-messenger) Kênh Facebook Messenger (webhook + Graph API), cài ngay trên giao diện Setup
382
- - [openclaw-telegram-multibot-relay](https://github.com/tuanminhhole/openclaw-telegram-multibot-relay) Multibot Telegram relay, delegation & cron nhắc lịch native
383
- - [openclaw-zalo-connect](https://github.com/tuanminhhole/openclaw-zalo-connect) Channel/runtime Zalo cá nhân với đăng nhập QR, mention native và thao tác nhóm
384
- - [openclaw-zalo-mod](https://github.com/tuanminhhole/openclaw-zalo-mod) Quản lý nhóm Zalo zero-token (slash command, anti-spam, warn, memory)
385
- - [openclaw-browser-automation](https://github.com/tuanminhhole/openclaw-browser-automation) Smart Search & Browser Automation
386
- - [openclaw-facebook-crawler](https://github.com/tuanminhhole/openclaw-facebook-crawler) Crawl dữ liệu Facebook
387
- - [openclaw-n8n-facebook-poster](https://github.com/tuanminhhole/openclaw-n8n-facebook-poster) Tự động đăng Facebook qua n8n
381
+ - [openclaw-fb-messenger](https://github.com/tuanminhhole/openclaw-fb-messenger) - Kênh Facebook Messenger (webhook + Graph API), cài ngay trên giao diện Setup
382
+ - [openclaw-telegram-multibot-relay](https://github.com/tuanminhhole/openclaw-telegram-multibot-relay) - Multibot Telegram relay, delegation & cron nhắc lịch native
383
+ - [openclaw-zalo-connect](https://github.com/tuanminhhole/openclaw-zalo-connect) - Channel/runtime Zalo cá nhân với đăng nhập QR, mention native và thao tác nhóm
384
+ - [openclaw-zalo-mod](https://github.com/tuanminhhole/openclaw-zalo-mod) - Quản lý nhóm Zalo zero-token (slash command, anti-spam, warn, memory)
385
+ - [openclaw-browser-automation](https://github.com/tuanminhhole/openclaw-browser-automation) - Smart Search & Browser Automation
386
+ - [openclaw-facebook-crawler](https://github.com/tuanminhhole/openclaw-facebook-crawler) - Crawl dữ liệu Facebook
387
+ - [openclaw-n8n-facebook-poster](https://github.com/tuanminhhole/openclaw-n8n-facebook-poster) - Tự động đăng Facebook qua n8n
388
388
 
389
389
  **🧩 Skill**
390
- - [openclaw-learning-memory](https://github.com/tuanminhhole/openclaw-learning-memory) Context engine trí nhớ always-on (nạp MEMORY.md + USER.md vào mọi lượt, kể cả nhóm)
391
- - [openclaw-skill-infographic](https://github.com/tuanminhhole/openclaw-skill-infographic) Tạo infographic
390
+ - [openclaw-learning-memory](https://github.com/tuanminhhole/openclaw-learning-memory) - Context engine trí nhớ always-on (nạp MEMORY.md + USER.md vào mọi lượt, kể cả nhóm)
391
+ - [openclaw-skill-infographic](https://github.com/tuanminhhole/openclaw-skill-infographic) - Tạo infographic
392
392
 
393
393
  ---
394
394
 
package/dist/cli.js CHANGED
@@ -11,9 +11,9 @@ const __dirname = path.dirname(__filename);
11
11
  // `--version` / `--help` phải TRẢ LỜI RỒI THOÁT, đứng trước mọi thứ khác.
12
12
  //
13
13
  // Trước đây CLI không biết hai cờ này: gõ `create-openclaw-bot --version` là nó lờ đi rồi chạy
14
- // tiếp như thường tạo thư mục project, dựng Setup UI, **chiếm cổng 51789 và treo vĩnh viễn**.
14
+ // tiếp như thường - tạo thư mục project, dựng Setup UI, **chiếm cổng 51789 và treo vĩnh viễn**.
15
15
  // Đo trên vps_minh-thu 07/09: hai tiến trình `cli.js --version` nằm đó từ 02/09 giữ cổng, nên
16
- // systemd relaunch bản mới xong không bind được cổng bấm "Cập nhật" thành công mà giao diện
16
+ // systemd relaunch bản mới xong không bind được cổng - bấm "Cập nhật" thành công mà giao diện
17
17
  // vẫn là bản cũ, không ai hiểu vì sao.
18
18
  {
19
19
  const rawArgs = process.argv.slice(2);
@@ -27,7 +27,7 @@ const __dirname = path.dirname(__filename);
27
27
  }
28
28
  if (rawArgs.includes('--help') || rawArgs.includes('-h')) {
29
29
  console.log([
30
- 'create-openclaw-bot trình cài đặt OpenClaw Bot',
30
+ 'create-openclaw-bot - trình cài đặt OpenClaw Bot',
31
31
  '',
32
32
  'Cách dùng: create-openclaw-bot [tuỳ chọn]',
33
33
  '',
@@ -78,7 +78,7 @@ function isLocalRepo() {
78
78
 
79
79
  // True when the full server code is bundled next to this CLI (dist build, npm/global
80
80
  // install, or `npx github:...`). In that case run it directly instead of bootstrapping
81
- // the published package works even though `files` ships only `dist/` (no `src/`).
81
+ // the published package - works even though `files` ships only `dist/` (no `src/`).
82
82
  function hasBundledServer() {
83
83
  return [
84
84
  path.join(__dirname, 'server', 'local-server.js'),