Phần 4: Tạo Các File Agent

Bạn Đang Xây Dựng Gì

Mỗi agent cần một bộ file để hoạt động đúng cách. OpenClaw tự động đọc các file cốt lõi khi bắt đầu phiên làm việc. Các file workspace bổ sung cung cấp cho từng agent bối cảnh, nhiệm vụ định kỳ và quy tắc sử dụng công cụ.

Cấu hình agent — được OpenClaw tự động tạo, không phải thứ bạn tự tạo ở đây:

File	Vị trí	Mục đích
`config.json`	`agents/[id]/config.json`	Định nghĩa agent của OpenClaw, system prompt
`models.json`	`agents/[id]/models.json`	Cài đặt AI model

Bạn không tạo các file này trong Phần 4. Việc chạy openclaw agents add [id] --workspace ... ở Phần 5 sẽ tự động tạo cả hai file này khi bạn đăng ký từng agent — ở đây bạn chỉ cần biết rằng chúng tồn tại.

File workspace — tự động tải bởi OpenClaw mỗi phiên:

File	Mục đích
`SOUL.md`	Tính cách, giọng điệu, giới hạn cứng, sứ mệnh — giữ dưới 400 từ
`AGENTS.md`	Quy tắc vận hành, quy trình báo cáo — giữ dưới 400 từ
`IDENTITY.md`	Tên, vai trò, người quản lý — chỉ thông tin thực tế, giữ ngắn gọn
`HEARTBEAT.md`	Nhiệm vụ luôn hoạt động, tác vụ định kỳ, phản ứng khi có bất thường
`TOOLS.md`	Công cụ được phép dùng, quy tắc skill, hành động bị cấm
`USER.md`	Sở thích của Chỉ huy, phong cách giao tiếp, múi giờ

File chi tiết vai trò — đọc một lần mỗi phiên theo hướng dẫn trong AGENTS.md:

File	Mục đích
`SPEC_[TÊN].md`	Vai trò chi tiết, trách nhiệm, đường dẫn quan trọng

Chỉ dành cho CEO — thư mục identity:

File	Mục đích
`identity/COMPANY_PROFILE.md`	Thông tin nền tảng công ty, chi tiết kinh doanh
`identity/PERSONAL_PROFILE.md`	Nền tảng, kỹ năng, kinh nghiệm của chủ sở hữu
`identity/VALUES.md`	Phong cách tư duy, giá trị, nguyên tắc ra quyết định

Cấu trúc workspace đầy đủ — tất cả agent:

INFO

$env:USERPROFILE/.opengoat/ ├── agents/ │ └── [agentid]/ │ ├── config.json ← tự động tạo ở Phần 5 │ └── models.json ← tự động tạo ở Phần 5 └── workspaces/ └── [agentid]/ ├── SOUL.md ← tự động tải ├── AGENTS.md ← tự động tải ├── IDENTITY.md ← tự động tải ├── HEARTBEAT.md ← tự động tải ├── TOOLS.md ← tự động tải ├── USER.md ← tự động tải └── SPEC_[TÊN].md ← đọc theo hướng dẫn trong AGENTS.md

Workspace của CEO — thêm thư mục identity:

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ├── PERSONAL_PROFILE.md └── VALUES.md

Cách Hoạt Động Của Phần 4

Trong phần này, bạn sẽ làm việc với AI concierge để thiết kế từng agent. Với mỗi agent, bạn sẽ quyết định:

Tên và vai trò
Tính cách và phong cách giao tiếp
Những công cụ nào họ có thể sử dụng

Sau khi hoàn thiện thiết kế với AI concierge, Người Bảo Vệ An Ninh của bạn sẽ tự động viết các file cấu hình. Bạn không cần chỉnh sửa file nào bằng tay.

Cách Hoạt Động Của Phần Này — Hai Phần

Phần này có hai phần. Hoàn thành theo đúng thứ tự:

Phần 1 — Thiết lập Discord (prompt bên dưới) Tạo máy chủ Discord, các kênh, và lấy URL Webhook cho từng agent. Mất khoảng 10 phút.

