OpenClaw setup guide cho beginner | Cài đặt AI agent trên PC từ Discord/Telegram【2026】

Bạn search “OpenClaw setup” vì muốn agent thật trên máy, không chỉ chat web. Bài này viết lại toàn bộ quy trình từ zero — dựa trên hướng dẫn sản phẩm chính thức trong repo (cùng nội dung bản JA), không bịa tính năng.

Đối tượng: sinh viên CNTT, freelancer outsourcing, dev indie ở VN — quen Discord/Telegram, muốn bot trả lời trên kênh team mà không đẩy toàn bộ context lên SaaS lạ.

Bài này giúp bạn

• Hiểu OpenClaw khác ChatGPT web / Claude.ai ở điểm nào
• Checklist môi trường: PC, Node 22+, port 18789, API key
• Chọn provider (Gemini free → Claude → Groq nhanh → Ollama local)
• Cài Mac/Linux và Windows (PowerShell + ExecutionPolicy)
• Trả lời 10 câu onboarding wizard đúng lần đầu
• Nối Discord / Telegram / WhatsApp + lỗi Intents / pairing thường gặp
• Tùy chỉnh SOUL.md và openclaw.json (limit token, mention-only)

---

OpenClaw là gì?

OpenClaw do kỹ sư Áo phát triển — AI agent mã nguồn mở chạy trên máy bạn. Bạn nói chuyện với AI qua app chat quen thuộc thay vì chỉ mở tab trình duyệt.

Khả năng chính (theo tài liệu sản phẩm):

• Ra lệnh AI từ Discord / Telegram / WhatsApp
• Tự động hóa task thực tế: tìm web, thao tác file, quản lý lịch…
• Chạy local → bạn kiểm soát data và API key (khác model SaaS)
• Tùy hành vi / “tính cách” qua file SOUL.md
• Mở rộng bằng skills (plugin)

Không phải: IDE plugin kiểu Cursor, cũng không phải hosting agent trên cloud của bên thứ ba. Gateway chạy trên PC; Control UI mặc định ở http://127.0.0.1:18789.

Khi nào nên dùng

• Team Discord cần bot trả lời ticket / FAQ nội bộ
• Freelancer muốn Telegram bot tra cứu nhanh khi đang ngoài quán cà phê
• Muốn API key và log nằm trên máy mình, không chỉ trong account chat SaaS

Chưa nên nếu: không có PC luôn bật (gateway cần máy chạy), hoặc chỉ cần hỏi 1–2 câu/ngày trên web UI có sẵn.

---

Môi trường cần có

Yêu cầu	Chi tiết
PC	Mac, Windows hoặc Linux; RAM khuyến nghị ≥ 4GB
Node.js	22+ — tải LTS tại nodejs.org, kiểm tra node --version
Port	18789 cho Control UI — tránh conflict với app khác
API key	Gemini / Anthropic / OpenAI / Groq / OpenRouter / EvoLink, hoặc Ollama local

Không cần biết lập trình sâu — nhưng phải thoải mái copy lệnh vào terminal.

---

Chọn API key (provider)

OpenClaw gọi LLM qua API. Không chắc bắt đầu từ đâu → Anthropic (Claude) được khuyến nghị trong tài liệu gốc; muốn thử miễn phí nhanh thì Gemini hoặc Groq hợp hơn cho beginner VN.

Gemini (bắt đầu miễn phí)

1. Vào Google AI Studio, Sign in bằng Google.
2. Get API key → Create API key.
3. Copy chuỗi dài vào notepad (sẽ paste vào wizard sau).

Anthropic (Claude) — recommended

1. console.anthropic.com → đăng ký / đăng nhập.
2. Menu API Keys → Create Key.
3. Copy và lưu — không hiện lại nếu mất.

OpenAI / Groq / OpenRouter

• OpenAI: platform.openai.com/api-keys → Create new secret key.
• Groq: console.groq.com → API Keys → Create API Key (ví dụ tên openclaw).
• OpenRouter: openrouter.ai → profile → Keys → Create Key.

EvoLink.AI

