2. Core Concepts - Chỉ những gì cần biết

Đọc trong 2 phút - Hiểu cách OpenClaw hoạt động để sử dụng hiệu quả.

1. Kiến trúc đơn giản

Bạn ──► Channel (Telegram/WhatsApp) ──► OpenClaw ──► AI (Claude/GPT)
                                        │
                                        ├── Session (nhớ context)
                                        ├── Tools (đọc file, chạy lệnh)
                                        └── Memory (lưu thông tin)

2. Ba khái niệm quan trọng

A. Gateway

• Là gì: Trung tâm điều phối, chạy local trên máy bạn
• Port mặc định: 18789
• Lệnh: openclaw gateway --port 18789

B. Channels

• Là gì: Các kênh nhắn tin kết nối với Gateway
• Ví dụ: Telegram, WhatsApp, Discord, Slack
• Cách dùng: Cấu hình 1 lần, dùng mãi mãi

C. Sessions

• Là gì: Cuộc trò chuyện riêng tư giữa bạn và AI
• Mỗi người: Có session riêng (không chia sẻ context)
• Reset: Dùng /new khi muốn bắt đầu mới
• Lưu ở: ~/.openclaw/sessions/

3. Luồng một tin nhắn

1. Bạn gửi "Phân tích file report.txt"
        ↓
2. Gateway nhận qua Telegram
        ↓
3. Kiểm tra: Bạn có trong allowlist? ✓
        ↓
4. Gửi đến AI với session của bạn
        ↓
5. AI dùng tool `files.read` đọc file
        ↓
6. AI trả lời: "File report.txt có..."
        ↓
7. Gateway gửi lại qua Telegram

4. Cấu hình quan trọng

File config chính

~/.openclaw/openclaw.json

Cấu trúc cơ bản

{
  agent: {
    model: "anthropic/claude-3-opus-20240229",
    apiKey: "${ANTHROPIC_API_KEY}",
  },
  gateway: {
    port: 18789,
    bind: "loopback", // Chỉ localhost
  },
  channels: {
    telegram: {
      botToken: "${TELEGRAM_BOT_TOKEN}",
    },
  },
}

Thư mục dữ liệu

~/.openclaw/
├── openclaw.json      # Config
├── sessions/          # Lịch sử chat
├── credentials/       # Token, keys
└── logs/              # Nhật ký

5. Các lệnh CLI thường dùng

Lệnh	Mục đích
openclaw onboard	Chạy wizard thiết lập
openclaw gateway --port 18789	Khởi động
openclaw config set <key> <value>	Đổi cấu hình
openclaw channels status	Kiểm tra kênh
openclaw doctor	Kiểm tra sức khoẻ
openclaw logs --tail 100	Xem logs

6. Dashboard

Truy cập: http://127.0.0.1:18789/

• Chat với AI
• Xem/cấu hình settings
• Theo dõi sessions và channels

Tiếp theo

• Bài 3: Installation - Cài đặt đầy đủ và Telegram
• Bài 4: Security - Bảo mật: pairing & allowlist