Phần 2 — File Agent (prompt tiếp theo) Tạo các file agent thực tế bằng cách sử dụng Tài liệu Thiết kế Nhóm của bạn. AI sẽ tạo ra các lệnh terminal — dán chúng vào VS Code để tự động tạo file.

Bắt đầu với Phần 1 ngay.

URL Webhook Discord — Lấy Trước Tiên

Mỗi agent báo cáo về kênh Discord riêng của nó thông qua một URL Webhook. Bạn cần có các URL này trước khi viết các file AGENTS.md.

▶ 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 của bạn trước khi gửi.

Bạn đang giúp tôi thiết lập các kênh Discord và URL Webhook cho
nhóm đa agent BALIA OS của tôi.

Hướng dẫn tôi từng bước. Hỏi một câu hỏi mỗi lần.
Nếu tôi gặp khó khăn, hãy yêu cầu tôi chụp ảnh màn hình và mô tả
những gì tôi thấy.

Tôi đã đính kèm Tài liệu Thiết kế Nhóm của mình.

BƯỚC 1 — Kiểm tra Discord
Hỏi: "Bạn đã cài đặt Discord và có tài khoản chưa?"
Nếu chưa: hướng dẫn tôi đến discord.com để tải xuống và tạo tài
khoản.
Nếu rồi: chuyển sang Bước 2.

BƯỚC 2 — Tạo một máy chủ Discord
Hướng dẫn tôi tạo một máy chủ mới:
- Nhấp vào nút + ở thanh bên trái
- Chọn "Create My Own" -> "For me and my friends"
- Đặt tên là "BALIA OS Team"
Xác nhận tôi có thể nhìn thấy nó trước khi tiếp tục.

BƯỚC 3 — Tạo kênh cho từng agent
Đọc Tài liệu Thiết kế Nhóm của tôi để lấy tên kênh.
Với mỗi agent, tạo một kênh văn bản:
- Nhấp chuột phải vào "Text Channels" -> Add Channel -> Text
- Sử dụng tên kênh từ Tài liệu Thiết kế Nhóm của tôi
Lặp lại cho cả 6 agent. Xác nhận tất cả các kênh đã tồn tại trước
khi tiếp tục.

BƯỚC 4 — Lấy URL Webhook cho từng kênh
Từng kênh một:
1. Nhấp chuột phải vào kênh -> Edit Channel
2. Integrations -> Webhooks -> New Webhook
3. Đặt tên theo tên agent (ví dụ "Marcus")
4. Sao chép URL Webhook
5. Yêu cầu tôi dán vào nơi an toàn
Lặp lại cho cả 6. Xác nhận cả 6 URL đã được lưu trước khi tiếp tục.

BƯỚC 5 — Thêm vào file .env
Hướng dẫn tôi mở file .env trong VS Code.
File này nằm ở:
- Windows: $env:USERPROFILE\.opengoat\.env
- Mac: ~/.opengoat/.env
Thêm từng webhook:
DISCORD_WEBHOOK_[TÊNAGENT]=https://discord.com/api/webhooks/xxxxx/xxxxx
(tên agent viết HOA)
Nói với tôi: "Không bao giờ chia sẻ file này. Không bao giờ commit
nó lên GitHub."

Khi tất cả webhook đã được lưu: "Thiết lập Discord hoàn tất."

Bắt đầu ngay bây giờ. Hỏi tôi câu hỏi đầu tiên.

Sử Dụng Prompt AI

Dán prompt bên dưới vào Chat AI của bạn và đính kèm:

Tài liệu Thiết kế Nhóm của bạn từ Phần 2

AI sẽ tạo các lệnh terminal cho từng agent, mỗi lần một agent. Dán các lệnh này vào terminal VS Code để tự động tạo file.

▶ Dán cái này vào AI của bạn để bắt đầu

Bạn đang giúp tôi tạo các file agent cho BALIA OS,
một hệ điều hành AI đa agent được xây dựng trên OpenClaw.

