create-openclaw-bot 5.5.0 → 5.6.0

package/docs/ai-providers.vi.md

@@ -1,144 +0,0 @@
-# Hướng dẫn Cấu hình AI Provider
-
-Tài liệu này tổng hợp toàn bộ AI provider được hỗ trợ trong OpenClaw. Sử dụng để lựa chọn provider phù hợp với ngân sách, yêu cầu kỹ thuật và nhu cầu bảo mật của bạn.
-
----
-
-## 📊 So sánh các Provider
-
-| Provider | Chi phí | Cần API Key | Dữ liệu | Phù hợp nhất |
-| --- | --- | --- | --- | --- |
-| **9Router** | 🆓 Miễn phí | ❌ Đăng nhập OAuth | Cloud | Người mới bắt đầu. Không cần cấu hình. |
-| **Google Gemini** | 🆓 Free tier | ✅ Có | Cloud | Chất lượng cao. Giới hạn miễn phí rộng rãi. |
-| **Anthropic Claude** | 💰 Trả phí | ✅ Có | Cloud | Lý luận và viết văn tốt nhất. |
-| **OpenAI / Codex** | 💰 Trả phí | ✅ Có | Cloud | Sinh code, hệ sinh thái rộng. |
-| **OpenRouter** | 🆓/💰 Hỗn hợp | ✅ Có | Cloud | Truy cập nhiều provider bằng một key duy nhất. |
-| **Ollama (Local)** | 🏠 Miễn phí | ❌ Không cần | **Cục bộ** | Bảo mật tuyệt đối. Chạy offline được. |
-
----
-
-## 🔀 9Router — Khuyên dùng cho người mới
-
-9Router là một **AI proxy mã nguồn mở** chạy trên máy của bạn và tự động định tuyến yêu cầu AI đến model miễn phí tốt nhất. Thay vì quản lý API key, bạn chỉ cần đăng nhập một lần qua OAuth.
-
-**Lý do chọn 9Router:**
-- Không cần API key — chỉ cần đăng nhập OAuth một lần (GitHub, Google, ...)
-- Tự động định tuyến đến model miễn phí (iFlow, Qwen, Gemini) với fallback thông minh
-- Hỗ trợ 40+ provider và 100+ model
-- Hoạt động trên **mọi nền tảng: Windows, macOS, Linux, VPS**
-- Miễn phí hoàn toàn — mã nguồn mở
-
-**Tùy chọn A — Cài native (hoạt động trên mọi OS kể cả Windows):**
-```bash
-npm install -g 9router
-9router
-```
-Dashboard 9Router mở tại `http://localhost:20128`. Đăng nhập và kết nối một provider miễn phí.
-
-**Tùy chọn B — Docker sidecar (tự động khi dùng Docker mode của OpenClaw):**
-Khi bạn chọn 9Router trong Setup Wizard với Docker mode, file `docker-compose.yml` được tạo ra tự động bao gồm 9Router như một container sidecar. Không cần cài riêng.
-
-**Dùng 9Router với OpenClaw:**
-Dù bạn cài 9Router native hay qua Docker, cấu hình OpenClaw để dùng nó:
-- API endpoint: `http://localhost:20128/v1`
-- API key: sao chép từ dashboard 9Router
-- Model: chọn bất kỳ model nào hiển thị là available trong dashboard
-
-> [!TIP]
-> Bắt đầu với combo miễn phí: Gemini CLI (180K free/tháng) + iFlow models (miễn phí không giới hạn) = $0/tháng.
-
----
-
-## 🧠 Google Gemini
-
-Google Gemini cung cấp free tier hào phóng nhất hiện có, là lựa chọn tốt nhất nếu bạn muốn dùng API key mà không mất tiền.
-
-**Các model hỗ trợ:** Gemini 2.5 Flash, Gemini 2.5 Pro, Gemini 3.0 Flash
-
-**Cách lấy API key:**
-1. Truy cập [Google AI Studio](https://aistudio.google.com/apikey)
-2. Đăng nhập bằng tài khoản Google
-3. Nhấn **Create API Key**
-4. Sao chép key và dán vào Setup Wizard khi được hỏi
-
-**Giới hạn free tier:** ~15 yêu cầu/phút, ~1 triệu token/ngày (tính đến 2025). Đủ cho nhu cầu cá nhân.
-
----
-
-## 🤖 Anthropic Claude
-
-Claude được đánh giá là model hàng đầu về lý luận phức tạp, viết nội dung dài và tuân thủ hướng dẫn.
-
-**Các model hỗ trợ:** Claude Sonnet 4, Claude Opus 4, Claude Haiku 3.5
-
-**Cách lấy API key:**
-1. Truy cập [Anthropic Console](https://console.anthropic.com/settings/keys)
-2. Tạo tài khoản và thêm thông tin thanh toán
-3. Tạo API key và dán vào Setup Wizard
-
-> [!WARNING]
-> Anthropic Claude yêu cầu tài khoản trả phí để lấy API key. Không có free tier vĩnh viễn.
-
----
-
-## 🤖 OpenAI / Codex
-
-Phù hợp nếu bạn cần GPT-4o cho các tác vụ đa dạng hoặc Codex Mini cho quy trình làm việc nặng về code.
-
-**Các model hỗ trợ:** GPT-4o, GPT-4o Mini, o3, Codex Mini
-
-**Cách lấy API key:**
-1. Truy cập [OpenAI Platform](https://platform.openai.com/api-keys)
-2. Tạo tài khoản và nạp tối thiểu $5
-3. Tạo API key và dán vào Setup Wizard
-
----
-
-## 🌐 OpenRouter
-
-OpenRouter tổng hợp hàng trăm model (bao gồm cả model miễn phí) dưới một API key duy nhất. Hữu ích khi muốn chuyển đổi provider mà không cần chạy lại Setup Wizard.
-
-**Cách lấy API key:**
-1. Truy cập [OpenRouter.ai](https://openrouter.ai/keys)
-2. Tạo tài khoản (miễn phí)
-3. Tạo API key. Một số model trên OpenRouter có giới hạn sử dụng miễn phí.
-4. Dán key vào Setup Wizard
-
-> [!TIP]
-> OpenRouter bao gồm quyền truy cập miễn phí vào nhiều model mã nguồn mở. Lọc theo `Price: Free` trên trang web của họ để xem danh sách.
-
----
-
-## 🏠 Ollama — AI Cục bộ (Không cần API Key)
-
-Ollama chạy model AI trực tiếp trên máy tính hoặc máy chủ của bạn. Dữ liệu không rời khỏi hạ tầng của bạn. Lý tưởng cho các triển khai cần bảo mật cao.
-
-**Các model local được hỗ trợ:** Gemma 4, Llama 3, Qwen 2.5, Phi-3, Mistral và nhiều hơn nữa.
-
-### Docker Mode (Khuyên dùng)
-Khi chạy OpenClaw với Docker và chọn Ollama, Setup Wizard tự động:
-- Thêm service `ollama` vào `docker-compose.yml`
-- Cấu hình URL nội bộ là `http://ollama:11434`
-- Đặt `OLLAMA_KEEP_ALIVE=24h` để giữ model trong RAM
-- Pull model đã chọn khi `docker compose up` lần đầu
-
-Bạn **không cần** cài Ollama riêng.
-
-### Native Mode
-Nếu không dùng Docker, bạn phải cài Ollama thủ công:
-1. Truy cập [ollama.com](https://ollama.com) và tải installer cho OS của bạn
-2. Sau khi cài xong, pull model muốn dùng:
-   ```bash
-   ollama pull gemma4
-   ```
-3. Đảm bảo Ollama đang chạy trước khi khởi động bot. OpenClaw sẽ kết nối đến `http://localhost:11434`.
-
-### Chọn phiên bản Gemma 4 phù hợp
-Xem [Hướng dẫn RAM & Phần cứng](hardware-guide.vi.md) để biết chi tiết.
-
-| Model | RAM tối thiểu | Phù hợp |
-| --- | --- | --- |
-| `gemma4:e2b` | 4 GB | Rất nhẹ. VPS giá rẻ. |
-| `gemma4:e4b` | 8 GB | Laptop và VPS phổ thông. |
-| `gemma4` (Base) | 16 GB | Khuyên dùng. Chất lượng output tốt. |
-| `gemma4:26b` | 32 GB+ | Máy chủ cao cấp có GPU. |

package/docs/browser-automation-guide.md

@@ -1,207 +0,0 @@
-# OpenClaw Browser Automation — Hướng dẫn sử dụng
-
-## Tổng quan
-
-Browser Automation cho phép bot AI **điều khiển Chrome thật trên màn hình** máy bạn theo thời gian thực. Bot có thể:
-- 🌐 Mở website, duyệt web ngay trên màn hình bạn
-- 📝 Điền form tự động
-- 🖱️ Click, gõ phím, cuộn trang
-- 📸 Chụp ảnh màn hình và gửi về chat
-- 🔐 Dùng luôn session login sẵn (Facebook, Gmail...)
-
-> ⚠️ **Lưu ý:** Chrome debug dùng **profile riêng** (`%TEMP%\chrome-debug`). Bạn cần login lại Facebook/Gmail 1 lần trong profile này.
-
----
-
-## Cách hoạt động
-
-```
-Máy bạn (Windows)                    Docker Container
-┌─────────────────────┐              ┌──────────────────────────┐
-│ Chrome Debug Mode   │◄────────────►│ socat proxy              │
-│ Port 9222 (visible) │   TCP/CDP    │ (9222 → host.docker:9222)│
-│                     │              │                          │
-│ Bạn thấy bot thao   │              │ browser-tool.js          │
-│ tác TRỰC TIẾP!      │              │ → Playwright CDP client  │
-└─────────────────────┘              └──────────────────────────┘
-```
-
-1. Chrome chạy trên máy bạn ở **Debug Mode** (port 9222) — **có giao diện, bạn nhìn thấy được**
-2. Docker container dùng **socat** để bridge cổng: `container:9222 → Windows host:9222`
-3. **`browser-tool.js`** dùng Playwright CDP client kết nối vào Chrome thật đó
-4. Bot thao tác → bạn thấy Chrome di chuyển ngay trên màn hình
-
----
-
-## Bước 1: Bật Chrome Debug Mode
-
-File **`start-chrome-debug.bat`** đã có sẵn trong thư mục dự án. Mỗi khi cần bot duyệt web:
-
-1. Mở thư mục dự án (ví dụ: `D:\openclaw-setup`)
-2. **Click đúp vào `start-chrome-debug.bat`**
-3. Đợi Chrome mở ra và thấy dòng `OK! Chrome Debug Mode dang chay.` màu xanh
-4. **Để cửa sổ này mở** trong suốt quá trình bot làm việc
-
-> **Quan trọng:** Phải bật Chrome Debug **trước khi** khởi động Docker. Nếu bot báo lỗi "chưa bật Chrome", hãy click đúp file này rồi thử lại.
-
-<details>
-<summary>Nội dung file bat (tham khảo)</summary>
-
-```batch
-@echo off
-echo ====== OpenClaw - Chrome Debug Mode ======
-taskkill /F /IM chrome.exe >nul 2>&1
-timeout /t 3 /nobreak >nul
-start "" "C:\Program Files\Google\Chrome\Application\chrome.exe" ^
-  --remote-debugging-port=9222 ^
-  --remote-allow-origins=* ^
-  --user-data-dir="%TEMP%\chrome-debug"
-timeout /t 4 /nobreak >nul
-powershell -Command "try { Invoke-WebRequest -Uri 'http://localhost:9222/json/version' -UseBasicParsing -TimeoutSec 5 | Out-Null; Write-Host 'OK! Chrome Debug Mode dang chay.' -ForegroundColor Green } catch { Write-Host 'LOI: Port 9222 chua mo.' -ForegroundColor Red }"
-pause
-```
-
-</details>
-
----
-
-## Bước 2: Tự động bật Chrome khi mở máy (Task Scheduler)
-
-Chạy script PowerShell bên dưới **1 lần** với **Run as Administrator**:
-
-```powershell
-$batPath = "$env:USERPROFILE\start-chrome-debug.bat"
-
-if (-not (Test-Path $batPath)) {
-  Write-Host "LOI: Không tìm thấy $batPath" -ForegroundColor Red
-  exit 1
-}
-
-$action   = New-ScheduledTaskAction -Execute $batPath
-$trigger  = New-ScheduledTaskTrigger -AtLogOn
-$trigger.Delay = "PT10S"
-$settings = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable
-
-Register-ScheduledTask `
-  -TaskName "OpenClaw-ChromeDebug" `
-  -Description "Tu dong bat Chrome Debug Mode cho OpenClaw" `
-  -Action $action `
-  -Trigger $trigger `
-  -Settings $settings `
-  -Force
-
-Write-Host "DONE! Chrome sẽ tự bật Debug Mode mỗi khi đăng nhập Windows." -ForegroundColor Green
-```
-
----
-
-## Bước 3: Cách bot thao tác trình duyệt
-
-Bot dùng script nội bộ **`browser-tool.js`** (tự động có trong container) để điều khiển Chrome:
-
-```bash
-# Kiểm tra kết nối (chạy trong container)
-node /root/.openclaw/workspace/browser-tool.js status
-
-# Mở trang web
-node /root/.openclaw/workspace/browser-tool.js open "https://google.com"
-
-# Đọc nội dung trang
-node /root/.openclaw/workspace/browser-tool.js get_text
-
-# Click vào phần tử (CSS Selector)
-node /root/.openclaw/workspace/browser-tool.js click "input[name='q']"
-
-# Gõ văn bản
-node /root/.openclaw/workspace/browser-tool.js fill "input[name='q']" "bàn phím cơ"
-
-# Nhấn phím
-node /root/.openclaw/workspace/browser-tool.js press "Enter"
-```
-
-Bot tự động dùng các lệnh này khi bạn nhắn **"mở trình duyệt"** hoặc **"dùng browser"**.
-
----
-
-## Cách ra lệnh cho bot
-
-| Lệnh | Bot làm gì |
-|------|-----------|
-| `"Mở google.com và tìm bàn phím cơ"` | Mở Chrome → search → chụp ảnh → báo cáo |
-| `"Dùng browser vào shopee tìm iPhone"` | Mở Shopee → tìm → tổng hợp kết quả |
-| `"Mở facebook và đọc tin mới nhất"` | Vào Facebook (đã login sẵn) → đọc feed |
-| `"Tìm trên web..."` | ❌ Dùng web_search thay vì browser — hãy nói rõ "browser" |
-
-> **Tip:** Bot sẽ trả lời ngay khi nhận lệnh, rồi thực hiện và báo cáo kết quả + ảnh chụp màn hình.
-
----
-
-## Cấu hình `openclaw.json`
-
-Phần `browser` trong config **phải có**:
-
-```json
-"browser": {
-  "enabled": true,
-  "noSandbox": true,
-  "defaultProfile": "host-chrome",
-  "profiles": {
-    "host-chrome": {
-      "cdpUrl": "http://127.0.0.1:9222",
-      "color": "#4285F4"
-    }
-  }
-}
-```
-
----
-
-## Cấu hình Dockerfile
-
-Container cần **2 thứ** để browser automation hoạt động:
-
-```dockerfile
-# 1. Cài socat (bridge cổng từ container ra host Windows)
-RUN apt-get update && apt-get install -y socat && rm -rf /var/lib/apt/lists/*
-
-# 2. Cài Playwright + tạo symlink Google Chrome
-RUN npm install -g playwright && npx playwright install chromium --with-deps \
-    && ln -f -s /root/.cache/ms-playwright/chromium-*/chrome-linux*/chrome /usr/bin/google-chrome
-
-# 3. Khởi động socat kèm gateway (trong CMD)
-CMD sh -c "socat TCP-LISTEN:9222,fork,reuseaddr TCP:host.docker.internal:9222 & openclaw gateway run"
-```
-
----
-
-## Lưu ý quan trọng
-
-| # | Lưu ý |
-|---|-------|
-| 1 | **Bật `start-chrome-debug.bat` trước** khi Docker chạy |
-| 2 | Chrome debug dùng **profile riêng** → phải login lại các trang 1 lần |
-| 3 | Port 9222 chỉ bind localhost → **an toàn** |
-| 4 | Container thêm **~500MB** do Playwright Chromium |
-| 5 | Chỉ hỗ trợ **Chrome/Chromium** |
-| 6 | Nếu bot báo "Chrome đang tắt" → chạy lại `start-chrome-debug.bat` |
-
----
-
-## Gỡ lỗi thường gặp
-
-**Bot nói "không kết nối được Chrome":**
-→ Chạy lại `start-chrome-debug.bat`.
-
-**Bot phản hồi chậm:**
-→ Bình thường — bot cần thời gian tải trang. Phần thao tác browser (~5-15s) chậm hơn web_search.
-
-**Bot không dùng browser dù đã nói "mở trình duyệt":**
-→ Kiểm tra file `AGENTS.md` trong `.openclaw/workspace/` có hướng dẫn dùng `browser-tool.js` chưa.
-
----
-
-## Xóa Task Scheduler (nếu cần)
-
-```powershell
-Unregister-ScheduledTask -TaskName "OpenClaw-ChromeDebug" -Confirm:$false
-```

package/docs/faq.md

@@ -1,63 +0,0 @@
-# Frequently Asked Questions (FAQ)
-
-<details>
-<summary><b>1. Is OpenClaw free to use?</b></summary>
-<br>
-Yes, the OpenClaw framework itself is 100% free and open-source (MIT License). Costs will only incur if you connect to paid AI providers (like OpenAI GPT-4o or Anthropic Claude). To run it completely free, we recommend using the integrated **9Router**, **Google Gemini** (Free tier), or running **Ollama** locally.
-</details>
-
-<details>
-<summary><b>2. What is 9Router and why is it recommended?</b></summary>
-<br>
-9Router is an open-source AI proxy. Instead of managing complex API keys from multiple platforms, 9Router allows you to authenticate once via OAuth. It automatically routes your bot's prompts to the best available free AI models. It works seamlessly out of the box in both Native and Docker deployment modes.
-</details>
-
-<details>
-<summary><b>3. When SHOULD and SHOULD NOT I use Docker?</b></summary>
-<br>
-
-*   **RECOMMENDED to use Docker (Windows/macOS):** Provides perfect isolation and avoids dependency conflicts. Ideal if you aren't familiar with terminal usage and want a pre-packaged environment easily managed via Docker Desktop.
-*   **NOT RECOMMENDED to use Docker (Ubuntu/VPS):** If you are deploying on a cheap VPS (e.g. 1GB-2GB RAM) or a personal Ubuntu machine, installing natively (Native mode) managed by `PM2` is the superior method. Native mode saves up to 15% RAM that would otherwise be eaten up by virtualization overhead. OpenClaw is inherently secure, so adding Docker overhead on small servers is unnecessary.
-
-</details>
-
-<details>
-<summary><b>4. My bot is unresponsive, what should I do?</b></summary>
-<br>
-Troubleshooting depends on your deployment mode:
-
-**If running Docker Mode:**
-1. Open your Terminal/PowerShell in your bot's setup folder.
-2. Check container status: `docker compose ps`
-3. Check error logs: `docker compose logs -f`
-4. Soft restart the bot: `docker compose restart`
-
-**If running Native Mode (via PM2):**
-1. Check process status: `pm2 status`
-2. View error logs: `pm2 logs openclaw-bot`
-3. Restart process: `pm2 restart openclaw-bot`
-
-*Tip: If you're using 9Router, ensure it's successfully running and authenticated at http://localhost:20128/dashboard.*
-</details>
-
-<details>
-<summary><b>5. Does the bot stay online 24/7?</b></summary>
-<br>
-Both guided setups are configured for resilient automation:
-*   **With Docker:** Uses the `restart: unless-stopped` directive. The bot resurrects automatically on system reboots or crashes.
-*   **With Native (PM2):** The generated CLI command runs `pm2 save` automatically to lock your context into the Linux daemon. (Don't forget to execute `pm2 startup` if prompted by the CLI).
-*Note: If you run it on your personal laptop, shutting down the OS turns off the bot. Install it on a VPS for true 24/7 uptime.*
-</details>
-
-<details>
-<summary><b>6. How can I change my AI Model after the initial setup?</b></summary>
-<br>
-Simply re-run the command `npx create-openclaw-bot` inside your existing bot directory. The wizard will walk you through the options again and safely overwrite your gateway configuration file without deleting your bot's history or local skills.
-</details>
-
-<details>
-<summary><b>7. Docker setup throws a missing plugin error, how to fix?</b></summary>
-<br>
-If you are on Linux (Ubuntu/Debian) and receive an error mentioning `unknown shorthand flag`, your server is running the legacy Docker V1 engine. OpenClaw requires Docker Compose V2.
-Fix this by running the package manager command: `sudo apt-get install docker-compose-plugin`
-</details>

package/docs/faq.vi.md

@@ -1,63 +0,0 @@
-# Các Câu Hỏi Thường Gặp (FAQ)
-
-<details>
-<summary><b>1. OpenClaw có miễn phí không?</b></summary>
-<br>
-Có, toàn bộ mã nguồn của OpenClaw hoàn toàn miễn phí (MIT License). Bạn không phải trả bất kỳ khoản phí nào cho OpenClaw. Tuy nhiên, chi phí sẽ phát sinh nếu bạn sử dụng các AI Provider trả phí (như GPT-4o, Claude 3.5 Sonnet). Để sử dụng miễn phí 100%, hãy chọn **9Router** (được cung cấp sẵn) hoặc **Google Gemini** (Free tier), hoặc chạy **Ollama** cục bộ.
-</details>
-
-<details>
-<summary><b>2. 9Router là gì và tại sao lại được khuyến nghị?</b></summary>
-<br>
-9Router là một hệ thống AI Proxy mã nguồn mở miễn phí. Thay vì phải chật vật đăng ký và quản lý API Key từ nhiều nền tảng, 9Router cho phép bạn xác thực bằng 1 lần đăng nhập (OAuth). Nó sẽ tự động định tuyến các câu hỏi của bot sang các model AI miễn phí tốt nhất hiện có. Nó hoạt động hoàn hảo cả trên môi trường Native và Docker. 
-</details>
-
-<details>
-<summary><b>3. Khi nào tôi NÊN và KHÔNG NÊN dùng Docker?</b></summary>
-<br>
-
-*   **NÊN dùng Docker (Windows/macOS):** Cung cấp sự cách ly hoàn hảo. Rất lý tưởng nếu bạn không rành về dòng lệnh và muốn mọi thứ được đóng gói tự động chuẩn xác bằng Docker Desktop.
-*   **KHÔNG NÊN dùng Docker (Ubuntu/VPS):** Nếu bạn thuê VPS giá rẻ (RAM 1GB - 2GB) hoặc cài trên Ubuntu cá nhân, cài thẳng (Native mode) với `PM2` là phương pháp tốt nhất. Nó giúp tiết kiệm tới 15% RAM so với việc bị chạy ảo hóa qua Docker. Bản thân OpenClaw đã rất bảo mật nên không cần bọc thêm Docker trên VPS.
-
-</details>
-
-<details>
-<summary><b>4. Bot của tôi không phản hồi, tôi phải làm sao?</b></summary>
-<br>
-Cách xử lý phụ thuộc vào môi trường bạn cài đặt:
-
-**Trường hợp dùng Docker:**
-1. Mở Terminal/PowerShell tại thư mục cài đặt bot.
-2. Kiểm tra container: `docker compose ps`
-3. Đọc log để xem lỗi: `docker compose logs -f`
-4. Khởi động lại: `docker compose restart`
-
-**Trường hợp dùng Native (PM2):**
-1. Kiểm tra tiến trình: `pm2 status`
-2. Đọc log để xem lỗi: `pm2 logs openclaw-bot`
-3. Khởi động lại: `pm2 restart openclaw-bot`
-
-*Mẹo: Nếu bạn dùng 9Router, hãy chắc chắn rằng bạn đã mở http://localhost:20128/dashboard và đăng nhập thành công.*
-</details>
-
-<details>
-<summary><b>5. Bot có tự động chạy 24/7 không?</b></summary>
-<br>
-Cả hai chế độ cài đặt đều được cấu hình để tự động hóa:
-*   **Với Docker:** Có cờ `restart: unless-stopped`. Bot sẽ tự chạy lại nếu máy khởi động.
-*   **Với Native (PM2):** Lệnh CLI tạo ra đã bao gồm `pm2 save` để tự chạy lại sau khi reboot cục bộ trên Linux/VPS. (Đừng quên chạy lệnh `pm2 startup` nếu được yêu cầu trên Linux).
-*Lưu ý: Nếu bạn cài đặt trên laptop cá nhân, tắt máy thì bot sẽ offline. Để online 24/7, hãy cài đặt lên VPS.*
-</details>
-
-<details>
-<summary><b>6. Nếu muốn đổi AI Model sau khi cài, tôi phải làm thế nào?</b></summary>
-<br>
-Chỉ cần chạy lại lệnh `npx create-openclaw-bot` trong chính thư mục chứa bot của bạn. Trình setup sẽ hỏi lại các tùy chọn và tự động ghi đè an toàn file cấu hình mà không làm mất kỹ năng/lịch sử lưu trữ của bot.
-</details>
-
-<details>
-<summary><b>7. Cài đặt Docker báo lỗi thiếu Plugin, tôi phải làm gì?</b></summary>
-<br>
-Nếu bạn dùng Linux (Ubuntu/Debian) và gặp lỗi liên quan đến thuật ngữ `unknown shorthand flag`, nghĩa là server của bạn chỉ có Docker V1 cũ. OpenClaw yêu cầu Docker Compose V2.
-Để khắc phục, hãy chạy lệnh: `sudo apt-get install docker-compose-plugin`
-</details>

package/docs/hardware-guide.md

@@ -1,55 +0,0 @@
-# Hardware & RAM Configuration Guide (Gemma 4 / Ollama)
-
-When running **Local AI Models** (like Google's Gemma 4 via Ollama), your server or machine's hardware determines the speed and capability of the bot. 
-
-OpenClaw supports running local models **without an API Key**. This guide helps you choose the right hardware based on the model tier and deployment mode.
-
----
-
-## 💻 1. Gemma 4 Variant Matrix
-
-Gemma 4 is available in four variants to accommodate different hardware classes. All variants are automatically pulled if you select "Ollama + Gemma" during the Setup Wizard.
-
-| Gemma 4 Variant | Target Device / VPS | Min RAM (Native) | Min RAM (Docker) | Use Case |
-|---|---|---|---|---|
-| `gemma4:e2b` | Raspberry Pi, Budget VPS | ~ 4 GB | ~ 5 GB | Lightweight tasks, slow generation |
-| `gemma4:e4b` | Standard Laptop, VPS | ~ 8 GB | ~ 9 GB | Good balance for standard chat bots |
-| `gemma4` (Base) | Solid Workstation / Gaming PC | ~ 16 GB | ~ 18 GB | **Recommended.** High quality text |
-| `gemma4:26b` / `31b` | High-End GPU Server | ~ 32 GB+ | ~ 34 GB+ | Enterprise-grade local processing |
-
-> [!TIP]
-> **Docker Overhead:** Running Ollama inside Docker (Docker Mode) consumes about **10-15% more RAM** compared to running it natively on the host OS. If you are on a strict 8GB VPS constraint, consider using **Native Install Mode**.
-
----
-
-## ⚡ 2. Docker vs Native RAM Trade-offs
-
-### If using **Docker Mode**:
-- **Pros:** Perfect isolation. Ollama sidecar is automatically configured and networked (`http://ollama:11434`) without cluttering your host system. 
-- **Cons:** Memory penalty. Docker's virtualization layer reserves RAM. 
-- **Config:** OpenClaw's generated `docker-compose.yml` automatically sets:
-  - `OLLAMA_NUM_PARALLEL=1` to prevent Ollama from exhausting RAM with concurrent inputs.
-  - `OLLAMA_KEEP_ALIVE=24h` to keep the model loaded in RAM, preventing long startup times for subsequent chats.
-
-### If using **Native Mode**:
-- **Pros:** Direct access to host hardware. Maximum RAM efficiency and GPU passthrough (if you have an Nvidia/AMD GPU).
-- **Cons:** You must install Ollama manually on your OS.
-- **Config:** OpenClaw reads from `http://localhost:11434`.
-
----
-
-## 🛠️ 3. How to optimize your VPS
-
-If setting up on an Ubuntu VPS, you **must enable Swap Space** if your RAM barely meets the minimum.
-
-**Enable 8GB Swap on Ubuntu (Run as root):**
-```bash
-fallocate -l 8G /swapfile
-chmod 600 /swapfile
-mkswap /swapfile
-swapon /swapfile
-echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
-```
-
-> [!WARNING]
-> Swap space uses your Hard Drive/SSD as slow RAM. While it prevents crashes (Out of Memory errors), generation speed will be **drastically slower** if the model drops into swap memory. Always prioritize physical RAM or VRAM when possible.

package/docs/hardware-guide.vi.md

@@ -1,55 +0,0 @@
-# Hướng dẫn chọn cấu hình RAM & Phần cứng (Gemma 4 / Ollama)
-
-Khi chạy **Model AI Tại Máy (Local)** (như Gemma 4 của Google thông qua Ollama), phần cứng máy tính hoặc VPS của bạn sẽ quyết định tốc độ và độ thông minh của bot.
-
-OpenClaw hỗ trợ chạy các model local **không cần API Key**. Tài liệu này hướng dẫn bạn chọn cấu hình chuẩn dựa trên dung lượng phân khúc model và chế độ cài đặt.
-
----
-
-## 💻 1. Ma trận Phiên bản Gemma 4
-
-Gemma 4 có sẵn 4 kích thước (variants) phù hợp với đa dạng thiết bị. Khi bạn sử dụng Setup Wizard và chọn "Ollama + Gemma", model tương ứng sẽ được tự động pull về.
-
-| Phiên bản Gemma 4 | Thiết bị mục tiêu / VPS | RAM tối thiểu (Native) | RAM tối thiểu (Docker) | Mục đích sử dụng |
-|---|---|---|---|---|
-| `gemma4:e2b` | Raspberry Pi, VPS Giá Rẻ | ~ 4 GB | ~ 5 GB | Tác vụ rất nhẹ nhàng, tốc độ phản hồi chậm |
-| `gemma4:e4b` | Laptop phổ thông, VPS chuẩn | ~ 8 GB | ~ 9 GB | Cân bằng tốt cho bot chat thông thường |
-| `gemma4` (Base) | PC Khỏe / Workstation | ~ 16 GB | ~ 18 GB | **Khuyên dùng.** Năng lực text chất lượng cao |
-| `gemma4:26b` / `31b` | Máy chủ chuyên dụng có GPU | ~ 32 GB+ | ~ 34 GB+ | Cấp doanh nghiệp, xử lý logic phức tạp |
-
-> [!TIP]
-> **Hao phí của Docker:** Chạy Ollama trong Docker (Docker Mode) tiêu tốn thêm khoảng **10-15% RAM** so với chạy thẳng trên hệ điều hành (Native). Nếu VPS của bạn chỉ có đúng 8GB, hãy cân nhắc sử dụng **Chế độ Native Install**.
-
----
-
-## ⚡ 2. Được và Mất: Docker vs Native
-
-### Nếu chọn **Docker Mode**:
-- **Ưu điểm:** Cách ly siêu sạch. Service Ollama được cấu hình mạng nội bộ tự động (`http://ollama:11434`) mà không làm bẩn hệ điều hành của bạn.
-- **Nhược điểm:** Phạt bộ nhớ. Lớp ảo hóa của Docker sẽ cắn bớt một phần RAM.
-- **Cấu hình:** File `docker-compose.yml` sinh ra từ OpenClaw đã auto-cấu hình:
-  - `OLLAMA_NUM_PARALLEL=1` để chặn Ollama không bị tràn RAM khi có nhiều người chat cùng lúc.
-  - `OLLAMA_KEEP_ALIVE=24h` để giữ model luôn nằm trên RAM, tránh tình trạng phản hồi lâu ở các câu hỏi sau.
-
-### Nếu chọn **Native Mode**:
-- **Ưu điểm:** Khai thác tối đa 100% phần cứng máy chủ. Tận dụng tối đa sức mạnh Native và GPU Passthrough (nếu bạn có card rời Nvidia/AMD).
-- **Nhược điểm:** Bạn phải tự cài ứng dụng Ollama trên môi trường OS của bạn.
-- **Cấu hình:** OpenClaw sẽ đọc model từ đường dẫn `http://localhost:11434`.
-
----
-
-## 🛠️ 3. Mẹo tối ưu cho VPS
-
-Nếu cài đặt trên Ubuntu VPS, bạn **bắt buộc phải tạo Swap Space (RAM ảo)** nếu RAM vật lý chỉ vừa khít hoặc thiếu hụt.
-
-**Lệnh tạo 8GB Swap trên Ubuntu (Mở quyền root):**
-```bash
-fallocate -l 8G /swapfile
-chmod 600 /swapfile
-mkswap /swapfile
-swapon /swapfile
-echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
-```
-
-> [!WARNING]
-> Swap space lấy ổ cứng Hard Drive/SSD làm RAM cực hãm. Dù nó giúp VPS từ chối tử thần (lỗi Out of Memory - sập nguồn), tốc độ sinh chữ (generation) sẽ **chậm như rùa bò** nếu model rơi vào vùng Swap. Luôn ưu tiên dùng RAM thật (DDR) hoặc VRAM của GPU khi có thể.