Nhảy tới nội dung

🚀 Bắt đầu nhanh (5 phút)

Bắt đầu với OpenClaw trong vòng 5 phút! Hướng dẫn này sẽ giúp bạn cài đặt và chạy bot đầu tiên của mình.

ĐỌC KỸ TRƯỚC KHI BẮT ĐẦU
  • An toàn là trên hết: Đảm bảo bạn đã đọc Security Alerts.
  • Môi trường: Chỉ cài trên máy ảo (VM) hoặc VPS riêng. Không dùng máy tính làm việc chính để test.
  • Thông tin xác thực: Không sử dụng mật khẩu/API key môi trường production.

🛠️ Chuẩn bị​

Yêu cầu tối thiểu​

  • OS: macOS, Linux, hoặc Windows (WSL2)
  • Runtime: Node.js v22.x trở lên
  • Memory: 2GB RAM (4GB Recommended)
  • Key: Anthropic Claude API Key
[Check Node version]
node --version  # Should be v22.x or higher
npm --version

Nếu chưa có Node 22, xem Cài đặt Node.js

Bước 1: Cài đặt OpenClaw CLI​

Cách nhanh nhất để cài đặt OpenClaw với official script.

```bash curl -fsSL https://openclaw.ai/install.sh | bash ```
<Admonition type="info" title="Tại sao dùng install script?">
  <ul>
    <li>Auto-detect platform</li>
    <li>Install đúng version</li>
    <li>Setup PATH automatically</li>
    <li>Nhanh hơn npm</li>
  </ul>
</Admonition>

Kiểm tra cài đặt:

openclaw --version

Bước 2: Onboarding (Thiết lập ban đầu)​

Chạy trình hướng dẫn tự động:

openclaw onboard --install-daemon

Điều này sẽ:

  • ✅ Tạo cấu trúc thư mục cho OpenClaw
  • ✅ Yêu cầu bạn nhập API key (Anthropic)
  • ✅ Setup daemon process
  • ✅ Tạo config files
[Lấy API key]
  1. Đăng ký tại console.anthropic.com
  2. Tạo API key trong Settings
  3. Copy và paste khi được hỏi
  4. Lưu ý: Bạn sẽ trả theo usage (pay-as-you-go)

Bước 3: Khởi động Gateway​

Gateway là trung tâm điều khiển của OpenClaw:

openclaw gateway --port 18789

Output mong đợi:

✓ Gateway started at http://localhost:18789
✓ Dashboard available at http://localhost:18789/dashboard
✓ Ready to accept connections
Chạy nền (Background Mode)
```bash # Linux/macOS nohup openclaw gateway --port 18789 & ```

Bước 4: Kết nối kênh chat​

Đơn giản nhất, setup trong 1 phút.

```bash openclaw channels login telegram ``` **Hướng dẫn:** 1. Tạo bot mới qua [@BotFather](https://t.me/BotFather) 2. Gửi `/newbot` và làm theo hướng dẫn 3. Copy bot token 4. Paste vào OpenClaw CLI

Bước 5: Thử nghiệm đầu tiên​

```bash openclaw chat ``` **Gõ thử:** ``` You: Xin chào! Bạn là ai? Bot: Chào bạn! Tôi là trợ lý AI chạy trên máy của bạn... ```

Bước 6: Thử tính năng thực tế​

File Management​

Bạn: Liệt kê 5 file mới nhất trong thư mục Downloads của tôi

Bot sẽ:

  1. Truy cập thư mục Downloads
  2. List files
  3. Gửi lại kết quả

Calendar Check (nếu đã setup)​

Bạn: Hôm nay lịch của tôi có gì?
Bạn: Tìm tin tức mới nhất về AI agents

Dashboard Web​

Mở browser và truy cập: http://localhost:18789/dashboard

  • 📊 Sessions: Các cuộc hội thoại active
  • 🔌 Channels: Kênh đã kết nối
  • 📝 Logs: Real-time logs
  • ⚙️ Settings: Cấu hình

Troubleshooting nhanh​

Gateway không start được
Check port có bị chiếm không: ```bash netstat -tuln | grep 18789 ``` Hoặc dùng port khác: ```bash openclaw gateway --port 19000 ```
Chat không phản hồi
1. Check gateway đang chạy: `ps aux | grep openclaw` 2. Check logs: `openclaw logs` 3. Verify API key still valid
"Permission denied" errors
Cấp quyền cho CLI: ```bash chmod +x $(which openclaw) ```

Next Steps​

🎉 Chúc mừng! Bạn đã có OpenClaw chạy được rồi!

Tiếp theo nên làm:​

  1. Đọc Kiến trúc OpenClaw - Hiểu cách OpenClaw hoạt động
  2. Setup Tính năng nâng cao - Plugins, hooks, automation
  3. Xem Use Cases - Học từ cộng đồng
  4. Bảo mật: Đọc kỹ Security Best Practices

Join cộng đồng:​

Appendix: Cài đặt Node.js​

```bash # Dùng NodeSource curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs # Verify node --version # v22.x ```
[Pro Tips]
  • Setup PM2 để auto-restart gateway khi server reboot
  • Dùng tmux/screen để chạy gateway trong background
  • Backup config folder định kỳ
  • Monitor API usage trên Anthropic dashboard