Điều Gì Sẽ Xảy Ra Trong Phần Này
Bạn sẽ đăng ký từng agent với OpenClaw và giao cho chúng lệnh đầu tiên. Khi hoàn thành, cả 6 agent sẽ hoạt động — báo cáo lên các kênh Discord của chúng và sẵn sàng nhận hướng dẫn từ bạn.
Hai cách để giao tiếp với các agent của bạn:
| Phương thức | Phù hợp nhất cho | Cách hoạt động |
|---|---|---|
| OpenGoat UI | Người mới bắt đầu — giao diện trực quan | Dashboard trên trình duyệt, nhấp để chọn agent, nhập tin nhắn |
| VS Code terminal | Khuyến nghị — nhanh hơn, kiểm soát tốt hơn | openclaw agent --agent [id] "tin nhắn của bạn" |
Cả hai phương thức đều hoạt động. Hãy bắt đầu với cách nào bạn cảm thấy thoải mái hơn.
Cách tiếp cận được khuyến nghị — kết hợp với AI: Khi mới bắt đầu, hãy mở cửa sổ Chat AI của bạn song song với các agent của bạn. Nếu một lệnh không hoạt động hoặc bạn không chắc nên nhập gì, hãy mô tả tình huống cho AI và nhờ trợ giúp. Đây chính xác là cách hầu hết mọi người — kể cả đội ngũ BALIA OS — vận hành trong giai đoạn đầu. Bạn không cần thành thạo terminal ngay từ ngày đầu. Cửa sổ Chat AI luôn ở đó như người đồng hành của bạn.
Cách Thực Hiện Phần Này
Dán prompt bên dưới vào Chat AI của bạn. AI sẽ hướng dẫn bạn từng bước đăng ký cả 6 agent và gửi lệnh đầu tiên đến từng agent. Đính kèm Tài Liệu Thiết Kế Nhóm của bạn để AI biết ID agent và đường dẫn workspace.
Nếu có sự cố, hãy mô tả lỗi hoặc chụp ảnh màn hình và chia sẻ — AI sẽ giúp bạn khắc phục.
▶ Dán cái này vào AI của bạn để bắt đầu
Đính kèm Tài Liệu Thiết Kế Nhóm trước khi gửi.
Bạn đang giúp tôi đăng ký và khởi động nhóm đa agent BALIA OS của
tôi trên OpenClaw.
Tôi đã đính kèm Tài liệu Thiết kế Nhóm. Hãy đọc nó để lấy ID và tên
các agent của tôi trước khi bắt đầu.
Trước khi bắt đầu, hãy hỏi tôi:
"Tên người dùng Windows của bạn là gì? (Tên trong C:\Users\[tên
người dùng])"
Dùng tên người dùng đó trong mọi đường dẫn file trong suốt phiên
này.
Tất cả các file agent của tôi đều nằm dưới $env:USERPROFILE/.opengoat/
Hướng dẫn tôi từng bước. Mỗi lần một bước. Nếu tôi gặp lỗi, hãy
giúp tôi sửa trước khi tiếp tục. Nếu tôi bị mắc kẹt, hãy yêu cầu
tôi chia sẻ ảnh chụp màn hình hoặc dán thông báo lỗi.
Đây là những gì chúng ta cần làm:
BƯỚC 1 — Khởi động gateway
Nói với tôi: "Chúng ta sẽ khởi động gateway của OpenClaw bằng một
lệnh lọc bỏ các log nền ồn ào để terminal luôn dễ đọc."
Hướng dẫn tôi mở một tab terminal VS Code mới và chạy lệnh đúng
cho hệ điều hành của tôi (hỏi tôi đang dùng hệ điều hành nào nếu
bạn chưa biết):
Windows:
$env:DEBUG="-ciao*"; openclaw gateway --force
Mac:
DEBUG="-ciao*" openclaw gateway --force
Giải thích lệnh này làm gì:
"Phần DEBUG='-ciao*' ẩn các log khám phá mạng nền mà nếu không sẽ
làm ngập terminal. Cờ --force xóa mọi phiên bản gateway trước đó.
Terminal của bạn sẽ luôn gọn gàng và dễ đọc."
Yêu cầu tôi xác nhận thấy: "✓ Gateway running on port 18789"
Nói với tôi hãy để tab terminal này mở — gateway phải luôn chạy.
Nếu có lỗi, giúp tôi sửa trước khi tiếp tục.
BƯỚC 2 — Đăng ký từng agent với OpenClaw
Trước tiên hãy giải thích:
"Chạy lệnh này thực hiện hai việc: nó đăng ký agent với OpenClaw,
và tự động tạo config.json cùng models.json của agent đó dưới
agents/[agentid]/. Bạn không cần tự tạo các file này."
Với mỗi trong 6 agent của tôi (đọc ID từ Tài liệu Thiết kế Nhóm),
hướng dẫn tôi chạy lệnh này trong terminal VS Code:
Windows:
openclaw agents add [agentid] --workspace $env:USERPROFILE\.opengoat\workspaces\[agentid]
Mac:
openclaw agents add [agentid] --workspace ~/.opengoat/workspaces/[agentid]
Ví dụ (Windows): openclaw agents add marcus --workspace C:\Users\john\.opengoat\workspaces\marcus
(marcus chỉ là ví dụ — hãy thay bằng ID agent thật của bạn từ Tài
liệu Thiết kế Nhóm.)
Hiển thị cả 6 lệnh cùng lúc với ID agent thật và tên người dùng
của tôi đã được điền sẵn.
Yêu cầu tôi chạy từng lệnh một và xác nhận mỗi lệnh thành công
trước khi hiển thị lệnh tiếp theo.
Sau khi cả 6 đã được đăng ký, hướng dẫn tôi xác minh:
openclaw agents list
Yêu cầu tôi xác nhận cả 6 agent đều xuất hiện trong danh sách.
BƯỚC 2b — Xác minh đăng ký Người Bảo Vệ An Ninh
Người Bảo Vệ An Ninh đã được đăng ký với OpenClaw ở Phần 4.
Hướng dẫn tôi xác minh nó đang có mặt:
openclaw agents list
Yêu cầu tôi xác nhận security-guardian xuất hiện trong danh sách.
Nếu nó không có, hướng dẫn tôi chạy:
Windows:
openclaw agents add security-guardian --workspace $env:USERPROFILE\.opengoat\workspaces\security-guardian
Mac:
openclaw agents add security-guardian --workspace ~/.opengoat/workspaces/security-guardian
Sau đó xác minh lại danh sách trước khi tiếp tục.
BƯỚC 3 — Khởi động lại gateway
Sau khi đăng ký các agent, gateway cần khởi động lại để tải chúng.
Hướng dẫn tôi chạy:
openclaw gateway restart
Yêu cầu tôi xác nhận gateway đang chạy lại trước khi tiếp tục.
BƯỚC 4 — Khởi động Người Bảo Vệ An Ninh (PM2)
Người Bảo Vệ An Ninh chạy liên tục ở chế độ nền bằng PM2.
Hướng dẫn tôi khởi động nó:
pm2 start $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\guardian.js --name security-guardian
(Mac: thay đường dẫn bằng
~/.opengoat/workspaces/security-guardian/scripts/guardian.js)
Sau đó lưu danh sách tiến trình PM2 để nó tự động khởi động lại
khi khởi động máy:
pm2 save
Yêu cầu tôi xác nhận thấy Người Bảo Vệ An Ninh trong danh sách PM2:
pm2 list
Sau đó yêu cầu tôi xác nhận thấy một thông báo khởi động trong
kênh Discord #security-channel.
BƯỚC 5 — Gửi lệnh đầu tiên qua terminal VS Code (khuyến nghị)
Trước tiên hãy giải thích:
"Terminal VS Code là cách được khuyến nghị để nói chuyện với các
agent của bạn. Lệnh đó là:
openclaw agent --agent [agentid] 'tin nhắn của bạn ở đây'
Lệnh này gửi tin nhắn trực tiếp đến agent cụ thể đó."
Hướng dẫn tôi gửi một lệnh thử nghiệm đến agent đầu tiên:
openclaw agent --agent [agentid-đầu-tiên] 'Hãy giới thiệu bản thân
và xác nhận bạn đã đọc SOUL.md, AGENTS.md, IDENTITY.md,
HEARTBEAT.md, TOOLS.md và USER.md của mình.
Sau đó báo cáo lên kênh Discord của bạn rằng bạn đang trực tuyến.'
Hỏi tôi: "Agent đã phản hồi gì?
Bạn có thấy tin nhắn xuất hiện trong kênh Discord của nó không?"
Nếu có: tốt — chuyển sang agent tiếp theo.
Nếu không: giúp tôi khắc phục.
Lặp lại cho cả 6 agent.
BƯỚC 6 — (Tùy chọn) Thiết lập OpenGoat UI
Sau khi cả 6 agent đã được xác nhận hoạt động qua terminal, hãy đề
xuất:
"Bạn cũng có thể nói chuyện với các agent của mình qua OpenGoat
UI — một dashboard trực quan trên trình duyệt.
Bạn có muốn thiết lập nó luôn không?
Nó cho bạn một giao diện có thể nhấp để chọn agent và gửi tin nhắn
mà không cần gõ lệnh terminal."
Nếu có: hướng dẫn tôi:
1. Mở một tab terminal VS Code mới
2. Chạy: opengoat start
3. Trình duyệt sẽ tự động mở với OpenGoat UI
Hướng dẫn tôi qua giao diện — cách chọn một agent và gửi tin nhắn.
(Nếu trình duyệt không tự động mở, vào http://localhost:19123)
Nếu không: bỏ qua và chuyển sang Bước 7.
BƯỚC 7 — Xác nhận cuối cùng
Cùng tôi rà soát danh sách kiểm tra này:
□ Cả 6 agent đã được đăng ký (openclaw agents list hiển thị đủ 6)
□ Người Bảo Vệ An Ninh đã được đăng ký (security-guardian xuất
hiện trong danh sách)
□ Người Bảo Vệ An Ninh đang chạy trong PM2 (pm2 list hiển thị
online)
□ Gateway đang chạy (cổng 18789)
□ Mỗi agent đã phản hồi lệnh đầu tiên
□ Mỗi agent đã đăng lên kênh Discord của mình
□ (Tùy chọn) OpenGoat UI có thể truy cập tại localhost:19123
BƯỚC 8 — Tạo CLAUDE.md
Sau khi cả 6 agent (bao gồm Người Bảo Vệ An Ninh) đã được xác nhận
đăng ký và đang chạy, hướng dẫn tôi tạo CLAUDE.md — file hướng dẫn
mà Claude Code tự động đọc khi bắt đầu mỗi phiên:
"Bây giờ hãy tạo CLAUDE.md của bạn. File này được tạo tự động từ
thiết lập nhóm bạn đã hoàn thành, nên bạn không cần điền gì thủ
công."
Windows:
cd $env:USERPROFILE\.opengoat\workspaces\security-guardian
node generate_claude_md.js
Mac:
cd ~/.opengoat/workspaces/security-guardian
node generate_claude_md.js
Yêu cầu tôi xác nhận thấy một thông báo kết thúc gần giống như:
[OK] CLAUDE.md generated: (đường dẫn của bạn)\.opengoat\CLAUDE.md
Nếu CLAUDE.md đã tồn tại, script sẽ tự động sao lưu nó trước, sau
đó hỏi có ghi đè hay không. "yes" sẽ ghi đè (đã có bản sao lưu);
"no" sẽ lưu nội dung mới thành CLAUDE_generated_draft.md, giữ
nguyên file CLAUDE.md hiện tại hoàn toàn không đổi.
Nếu được hỏi về gói đã mua (T1 / T2 / T3), hướng dẫn tôi nhập đúng
gói thực tế của mình.
Sau khi tạo xong, yêu cầu tôi mở
$env:USERPROFILE\.opengoat\CLAUDE.md và xác nhận tên và vai trò
nhóm hiển thị chính xác.
Khi tất cả các ô đã được đánh dấu, hãy nói:
"Đội nhóm BALIA OS của bạn đã hoạt động. Cả 6 agent đang chạy và
báo cáo lên Discord. Bạn đã sẵn sàng cho Phần 6 — Xây Dựng Skill
Đầu Tiên Của Bạn."
Bắt đầu ngay bây giờ. Hỏi tôi câu hỏi đầu tiên.Về CLAUDE.md
File CLAUDE.md được tạo ở BƯỚC 8 là một file hướng dẫn mà Claude Code trong VS Code tự động đọc khi bắt đầu mỗi phiên. Nó được tạo ra vào đúng thời điểm này — ngay sau khi tất cả các agent đã được xác nhận đăng ký và đang chạy — trực tiếp dưới $env:USERPROFILE.opengoat.
Những gì được tự động bao gồm:
- Một bảng thành phần nhóm (tên và vai trò của cả 6 agent)
- Việc cấm tuyệt đối các thao tác phá hoại (yêu cầu xác nhận trước khi xóa/ghi đè file, v.v.)
- Cách xử lý thông tin nhạy cảm (không hiển thị khóa API, webhook, v.v. dưới dạng văn bản thuần)
- Quy tắc ngôn ngữ đầu ra
Tùy chỉnh: Mọi thứ bên dưới phần ## Feel free to customize everything below this line ở cuối file là của bạn để chỉnh sửa — thêm quy tắc riêng cho dự án, các lệnh thường dùng, hoặc bất cứ điều gì hữu ích khác.
Hai phần gần đầu file — ## Absolute Prohibition on Destructive Operations (Critical — Always Follow — Do Not Delete) và ## Handling of Sensitive Information (Do Not Delete) — là các quy tắc an toàn cốt lõi. Chúng hiển thị bằng ngôn ngữ bạn đã chọn (hỗ trợ 20 ngôn ngữ). Không xóa hoặc chỉnh sửa hai phần này.
Nếu CLAUDE.md đã tồn tại: Chạy BƯỚC 8 sẽ không bao giờ âm thầm ghi đè lên một CLAUDE.md đã tồn tại. Script sẽ tự động sao lưu nó trước, sau đó hỏi có ghi đè hay không. Trả lời "no" thì file hiện có sẽ hoàn toàn không bị thay đổi — nội dung mới được tạo sẽ được lưu riêng thành CLAUDE_generated_draft.md.
Giao Tiếp Với Các Agent Hàng Ngày
Sau khi mọi thứ đã được thiết lập, đây là cách bạn đưa ra lệnh:
Khởi động gateway (làm việc này trước, mỗi phiên làm việc):
Windows:
$env:DEBUG="-ciao*"; openclaw gateway --forceMac:
DEBUG="-ciao*" openclaw gateway --forceĐể tab terminal này tiếp tục chạy. Mở tab mới cho các lệnh khác.
Qua VS Code terminal:
# Nói chuyện với một agent cụ thể
openclaw agent --agent marcus "Tóm tắt những gì bạn đã làm hôm nay"
# Kiểm tra danh sách agent
openclaw agents list
# Khởi động lại gateway nếu cần
openclaw gateway restart
marcuschỉ là ví dụ — hãy thay bằng ID agent thật của bạn (ví dụ--agent ceohoặc--agent nova).
Qua OpenGoat UI:
- Mở một tab terminal VS Code mới
- Chạy:
opengoat start - Trình duyệt tự động mở với OpenGoat UI
- Chọn agent từ bảng điều hướng bên trái
- Nhập tin nhắn và nhấn Enter (Nếu trình duyệt không tự động mở: truy cập http://localhost:19123)
Qua Discord (chỉ để đọc báo cáo — không dùng để ra lệnh): Discord là nơi các agent đăng báo cáo của chúng. Bạn đọc các cập nhật tại đây. Việc gửi lệnh cho agent qua Discord yêu cầu một Discord Bot — đây là thiết lập nâng cao không được đề cập trong T1. Hãy sử dụng VS Code terminal hoặc OpenGoat UI để ra lệnh cho đến lúc đó.
Nếu Một Agent Không Phản Hồi
Kiểm tra theo thứ tự sau:
Gateway có đang chạy không?
openclaw gateway restartAgent đã được đăng ký chưa?
openclaw agents listNếu agent của bạn không xuất hiện trong danh sách, hãy chạy lại lệnh
agents addtừ Bước 2.Các file workspace có đúng vị trí không?
Kiểm tra xem SOUL.md, AGENTS.md và IDENTITY.md có tồn tại trong:
Windows:
$env:USERPROFILE\.opengoat\workspaces\[agentid]\Mac:
~/.opengoat/workspaces/[agentid]/Khóa API đã được thiết lập đúng chưa? Mở
.env(trong thư mục.opengoatcủa bạn) và xác nhậnANTHROPIC_API_KEYđã được điền vào.
Nếu bạn vẫn bị mắc kẹt, hãy dán thông báo lỗi vào Chat AI của bạn và nhờ trợ giúp.
Xác Minh Thiết Lập Của Bạn
Sau khi tất cả agent đã được xác nhận hoạt động, hãy chạy:
Windows:
node $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\verify_setup.js --section 5Mac:
node ~/.opengoat/workspaces/security-guardian/scripts/verify_setup.js --section 5Điều này xác nhận cả 6 agent đã được đăng ký, Người Bảo Vệ An Ninh đang chạy, và bạn đã sẵn sàng cho Phần 6.