First steps
Tổng quan về quy trình thiết lập ban đầu
OpenClaw có hai lộ trình hướng dẫn thiết lập ban đầu. Cả hai đều cấu hình xác thực, Gateway và các kênh chat tùy chọn — chúng chỉ khác nhau ở cách bạn tương tác với quá trình thiết lập.
Tôi nên dùng lộ trình nào?
| Hướng dẫn thiết lập ban đầu bằng CLI | Hướng dẫn thiết lập ban đầu bằng ứng dụng macOS | |
|---|---|---|
| Nền tảng | macOS, Linux, Windows (native hoặc WSL2) | Chỉ macOS |
| Giao diện | Trình hướng dẫn trong Terminal | UI có hướng dẫn trong ứng dụng |
| Phù hợp nhất cho | Máy chủ, headless, toàn quyền kiểm soát | Mac để bàn, thiết lập trực quan |
| Tự động hóa | --non-interactive cho script |
Chỉ thủ công |
| Lệnh | openclaw onboard |
Khởi chạy ứng dụng |
Hầu hết người dùng nên bắt đầu với hướng dẫn thiết lập ban đầu bằng CLI — nó hoạt động ở mọi nơi và cho bạn nhiều quyền kiểm soát nhất.
Những gì quá trình hướng dẫn thiết lập ban đầu cấu hình
Bất kể bạn chọn lộ trình nào, quá trình hướng dẫn thiết lập ban đầu sẽ thiết lập:
- Nhà cung cấp mô hình và xác thực — API key, OAuth hoặc token thiết lập cho nhà cung cấp bạn chọn
- Workspace — thư mục cho tệp agent, mẫu bootstrap và bộ nhớ
- Gateway — cổng, địa chỉ bind, chế độ xác thực
- Kênh (tùy chọn) — các kênh chat tích hợp sẵn và đi kèm như BlueBubbles, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, Telegram, WhatsApp và nhiều kênh khác
- Daemon (tùy chọn) — dịch vụ nền để Gateway tự động khởi động
Hướng dẫn thiết lập ban đầu bằng CLI
Chạy trong bất kỳ terminal nào:
openclaw onboard
Thêm --install-daemon để cũng cài đặt dịch vụ nền trong một bước.
Tài liệu tham khảo đầy đủ: Hướng dẫn thiết lập ban đầu (CLI)
Tài liệu lệnh CLI: openclaw onboard
Hướng dẫn thiết lập ban đầu bằng ứng dụng macOS
Mở ứng dụng OpenClaw. Trình hướng dẫn chạy lần đầu sẽ đưa bạn qua cùng các bước bằng giao diện trực quan.
Tài liệu tham khảo đầy đủ: Hướng dẫn thiết lập ban đầu (Ứng dụng macOS)
Nhà cung cấp tùy chỉnh hoặc không có trong danh sách
Nếu nhà cung cấp của bạn không có trong danh sách hướng dẫn thiết lập ban đầu, hãy chọn Nhà cung cấp tùy chỉnh và nhập:
- Chế độ tương thích API (tương thích OpenAI, tương thích Anthropic hoặc tự động phát hiện)
- URL cơ sở và API key
- ID mô hình và bí danh tùy chọn
Nhiều endpoint tùy chỉnh có thể cùng tồn tại — mỗi endpoint có ID endpoint riêng.