Quick Setup — cài đặt agent bằng 1 lệnh

3:58

Quick Setup là gì?

Quick Setup sinh sẵn cho bạn một dòng lệnh. Dán vào terminal là agent được cấu hình xong: endpoint Beeknoee, API key, model mapping, và streaming bật sẵn.

Hỗ trợ 4 agent:

💡 Windows: OpenClaw và Hermes chạy trong WSL2 — script tự phát hiện và chạy bên trong WSL giúp bạn.

📌 Lấy lệnh cài đặt

1. Vào API Keys
2. Chọn key → nhấn ⚙️ Cấu hình API Key → tab Quick Setup
3. Chọn agent, hệ điều hành, model mapping
4. Nhấn Copy ở khung Lệnh cài đặt → dán vào terminal

🧰 5 công cụ đi kèm

Ngay dưới lệnh cài đặt có khối Công cụ khác — mỗi nút copy ra một lệnh riêng:

1. Xem trước (không ghi gì)

In ra chính xác file nào sẽ bị tạo/sửa và đoạn cấu hình sẽ được thêm, rồi dừng lại. Không đụng vào máy bạn.

Dùng khi: muốn biết trước script làm gì trước khi cho nó chạy.

2. Kiểm tra máy (doctor)

Soi cả 4 agent cùng lúc và báo cáo: đã cài chưa, version bao nhiêu, file cấu hình nằm đâu, đang trỏ về endpoint nào, model gì, streaming đã bật chưa, cấu hình có hợp lệ không, có bản backup không.

• Chỉ đọc — không sửa gì
• Không cần API key
• Key hiện dạng che (sk-bee-abcd...wxyz), không lộ nguyên key

Dùng khi: cài xong mà không chạy, hoặc muốn biết máy đang ở trạng thái nào.

3. Kiểm chứng cấu hình (verify)

Chạy 4 bước kiểm tra miễn phí:

1. File cấu hình đọc/parse được
2. Endpoint Beeknoee còn sống
3. API key hợp lệ (kèm số dư hiện tại)
4. Model đã chọn có tồn tại trong danh mục

Muốn thử stream thật (gửi 1 request rất nhỏ, tốn vài token) thì thêm &paid=1 vào cuối URL trong lệnh — mặc định bước này bị bỏ qua để không trừ tiền ngoài ý muốn.

4. Gỡ riêng cấu hình Beeknoee

Xoá chỉ phần Beeknoee, giữ nguyên provider/model bạn tự thêm sau khi cài.

⚠️ Khác với nút Gỡ cài đặt (khôi phục toàn bộ) ngay bên dưới: nút đó trả toàn bộ file cấu hình về đúng trạng thái trước khi cài Beeknoee — nghĩa là cuốn luôn những thứ bạn thêm vào sau đó.

Về đăng nhập cũ: Quick Setup không bao giờ xoá login (vd .credentials.json của Claude Code), nên sau khi Gỡ riêng, login cũ tự hoạt động lại — không cần làm gì thêm. Chỉ khi trước lúc cài bạn từng dùng ANTHROPIC_AUTH_TOKEN (biến môi trường hoặc trong settings.json) thì mới cần Gỡ cài đặt để khôi phục giá trị đó từ backup.

5. Gỡ cài đặt (khôi phục toàn bộ)

Trả file cấu hình về đúng bản trước khi cài Beeknoee, restore từ bản chụp gốc ~/.<agent>/.beeknoee-backups/original/. Mọi thứ bạn tự thêm sau khi cài (provider khác, chỉnh sửa tay…) cũng bị hoàn về theo.

🔒 Quick Setup an toàn thế nào?

• Sao lưu nguyên bản 1 lần — lần chạy đầu tiên chụp lại cấu hình gốc vào ~/.<agent>/.beeknoee-backups/original/, các lần chạy sau không bao giờ đè lên bản chụp đó. Nhờ vậy lệnh gỡ cài đặt luôn khôi phục được đúng bản gốc thật.
• Chỉ thêm, không thay — provider, model, MCP server, hooks, permissions bạn đang có được giữ nguyên. Ví dụ với Codex, chỉ thêm [model_providers.beeknoee], không đụng vào provider khác hay models.json của bạn.
• Không ghi biến môi trường toàn máy — key nằm trong file cấu hình của riêng agent, không đè lên ANTHROPIC_API_KEY / OPENAI_API_KEY thật mà app khác đang dùng.
• Key để riêng khỏi file cấu hình — với OpenClaw và Hermes, key nằm ở file .env riêng (chmod 600), file cấu hình chỉ tham chiếu ${BEEKNOEE_API_KEY}.
• Không đè statusline — nếu bạn đã tự cấu hình statusline cho Claude Code, script giữ nguyên của bạn.
• Tự nhận version — Codex đổi cách khai báo profile từ bản 0.134; script đọc codex --version rồi ghi đúng kiểu cho bản bạn đang cài.

⚡ Streaming bật sẵn

Sau Quick Setup, agent luôn nhận dữ liệu theo kiểu streaming. Đây không phải chuyện "đẹp hơn" mà là tránh lỗi thật: request không stream mà model suy nghĩ lâu sẽ bị proxy cắt giữa chừng.

Mỗi agent bật streaming một kiểu khác nhau — Quick Setup xử lý sẵn:

⚠️ Không có agent nào dùng field stream=true trong file cấu hình. Tự thêm dòng đó vào có thể làm hỏng file cấu hình.

Nếu bạn đã chạy Quick Setup từ trước ngày 08/08/2026, hãy chạy lại lệnh để nhận khối streaming này — cấu hình cũ không tự cập nhật.

🔧 Cài xong mà không chạy?

Làm theo thứ tự này:

1. Chạy Kiểm tra máy (doctor) → xem agent đã cài chưa, cấu hình trỏ đúng chưa
2. Chạy Kiểm chứng cấu hình (verify) → xem key có hợp lệ, model có tồn tại
3. Vẫn lỗi → xem Xử lý lỗi, hoặc hướng dẫn riêng của agent: Claude Code · Codex CLI · Hermes · OpenClaw

Xem thêm

• Claude Code · Claude Desktop · VS Code
• Xác thực — các cách truyền API key
• Models — danh sách model và ID chính xác