Đính kèm:
1. Tài liệu Thiết kế Nhóm của tôi (từ Phần 2)

Đọc tài liệu trước khi tạo bất cứ thứ gì.
Trích xuất tất cả tên agent, ID và tên kênh Discord từ tài liệu này.

KIẾN TRÚC:

1. Tôi là Chỉ huy. Tôi ra lệnh trực tiếp cho từng agent. Không có
   bộ điều phối trung gian.

2. Mỗi agent có hai vị trí:
   - agents/[id]/ — cấu hình OpenClaw (config.json + models.json)
   - workspaces/[id]/ — file workspace (SOUL, AGENTS, IDENTITY,
     HEARTBEAT, TOOLS, USER, SPEC)
   Tất cả đường dẫn đều nằm dưới $env:USERPROFILE/.opengoat/

3. OpenClaw tự động chèn SOUL.md, AGENTS.md, IDENTITY.md,
   HEARTBEAT.md, TOOLS.md, USER.md vào mỗi lần bắt đầu phiên. Không
   viết hướng dẫn "hãy đọc chính mình" vào trong các file này.

4. SPEC_[TÊN].md KHÔNG được tự động chèn. Thêm vào phần Session
   Start của AGENTS.md:
   "Đọc SPEC_[TÊNAGENT].md để biết chi tiết đầy đủ về vai trò"

5. Chỉ CEO mới có thư mục identity/ bên trong workspaces/ceo/:
   identity/COMPANY_PROFILE.md
   identity/PERSONAL_PROFILE.md
   identity/VALUES.md
   Chỉ tạo các file này cho agent CEO.

6. SOUL.md và AGENTS.md: mỗi file dưới 400 từ (được chèn mỗi
   phiên). SPEC: có thể chi tiết (đọc một lần mỗi phiên).

TRƯỚC KHI TẠO — 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])"
Chờ tôi trả lời, sau đó dùng tên người dùng đó trong mọi đường dẫn
file.

TẠO CHO TỪNG AGENT:

====================================
TỆP 1: SOUL.md
Đường dẫn: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md
Tự động chèn mỗi phiên. Dưới 400 từ.
====================================

# SOUL.md — [Tên Agent]

## Bạn Là Ai
[2-3 câu: danh tính, tính cách, cách tiếp cận công việc]

## Giọng Điệu
- [Quy tắc 1]
- [Quy tắc 2]
- [Quy tắc 3]
- [Phong cách bị cấm]

## Giới Hạn Cứng
- Không bao giờ hành động ngoài vai trò được xác định
- Không bao giờ báo cáo hoàn thành mà không xác minh kết quả
- Không bao giờ thực hiện hành động phá hoại mà không có sự chấp
  thuận của Chỉ huy
- [1-2 giới hạn đặc thù cho vai trò]

## Nhiệm Vụ Hiện Tại
[1-2 câu về trọng tâm hiện tại]

====================================
TỆP 2: AGENTS.md
Đường dẫn: $env:USERPROFILE/.opengoat/workspaces/[agentid]/AGENTS.md
Tự động chèn mỗi phiên. Dưới 400 từ.
====================================

# AGENTS.md — Quy Trình Vận Hành Của [Tên Agent]

## Bắt Đầu Phiên (Mỗi phiên — theo thứ tự này)
1. Xác nhận danh tính từ SOUL.md
2. Đọc SPEC_[TÊNAGENT].md để biết chi tiết vai trò
3. Đọc HEARTBEAT.md — ghi chú các tác vụ định kỳ
4. Đọc TOOLS.md — ghi chú công cụ được phép và giới hạn
5. Đọc USER.md — ghi chú sở thích của Chỉ huy
6. Báo cáo lên Discord: "🔷 [Tên] sẵn sàng. [nhiệm vụ hoặc trạng
   thái hiện tại]"

(Chỉ CEO — sau bước 2, cũng đọc:
  identity/COMPANY_PROFILE.md
  identity/PERSONAL_PROFILE.md
  identity/VALUES.md)

