OpenClaw cho người mới: 5 bước đầu tiên sau khi cài

OpenClaw cho người mới: 5 phút đầu tiên sau khi cài

Cập nhật lần cuối: 20/03/2026 | Phiên bản: 1.0

TL;DR: Cài xong OpenClaw, bạn mở terminal và thấy cursor nhấp nháy. "Giờ làm gì?" Bài viết này là checklist chính xác cho 5 phút đầu tiên — từ lệnh onboard đến tin nhắn đầu tiên với agent. Không lý thuyết dài dòng, chỉ có từng bước cụ thể bạn cần làm ngay.

Bước 1: Chạy Onboarding Wizard

Nếu bạn cài bằng one-line installer, wizard có thể đã chạy tự động. Nếu chưa:

openclaw onboard --install-daemon

Wizard hỏi bạn vài thứ theo thứ tự. Đừng bỏ qua — mỗi bước đều ảnh hưởng đến cách agent hoạt động.

QuickStart hay Advanced?

Chọn QuickStart nếu đây là lần đầu. Nó thiết lập mặc định hợp lý: gateway local (loopback), token auth tự động, tool profile "coding". Bạn luôn có thể chỉnh sau bằng openclaw configure.

Chọn Advanced nếu bạn triển khai trên VPS, muốn bind ra LAN, hoặc cần kiểm soát từng chi tiết.

Chọn AI model và nhập API key

Wizard hỏi bạn dùng provider nào. Các lựa chọn phổ biến:

Anthropic (Claude) — khuyến nghị cho chất lượng tốt nhất. Cần API key từ console.anthropic.com. Key bắt đầu bằng sk-ant-.

Google (Gemini) — tỷ lệ chất lượng/giá tốt, có free tier rộng rãi. Lựa chọn tốt để thử nghiệm mà không tốn tiền.

OpenAI — nếu đã có key sẵn. Key bắt đầu bằng sk-.

Model local (Ollama) — hoàn toàn miễn phí, chạy trên máy bạn. Tốt cho privacy nhưng chất lượng agent thấp hơn model cloud.

Dán API key khi được hỏi. Key được lưu an toàn tại ~/.openclaw/credentials/ với permission 600.

Mẹo chọn model: Nếu mới bắt đầu, dùng Claude Sonnet — cân bằng tốt giữa chất lượng và chi phí. Opus cho reasoning nặng, Haiku cho heartbeat và task nhẹ. Bạn có thể đổi model bất kỳ lúc nào sau này.

Chọn messaging channel

Wizard hỏi bạn muốn kết nối channel nào. Đây là cách bạn sẽ nói chuyện với agent hàng ngày.

Telegram — dễ nhất, khuyến nghị cho lần đầu. Không cần số điện thoại riêng cho bot. Tạo bot qua @BotFather trên Telegram, lấy token, dán vào wizard.

Discord — tốt cho cộng đồng. Cần tạo bot trong Discord Developer Portal.

WhatsApp — phổ biến nhất cho sử dụng cá nhân. Cần quét QR code để link.

Bỏ qua channel cũng được. Bạn vẫn chat được qua Control UI (dashboard web) ngay lập tức. Kết nối channel sau khi mọi thứ ổn định.

Cài daemon

Wizard hỏi có muốn install daemon không. Nói có. Đây là service (LaunchAgent trên macOS, systemd trên Linux) giữ Gateway chạy nền — tự restart khi máy khởi động lại.

Bước 2: Kiểm tra mọi thứ hoạt động

Wizard xong rồi. Trước khi làm bất kỳ thứ gì khác, chạy 3 lệnh kiểm tra:

# Gateway đang chạy?
openclaw gateway status
# Kỳ vọng: "Runtime: running", "RPC probe: ok"

# Có lỗi gì không?
openclaw doctor
# Kỳ vọng: không có lỗi blocking (warning nhẹ thì OK)

# Mở dashboard
openclaw dashboard
# Browser mở ra với Control UI — nếu hỏi token, dán từ:
# openclaw config get gateway.auth.token

Nếu gateway status báo "stopped" → chạy openclaw gateway start. Nếu doctor báo lỗi → chạy openclaw doctor --fix. Nếu dashboard không mở → kiểm tra port 18789 có bị chiếm không.

Khi dashboard hiện lên = Gateway sẵn sàng. Bạn có thể chat trực tiếp ở đây mà không cần kết nối channel.

Bước 3: Tin nhắn đầu tiên — Chạy Bootstrap

Đây là bước mà rất nhiều người mới bỏ qua, rồi hối hận.