1. Đăng ký evolink.ai, tạo API key trên dashboard.
2. Khi onboard, chọn provider Skip.
3. Sau đó mở openclaw.json, trong models thêm baseUrl: "https://code.evolink.ai" và key.

Ollama (local 100%)

1. Cài từ ollama.com.
2. Terminal: ollama launch openclaw — script tự cấu hình OpenClaw.
3. Cần máy khỏe (VRAM khoảng 12GB+) nếu muốn chạy mượt.

---

Cài đặt OpenClaw

Mac / Linux

Mở Terminal (Mac: Command + Space → “Terminal”; Linux: Ctrl + Alt + T). Dán:

curl -fsSL https://openclaw.ai/install.sh | bash

Script có thể cài Node.js nếu thiếu. Kiểm tra:

openclaw --version

Thấy số version (ví dụ v2025.2.14) là OK. command not found → đóng Terminal mở lại.

Windows (Quickstart — khuyến nghị)

1. Windows key → gõ powershell → chuột phải → Run as Administrator → Yes.
2. Nới ExecutionPolicy (Windows chặn script mặc định):

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Gõ Y rồi Enter nếu hỏi.

3. Cài OpenClaw:

iwr -useb https://openclaw.ai/install.ps1 | iex

Nếu hỏi cài Node.js → chọn Yes theo hướng dẫn trên màn hình.

Cách khác (đã có Node)

npm install -g openclaw@latest

Sau đó cùng quy trình onboard bên dưới.

---

Onboarding wizard (trả lời từng câu)

Chạy:

openclaw onboard --install-daemon

--install-daemon = tự chạy khi bật máy. Dùng ↑↓ chọn, Enter xác nhận.

Dấu hiệu thành công khi Gateway lên:

• Discord: ok (nếu đã nối Discord)
• Control UI: http://127.0.0.1:18789
• Gateway token: xxxx — dùng đăng nhập Control UI

---

Nối chat app

Discord (10 bước — Intents là điểm chết)

1. Tạo server test nếu chưa có (+ trong Discord).
2. Mở Discord Developer Portal.
3. New Application → tên (ví dụ OpenClaw Bot) → Create.
4. Menu Bot.
5. Reset Token → copy ngay (chỉ hiện một lần) vào notepad.
6. Bắt buộc: cuộn tới Privileged Gateway Intents, bật cả 3 rồi Save Changes:
   • Presence Intent
   • Server Members Intent
   • Message Content Intent