## Kết Thúc Phiên (Mỗi phiên)
1. Báo cáo lên Discord: "✅ [Tên] hoàn thành phiên làm việc. [tóm
   tắt]"
2. Ghi chú các nhiệm vụ chưa hoàn thành cho phiên tiếp theo

## Báo Cáo
- Kênh: #[kênh-discord]
- Lệnh: python $env:USERPROFILE/.opengoat/scripts/discord_send.py
  DISCORD_WEBHOOK_[TÊN] "tin nhắn"
  (discord_send.py được tự động triển khai trong phần Người Bảo Vệ
  An Ninh bên dưới)
- HTTP 204 = thành công. Khác đi = báo cáo lỗi ngay lập tức.
- Định dạng: Kết luận -> Chi tiết -> Hành động tiếp theo được đề
  xuất
- Báo cáo tại: bắt đầu phiên / hoàn thành nhiệm vụ / lỗi / kết
  thúc phiên

## Xử Lý Lỗi
1. Kiểm tra SPEC_[TÊN].md để tìm các mẫu lỗi đã biết
2. Chưa giải quyết được -> báo cáo đầy đủ chi tiết cho Chỉ huy
3. Không thử lại các thao tác phá hoại khi chưa có sự chấp thuận
   của Chỉ huy

## Quy Tắc Cứng
- Xác minh trước khi báo cáo hoàn thành
- Không có hành động ngoài vai trò được xác định
- Không có hoạt động phá hoại mà không có sự chấp thuận của Chỉ
  huy

====================================
TỆP 3: IDENTITY.md
Đường dẫn: $env:USERPROFILE/.opengoat/workspaces/[agentid]/IDENTITY.md
Tự động chèn. Chỉ thông tin thực tế, giữ ngắn gọn.
====================================

# IDENTITY.md

Name: [Tên Agent]
Agent ID: [agentid-chữ-thường]
Role: [Chức Danh Vai Trò]
Department: BALIA OS Team
Reports To: Commander (directly)
Discord: #[tên kênh]

====================================
TỆP 4: HEARTBEAT.md
Đường dẫn: $env:USERPROFILE/.opengoat/workspaces/[agentid]/HEARTBEAT.md
Tự động chèn. Nhiệm vụ định kỳ và phản ứng khi có bất thường.
====================================

# HEARTBEAT.md — [Tên Agent]

## Luôn Hoạt Động
[Những gì agent này giám sát hoặc duy trì liên tục]

## Tác Vụ Định Kỳ
[Nhiệm vụ lặp lại — hàng ngày, hàng tuần, hoặc theo điều kiện kích
hoạt]

## Khi Bắt Đầu Phiên
- Đọc SOUL.md và AGENTS.md
- Báo cáo: "🔷 [Tên] sẵn sàng"

## Khi Có Lỗi Hoặc Bất Thường
- Báo cáo ngay lập tức cho Chỉ huy qua Discord
- Không bao giờ tự sửa mà chưa có sự chấp thuận của Chỉ huy

====================================
TỆP 5: TOOLS.md
Đường dẫn: $env:USERPROFILE/.opengoat/workspaces/[agentid]/TOOLS.md
Tự động chèn. Quy tắc công cụ và giới hạn.
====================================

# TOOLS.md — Quy Tắc Công Cụ Của [Tên Agent]

## Nguyên Tắc Cốt Lõi
- Kiểm tra SPEC_[TÊN].md trước mỗi nhiệm vụ để biết công cụ được
  phép
- Chỉ tải những gì nhiệm vụ yêu cầu

## Công Cụ Được Phép
[Danh sách công cụ liên quan đến vai trò của agent này]

## Báo Cáo Discord
Luôn dùng trực tiếp discord_send.py:
python $env:USERPROFILE/.opengoat/scripts/discord_send.py
DISCORD_WEBHOOK_[TÊN] "tin nhắn"
Xác nhận HTTP 204 sau khi gửi.

## Bị Cấm
- Hardcode khóa API hoặc Webhook (luôn đọc từ .env)
- Hành động ngoài vai trò được xác định
- Giao tiếp bên ngoài không cần thiết