OpenClaw tạo sẵn file BOOTSTRAP.md trong workspace — đây là quy trình onboarding cho agent (không phải cho bạn). Nó hướng dẫn agent đặt tên cho mình, thiết lập tính cách, và tìm hiểu về bạn. Nhưng có một gotcha: nếu tin nhắn đầu tiên của bạn là câu hỏi thật ("kiểm tra email đi"), agent sẽ ưu tiên trả lời câu hỏi đó thay vì chạy bootstrap.

Tin nhắn đầu tiên nên là:

Hey, chúng ta hãy thiết lập nhé. Đọc BOOTSTRAP.md và hướng dẫn tôi qua từng bước.

Gửi câu này trong dashboard (hoặc qua Telegram/Discord nếu đã kết nối). Agent sẽ bắt đầu hỏi bạn: tên agent, tính cách mong muốn, thông tin về bạn. Quá trình này mất khoảng 2-3 phút và tạo ra:

IDENTITY.md — tên, emoji, vai trò của agent.
SOUL.md — tính cách, giọng điệu, ranh giới (có thể đã có template sẵn, bootstrap sẽ cập nhật).
USER.md — thông tin về bạn mà agent cần biết.

Trả lời thật. Đây là nền tảng để agent hiểu bạn từ ngày đầu.

Bước 4: Kiểm tra nhanh bảo mật

Mất 30 giây nhưng tránh được rắc rối lớn:

# Gateway chỉ lắng nghe trên localhost?
openclaw config get gateway.bind
# Phải là "loopback" — nếu là "lan" hoặc "0.0.0.0", sửa ngay:
# openclaw config set gateway.bind loopback
# openclaw gateway restart

# Auth đã bật?
openclaw config get gateway.auth.mode
# Phải là "token" hoặc "password" — không phải "none"

# DM policy an toàn?
openclaw doctor
# Doctor sẽ cảnh báo nếu DM policy quá mở

Nếu bạn trên VPS cần truy cập từ xa: dùng SSH tunnel hoặc Tailscale, không mở port trực tiếp.

Bước 5: Cuộc trò chuyện thật đầu tiên

Bootstrap xong, bảo mật OK. Giờ hãy nói chuyện thật với agent. Mục tiêu không phải năng suất — mà là làm quen.

Thử những thứ đơn giản:

Hôm nay thời tiết ở Hà Nội thế nào?

Tóm tắt bài viết này cho tôi: [dán URL]

Giải thích cho tôi hiểu Docker là gì, dùng ngôn ngữ đơn giản.

Mỗi tương tác giúp bạn hiểu agent phản hồi thế nào, nhanh hay chậm, giọng điệu có đúng ý không. Nếu thấy agent trả lời quá dài hoặc quá formal, nói luôn: "Trả lời ngắn hơn" hoặc "Nói thoải mái hơn đi." Tốt hơn nữa: "Cập nhật USER.md: tôi thích câu trả lời ngắn gọn, đi thẳng vào vấn đề."

Sau 5 phút: Những gì nên làm tiếp

Bạn đã có agent hoạt động. Đây là thứ tự ưu tiên cho những giờ tiếp theo:

Ngay bây giờ (5-15 phút nữa)

Mở và chỉnh workspace files. Vào ~/.openclaw/workspace/ và xem các file agent đã tạo. Chỉnh SOUL.md nếu tính cách chưa đúng ý. Bổ sung USER.md với thông tin công việc, múi giờ, công cụ bạn dùng.

# Xem workspace
ls ~/.openclaw/workspace/

# Chỉnh file (dùng editor bất kỳ)
nano ~/.openclaw/workspace/SOUL.md
nano ~/.openclaw/workspace/USER.md

Backup workspace bằng Git. Đây là trí nhớ và tính cách agent — hãy đối xử như code.

cd ~/.openclaw/workspace
git init
git add AGENTS.md SOUL.md USER.md IDENTITY.md TOOLS.md
git commit -m "Initial workspace setup"
# Thêm remote private repo nếu muốn backup cloud

Trong ngày đầu

Kết nối channel nếu chưa. Telegram là ổn định nhất. Sau khi kết nối, DM đầu tiên sẽ yêu cầu pairing code — approve qua CLI:

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

Tắt heartbeat nếu chưa sẵn sàng. Mặc định heartbeat chạy mỗi 30 phút. Nếu chưa viết HEARTBEAT.md, nó vẫn chạy và tốn token mà không làm gì hữu ích:

# Tắt heartbeat tạm thời
openclaw config set agents.defaults.heartbeat.every "0m"
openclaw gateway restart

# Bật lại khi đã viết HEARTBEAT.md

Trong tuần đầu

Nói chuyện mỗi ngày. Không cần task phức tạp — hỏi thời tiết, nhờ tóm tắt bài báo, thảo luận ý tưởng. Mỗi ngày tương tác giúp agent tích lũy context trong memory.

