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 +62 -62
- package/README.vi.md +57 -57
- package/dist/cli.js +4 -4
- package/dist/server/local-server.js +276 -216
- package/dist/setup/data/channels.js +7 -7
- package/dist/setup/data/header.js +1 -1
- package/dist/setup/data/index.js +1 -1
- package/dist/setup/data/plugins.js +3 -3
- package/dist/setup/data/providers.js +7 -7
- package/dist/setup/shared/bot-config-gen.js +34 -34
- package/dist/setup/shared/common-gen.js +6 -6
- package/dist/setup/shared/docker-gen.js +23 -23
- package/dist/setup/shared/host-ui-ps1.js +1 -1
- package/dist/setup/shared/install-gen.js +9 -9
- package/dist/setup/shared/windows-launcher-gen.js +22 -8
- package/dist/setup/shared/workspace-gen.js +144 -144
- package/dist/web/app.js +112 -33
- package/dist/web/styles.css +6 -6
- package/package.json +1 -1
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
|
|
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
|
|
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.
|
|
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](README.vi.md) ·  **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)
|
|
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.
|
|
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
|
|
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
|
|
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
|
|
84
|
-
- 🧹 **Retired TencentDB Agent Memory** in favor of the always-on engine above (no external service needed). Existing bots are auto-migrated on update
|
|
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
|
|
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
|
|
118
|
-
- 🗄️ **SQLite "disk I/O error" on Docker Desktop
|
|
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
|
|
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
|
|
136
|
-
- 🔐 **9router first-install sync
|
|
137
|
-
- 📁 **Native workspace path
|
|
138
|
-
- 🧩 **Config `meta` no longer clobbered**: the generator stops seeding `meta`, so OpenClaw owns it
|
|
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
|
|
147
|
-
- ⚡ **Token-lean defaults for every new bot**: Ships with context pruning (cache-TTL) + `safeguard` compaction
|
|
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`
|
|
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
|
|
151
|
-
- ⚡ **Faster Dashboard & Bot pages**: Runtime/version detection now probes **once** and is cached instead of re-running on every page load
|
|
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**
|
|
187
|
-
- 🧑🤝🧑 **Multi-Bot Team**
|
|
188
|
-
- 🧠 **Unified AI Routing via 9Router**
|
|
189
|
-
- 🧩 **Built-in Skills**
|
|
190
|
-
- 🔌 **Integrated Marketplace**
|
|
191
|
-
- 🔀 **9Router Integration**
|
|
192
|
-
- 🔒 **Safe & Private**
|
|
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
|
|
198
|
+
### 1️⃣ Method 1 - Quick install (Recommended)
|
|
199
199
|
|
|
200
|
-
Open your terminal and run this single command (works on macOS, Linux & Windows
|
|
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
|
|
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
|
|
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)
|
|
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
|
|
257
|
+
> First time? Follow these in order - no terminal needed beyond opening the UI.
|
|
258
258
|
|
|
259
|
-
**1. Open the Setup UI**
|
|
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**
|
|
262
|
-
- **Docker** (recommended)
|
|
263
|
-
- **Native**
|
|
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**
|
|
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**
|
|
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)**
|
|
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)**
|
|
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)**
|
|
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**
|
|
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**
|
|
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)
|
|
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)
|
|
359
|
-
- [9Router](https://github.com/decolua/9router)
|
|
360
|
-
- [ClawHub](https://clawhub.com)
|
|
361
|
-
- [TheSVG](https://thesvg.org)
|
|
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)
|
|
378
|
-
- [vietbrain](https://github.com/tuanminhhole/vietbrain)
|
|
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)
|
|
382
|
-
- [openclaw-telegram-multibot-relay](https://github.com/tuanminhhole/openclaw-telegram-multibot-relay)
|
|
383
|
-
- [openclaw-zalo-connect](https://github.com/tuanminhhole/openclaw-zalo-connect)
|
|
384
|
-
- [openclaw-zalo-mod](https://github.com/tuanminhhole/openclaw-zalo-mod)
|
|
385
|
-
- [openclaw-browser-automation](https://github.com/tuanminhhole/openclaw-browser-automation)
|
|
386
|
-
- [openclaw-facebook-crawler](https://github.com/tuanminhhole/openclaw-facebook-crawler)
|
|
387
|
-
- [openclaw-n8n-facebook-poster](https://github.com/tuanminhhole/openclaw-n8n-facebook-poster)
|
|
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)
|
|
391
|
-
- [openclaw-skill-infographic](https://github.com/tuanminhhole/openclaw-skill-infographic)
|
|
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í
|
|
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.
|
|
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** · [ 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)
|
|
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.
|
|
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
|
|
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
|
|
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**
|
|
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
|
|
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
|
|
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õ
|
|
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
|
|
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
|
|
136
|
-
- 🔐 **Sync 9router lần đầu
|
|
137
|
-
- 📁 **Đường dẫn workspace native
|
|
138
|
-
- 🧩 **Không ghi đè khối `meta` trong config**: generator ngừng seed `meta` để OpenClaw tự quản
|
|
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
|
|
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`
|
|
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`
|
|
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
|
|
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
|
|
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**
|
|
187
|
-
- 🧑🤝🧑 **Đội bot (Multi-bot Team)**
|
|
188
|
-
- 🧠 **Đa nhà cung cấp AI qua 9Router**
|
|
189
|
-
- 🧩 **Kỹ năng (Skills)**
|
|
190
|
-
- 🔌 **Plugin tích hợp**
|
|
191
|
-
- 🔀 **9Router tích hợp**
|
|
192
|
-
- 🔒 **An toàn & Riêng tư**
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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.
|
|
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ự
|
|
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**
|
|
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**
|
|
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**
|
|
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)**
|
|
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)**
|
|
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)**
|
|
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**
|
|
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**
|
|
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)
|
|
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)
|
|
359
|
-
- [9Router](https://github.com/decolua/9router)
|
|
360
|
-
- [ClawHub](https://clawhub.com)
|
|
361
|
-
- [TheSVG](https://thesvg.org)
|
|
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)
|
|
378
|
-
- [vietbrain](https://github.com/tuanminhhole/vietbrain)
|
|
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)
|
|
382
|
-
- [openclaw-telegram-multibot-relay](https://github.com/tuanminhhole/openclaw-telegram-multibot-relay)
|
|
383
|
-
- [openclaw-zalo-connect](https://github.com/tuanminhhole/openclaw-zalo-connect)
|
|
384
|
-
- [openclaw-zalo-mod](https://github.com/tuanminhhole/openclaw-zalo-mod)
|
|
385
|
-
- [openclaw-browser-automation](https://github.com/tuanminhhole/openclaw-browser-automation)
|
|
386
|
-
- [openclaw-facebook-crawler](https://github.com/tuanminhhole/openclaw-facebook-crawler)
|
|
387
|
-
- [openclaw-n8n-facebook-poster](https://github.com/tuanminhhole/openclaw-n8n-facebook-poster)
|
|
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)
|
|
391
|
-
- [openclaw-skill-infographic](https://github.com/tuanminhhole/openclaw-skill-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
|
|
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
|
|
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
|
|
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
|
|
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'),
|