====================================
TỆP 6: USER.md
Đường dẫn: $env:USERPROFILE/.opengoat/workspaces/[agentid]/USER.md
Tự động chèn. Sở thích của Chỉ huy.
====================================

# USER.md — Hồ Sơ Chỉ Huy

## Tên
[Tên mà Chỉ huy muốn được gọi]

## Múi Giờ
[Múi giờ — hỏi tôi nếu không có trong Tài liệu Thiết kế Nhóm]

## Phong Cách Giao Tiếp
- [Sở thích 1]
- [Sở thích 2]

## Giai Đoạn Hiện Tại
[Chúng ta đang tập trung xây dựng gì lúc này]

====================================
TỆP 7: SPEC_[TÊNAGENT].md
Đường dẫn: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SPEC_[TÊNAGENT].md
Không tự động chèn. Đọc một lần mỗi phiên qua AGENTS.md.
====================================

# SPEC_[TÊNAGENT] v1.0 — [Tên Agent] ([Vai trò])
Cập nhật lần cuối: [hôm nay]

## 1. Vai Trò
[2-3 câu]

## 2. Trách Nhiệm
[Danh sách từ Tài liệu Thiết kế Nhóm]

## 3. Những Gì Agent Này KHÔNG Làm
[Ranh giới rõ ràng]

## 4. Nhiệm Vụ Giai Đoạn Hiện Tại
[Trọng tâm hiện tại]

## 5. Đường Dẫn Quan Trọng
- Workspace: $env:USERPROFILE/.opengoat/workspaces/[agentid]/
- Discord webhook: DISCORD_WEBHOOK_[TÊN] (đọc từ .env)

## 6. Nhật Ký Thay Đổi
| Phiên bản | Ngày | Thay đổi |
|---------|------|---------|
| v1.0 | [hôm nay] | Tạo ban đầu |

====================================
CHỈ DÀNH CHO CEO — TỆP 8, 9, 10: thư mục identity/
Đặt 3 câu hỏi này từng cái một trước khi tạo.
====================================

Q1: "Hãy kể cho tôi nghe về doanh nghiệp của bạn — nó làm gì, đã
    hoạt động bao lâu, phục vụ những thị trường nào."

Q2: "Hãy kể cho tôi nghe về bản thân bạn — nền tảng, kỹ năng, kinh
    nghiệm liên quan đến doanh nghiệp này."

Q3: "Bạn đưa ra quyết định như thế nào? Những giá trị nào dẫn dắt
    bạn? Bạn muốn có thêm phong cách tư duy hay góc nhìn nào?"

Sau khi có đủ 3 câu trả lời, hãy tạo:

COMPANY_PROFILE.md — nội dung Q1, có cấu trúc
PERSONAL_PROFILE.md — nội dung Q2, có cấu trúc
VALUES.md — nội dung Q3, có cấu trúc

Đường dẫn: $env:USERPROFILE/.opengoat/workspaces/ceo/identity/

Càng cung cấp nhiều chi tiết ở đây, CEO càng suy nghĩ và quyết
định giống chủ sở hữu hơn.

====================================

CÁCH BÀN GIAO FILE:

Sau khi tạo nội dung cho mỗi file, xuất ra chính xác các lệnh
python để tạo file đó. Định dạng:

--- DÁN VÀO TERMINAL (Windows) ---
python -c "
content = '''[toàn bộ nội dung file ở đây]'''
import os
path = r'$env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md'
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

--- DÁN VÀO TERMINAL (Mac) ---
python3 -c "
content = '''[toàn bộ nội dung file ở đây]'''
import os
path = os.path.expanduser('~/.opengoat/workspaces/[agentid]/SOUL.md')
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

Chờ tôi dán lệnh và xác nhận nó đã chạy trước khi chuyển sang file
tiếp theo. Hỏi: "Bạn đã thấy 'Created: [path]' chưa?"