Viết HEARTBEAT.md đầu tiên. Bắt đầu nhỏ:

# Heartbeat checklist
- [ ] Kiểm tra xem có email chưa đọc quan trọng không
- [ ] Nếu không có gì cần chú ý, trả lời HEARTBEAT_OK

Bật heartbeat lại: openclaw config set agents.defaults.heartbeat.every "30m".

Tạo cron job đầu tiên. Một morning briefing là khởi đầu tốt:

openclaw cron add \
  --name "Morning brief" \
  --cron "0 7 * * *" \
  --session isolated \
  --message "Briefing sáng: thời tiết, lịch hôm nay, và bất kỳ thứ gì cần chú ý." \
  --announce

Chủ động yêu cầu agent ghi nhớ. Khi đưa ra quyết định hoặc sở thích, nói rõ: "Ghi nhớ điều này vào MEMORY.md." Đừng giả định agent tự nhớ — chỉ dẫn bằng lời sẽ biến mất sau compaction.

Checklist tham khảo nhanh

✅ Chạy openclaw onboard --install-daemon
✅ Chọn model + nhập API key
✅ Kết nối ít nhất 1 channel (hoặc dùng dashboard)
✅ openclaw gateway status → "running"
✅ openclaw doctor → không lỗi blocking
✅ Gửi tin nhắn đầu tiên: "Đọc BOOTSTRAP.md và thiết lập"
✅ Kiểm tra gateway.bind = loopback
✅ Kiểm tra gateway.auth.mode = token
✅ Mở và xem workspace files (~/.openclaw/workspace/)
✅ Git init workspace để backup

Lỗi thường gặp trong 5 phút đầu

Lỗi	Nguyên nhân	Cách sửa nhanh
"command not found: openclaw"	PATH chưa cập nhật	Mở terminal mới hoặc `source ~/.zshrc`
Dashboard hỏi token	Token chưa được dán	`openclaw config get gateway.auth.token` → copy → paste vào UI
DM đầu tiên trên Telegram không có phản hồi	Pairing chưa approve	`openclaw pairing list telegram` → `openclaw pairing approve telegram <CODE>`
Agent trả lời nhưng không biết tên bạn	Bootstrap chưa chạy	Gửi: "Đọc BOOTSTRAP.md và hướng dẫn tôi thiết lập"
"auth not configured"	API key thiếu hoặc sai	Chạy lại `openclaw configure` hoặc kiểm tra key
Gateway "stopped" sau khi đóng terminal	Daemon chưa install	`openclaw gateway install` rồi `openclaw gateway start`
Agent quá chậm	Model quá lớn hoặc mạng yếu	Thử model nhỏ hơn (Sonnet thay Opus) hoặc kiểm tra kết nối API

Câu hỏi thường gặp

Q: Tôi cần trả tiền gì?
A: OpenClaw miễn phí và mã nguồn mở. Chi phí duy nhất là API key cho model AI. Claude Sonnet khoảng $2-5/ngày cho sử dụng vừa phải. Gemini có free tier rộng rãi. Model local qua Ollama hoàn toàn miễn phí nhưng chất lượng thấp hơn.

Q: Tôi không phải developer — có dùng được không?
A: Được. OpenClaw có TUI (Terminal UI) và dashboard web. Sau khi cài xong, phần lớn tương tác là nhắn tin qua chat — giống nhắn tin cho bạn bè. Bạn không cần viết code.

Q: Tôi có thể đổi model sau không?
A: Hoàn toàn. Chạy openclaw configure hoặc chỉnh trực tiếp trong ~/.openclaw/openclaw.json. OpenClaw hỗ trợ nhiều provider đồng thời — bạn có thể dùng Sonnet cho chat, Haiku cho heartbeat, và Opus cho coding.

Q: Cần VPS không?
A: Không bắt buộc. Chạy trên laptop hoàn toàn được cho việc thử nghiệm. Nhưng trên laptop, agent tắt khi máy sleep. Nếu muốn agent luôn bật 24/7, host trên VPS ($5-15/tháng) hoặc Mac Mini để ở nhà.

Q: Có cần kết nối WhatsApp/Telegram ngay không?
A: Không. Dashboard web (Control UI) cho phép chat ngay mà không cần kết nối channel nào. Kết nối channel khi bạn đã quen với agent.

Xem thêm

Nguồn tham khảo: OpenClaw Docs, GitHub openclaw/openclaw, DEV Community, Aman Khan, OpenClaw Cheatsheet, OpenClaw Roadmap
Ngày đăng: 20/03/2026 | Tác giả: Đội ngũ Openclaw