7. OAuth2 → URL Generator → SCOPES: tick bot.
8. BOT PERMISSIONS: Send Messages, Read Messages/View Channels, Read Message History.
9. Copy Generated URL → mở trình duyệt → chọn server → Authorize.
10. Khi onboard hỏi Discord token → paste. Allowlist: chọn Allowlist + tên kênh (ví dụ server/#general).

Kiểm tra: openclaw gateway restart, rồi @BotName xin chào. Bot offline → kiểm lại bước 6. Log code 4014 = Intents tắt.

DM lần đầu: bot trả access not configured. Lấy pairing code trong reply, chạy:

openclaw pairing approve discord PAIRING_CODE

Telegram (8 bước)

1. Mở Telegram → tìm @BotFather (tick xanh).
2. /start → /newbot.
3. Đặt tên hiển thị → username kết thúc bằng bot (ví dụ myopenclaw_bot).
4. Copy token dạng 123456789:ABC....
5. Paste khi onboard hỏi Telegram token.

Sau đó: tìm bot → /start nhận pairing code → terminal mới:

openclaw pairing approve telegram CODE

Gửi tin nhắn thử.

WhatsApp (7 bước + cảnh báo)

openclaw channels login whatsapp

QR hiện trên terminal → WhatsApp điện thoại → Linked Devices → Link a Device → quét QR. Phê duyệt:

openclaw pairing approve whatsapp +84XXXXXXXXX

(thay bằng số của bạn, gồm mã quốc gia).

Cảnh báo sản phẩm: tích hợp WhatsApp có thể dùng thư viện không chính thức (không phải Meta Cloud API) → rủi ro ban account không bằng không. Nên dùng số / account riêng, không dùng số chính khách hàng.

---

Case study ngắn (VN)

Case 1 — Freelancer Discord support

Lan nhận ticket trên Discord server khách. Cài OpenClaw trên laptop Windows, Claude Sonnet làm default, requireMention: true để bot không spam mọi tin. SOUL.md yêu cầu trả lời tiếng Việt, tối đa 5 bullet, không bịa giá. Kết quả: trả lời FAQ lặp trong giờ ngủ máy vẫn chạy daemon.

Case 2 — Sinh viên thử Gemini free

Minh dùng Gemini trên AI Studio (chưa gắn thẻ). Mac + install.sh + QuickStart + Telegram. Lỗi đầu: quên pairing approve → bot im. Chạy openclaw doctor rồi approve code → ổn. Chi phí API ≈ 0 trong giai thử.

---

Tùy chỉnh sau khi chạy được

Đổi config xong luôn:

openclaw gateway restart

SOUL.md — tính cách & luật cứng

Tìm workspace:

cat ~/.openclaw/openclaw.json | grep workspace

Ba khối thường dùng:

1. Personality — giọng (ví dụ: chuyên gia lập trình, thân thiện, vào thẳng kết luận).
2. Core Values — không gửi password ra ngoài; không đoán khi chưa chắc → dùng web search.
3. Long-Term Instructions — báo cáo ≤ 5 bullet; trả lời tiếng Việt; ghi rõ ngôn ngữ khi viết code.

Ví dụ thực tế:

# SOUL.md

Bạn là trợ lý kỹ thuật của tôi.

## Core Values
- Không chào hỏi dài. Vào thẳng câu trả lời.
- Thông tin không chắc → dùng web search, không bịa.

## Instructions
- Trả lời tiếng Việt, Markdown rõ ràng.
- Khi viết code, ghi tên ngôn ngữ (python, typescript…).
- Báo cáo: kết luận → lý do → URL nguồn.

openclaw.json — limit & bảo mật

Mở/sửa bằng openclaw config. Ví dụ hữu dụng:

"limits": { "maxTokensPerDay": 100000 }

"channels": { "discord": { "requireMention": true } }

"allowFrom": ["user:YOUR_DISCORD_USER_ID"]

Lấy Discord user ID: Settings → Advanced → bật Developer Mode → chuột phải avatar → Copy User ID.

---

Troubleshooting thường gặp

Triệu chứng	Cách xử lý
openclaw: command not found	Đóng/mở lại terminal; node --version ≥ 22
Windows chặn script	Set-ExecutionPolicy RemoteSigned -Scope CurrentUser → Y
HTTP 429 / Insufficient balance	Mở http://127.0.0.1:18789 đổi model, hoặc openclaw configure
Discord bot offline	Bật đủ 3 Intents → openclaw gateway restart; log 4014 = Intents
Port 18789 bận	Mac/Linux: sudo lsof -i :18789 · Windows: netstat -ano | findstr 18789
Docker container crash	Docker Desktop → Resources → RAM ≥ 8GB, CPU ≥ 4
Pairing kẹt	openclaw doctor → openclaw gateway restart → lấy code mới
Skill Broken pipe	openclaw doctor rồi cài lại skill

Lệnh chẩn đoán:

openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw configure
openclaw dashboard

---

Checklist trước khi bookmark đóng tab

• node --version ≥ 22
• API key đã lưu notepad (không commit git)
• openclaw --version chạy được
• Onboard QuickStart xong, Control UI mở được
• Discord: 3 Intents ON (nếu dùng Discord)
• Pairing approve cho DM / Telegram / WhatsApp
• SOUL.md tiếng Việt + maxTokensPerDay nếu sợ cháy bill

---

FAQ nhanh

Có cần biết lập trình? Không — copy lệnh trong bài là đủ; cần biết mở terminal/PowerShell.

OpenClaw có phí? Phần mềm miễn phí; API model tính riêng (hoặc free tier / Ollama).

Chỉ dùng Windows được không? Được — Quickstart PowerShell như trên.

Bot Discord không trả lời? Kiểm Intents + gateway restart + allowlist kênh + pairing cho DM.