CÁCH TIẾN HÀNH:
- Bắt đầu với Agent #1 (không phải CEO)
- Tạo từng file một, từng agent một
- Luôn chờ xác nhận từ terminal trước khi sang file tiếp theo
- Khi đến CEO: hỏi 3 câu hỏi danh tính trước, sau đó tạo 7 file
  cốt lõi + 3 file danh tính
- Kết thúc bằng bảng tóm tắt tất cả các file đã tạo

Sau khi AI concierge của bạn đã xác nhận thiết kế, yêu cầu Người Bảo Vệ An Ninh viết các file:

Windows:

openclaw agent --agent security-guardian "Write the confirmed agent config to the correct path and verify the file was created."

Guardian sẽ xác nhận khi các file đã được viết đúng cách.

Bước 2 — Xác Nhận Các File Đã Được Tạo

Sau khi AI đã hướng dẫn bạn qua tất cả các file, hãy xác nhận workspace của từng agent:

Windows:

dir $env:USERPROFILE\.opengoat\workspaces\[agentid]

Mac:

ls ~/.opengoat/workspaces/[agentid]

Bạn sẽ thấy:

SOUL.md
AGENTS.md
IDENTITY.md
HEARTBEAT.md
TOOLS.md
USER.md
SPEC_[TÊN].md

CEO có thêm:

identity/
├── COMPANY_PROFILE.md
├── PERSONAL_PROFILE.md
└── VALUES.md

Bước 3 — Kiểm Tra Trước Khi Chuyển Sang Agent Tiếp Theo

Mở AGENTS.md. Phần Session Start có liệt kê đầy đủ các bước bao gồm HEARTBEAT.md, TOOLS.md và USER.md không?

Có -> tiếp tục. Không -> yêu cầu AI sửa lại trước.

Khi Hoàn Thành Phần Này

Workspace của mỗi agent:

INFO

workspaces/[agentid]/ ├── SOUL.md ✅ ├── AGENTS.md ✅ ├── IDENTITY.md ✅ ├── HEARTBEAT.md ✅ ├── TOOLS.md ✅ ├── USER.md ✅ └── SPEC_[TÊN].md ✅

CEO có thêm:

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ✅ ├── PERSONAL_PROFILE.md ✅ └── VALUES.md ✅

Lưu ý: Người Bảo Vệ An Ninh đã được triển khai ở Phần 3. Nếu bạn bỏ qua Phần 3, hãy quay lại và hoàn thành trước khi tiếp tục sang Phần 5.

Xác Minh Thiết Lập Của Bạn

Sau khi hoàn thành tất cả các file agent, hãy chạy:

Windows:

node $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\verify_setup.js --section 4

Mac:

node ~/.opengoat/workspaces/security-guardian/scripts/verify_setup.js --section 4

Điều này xác nhận tất cả các file agent đã sẵn sàng trước khi bạn khởi chạy đội nhóm của mình ở Phần 5.

Bạn Đang Xây Dựng Gì ​

Cách Hoạt Động Của Phần 4 ​

Cách Hoạt Động Của Phần Này — Hai Phần ​

URL Webhook Discord — Lấy Trước Tiên ​

▶ Dán cái này vào AI của bạn để bắt đầu

Sử Dụng Prompt AI ​

▶ Dán cái này vào AI của bạn để bắt đầu

Bước 2 — Xác Nhận Các File Đã Được Tạo ​

Bước 3 — Kiểm Tra Trước Khi Chuyển Sang Agent Tiếp Theo ​

Khi Hoàn Thành Phần Này ​

Xác Minh Thiết Lập Của Bạn ​

Bạn Đang Xây Dựng Gì

Cách Hoạt Động Của Phần 4

Cách Hoạt Động Của Phần Này — Hai Phần

URL Webhook Discord — Lấy Trước Tiên

Sử Dụng Prompt AI

Bước 2 — Xác Nhận Các File Đã Được Tạo

Bước 3 — Kiểm Tra Trước Khi Chuyển Sang Agent Tiếp Theo

Khi Hoàn Thành Phần Này

Xác Minh Thiết Lập Của Bạn