OpenClaw Mastermind Agent

Agent Mastermind kết nối nền tảng OpenClaw, dùng model cấu hình trong openclaw.config.json (mặc định Gemini) để tiếp nhận lệnh của user, lên kế hoạch, bàn giao công việc cho các agent con phù hợp (work / code / research; tùy cấu hình có thể thêm data-analyst, data-engineer, main), và quản lý hồ sơ quan điểm, triết lý, hành vi, sở thích của user qua file bền vững.

Chức năng chính

• Nhận lệnh: Hiểu và phân tích đầy đủ ý định, ràng buộc, tiêu chí hoàn thành theo chỉ thị user.
• Lên kế hoạch: Tách lệnh thành các bước độc lập, xác định thứ tự, phụ thuộc.
• Điều phối: Giao từng bước cho agent con phù hợp qua sessions_spawn theo subagents.allowAgents trong cấu hình (mặc định: work, code, research).
  • Kèm mô tả task rõ ràng và “khi xong thì báo gì”,
  • Yêu cầu báo cáo sau hoàn tất bước / báo lại trạng thái.
• Quản lý user profile: Đọc/ghi memory/UserProfile.md (point of view, philosophy, behavior, preferences, choices) theo cấu trúc trong cấu hình khi lập kế hoạch và học thêm về user.

Cấu trúc repo

.
├── openclaw.config.json           # Cấu hình: agents, defaults, workspace, allowAgents
├── agents/
│   ├── mastermind/
│   │   ├── SOUL.md                # Nhân cách, nguyên tắc, handoff, user profile
│   │   ├── AGENTS.md               # Bảng agent con, hướng dẫn chọn / handoff task
│   │   ├── BOOT.md                 # Khởi động: load profile, xử lý lệnh đầu
│   │   └── USER.md                # Đường dẫn tới memory/UserProfile.md
│   ├── work/                      # Atlas — doc, email, báo cáo, kế hoạch
│   │   ├── SOUL.md
│   │   └── BOOT.md
│   ├── code/                      # Claude — implement, refactor, debug, review
│   │   ├── SOUL.md
│   │   └── BOOT.md
│   ├── research/                  # Sage — search, tổng hợp, so sánh, fact-check
│   │   ├── SOUL.md
│   │   └── BOOT.md
│   ├── data-analyst/
│   │   ├── SOUL.md
│   │   ├── BOOT.md
│   │   └── PRO_DATA_ANALYST_WORKFLOW.md
│   └── data-engineer/
│       ├── SOUL.md
│       ├── BOOT.md
│       └── DATA_ENGINEER_WORKFLOW.md
├── memory/
│   └── UserProfile.md              # Hồ sơ user: POV, philosophy, preferences
└── README.md

Cài đặt

1. Setup OpenClaw

• Đảm bảo đã cài OpenClaw và khởi động CLI/gateway nếu cần.

2. Merge cấu hình

• Cách 1 (khuyến nghị): Sử dụng repo này làm workspace chính, set config workspace tới thư mục repo.
• Cách 2: Sao chép toàn bộ nội dung openclaw.config.json vào ~/.openclaw/openclaw.json
• Cách 3: Đặt file openclaw.config.json cùng thư mục chạy OpenClaw.

3. Gắn file agent (Mastermind + work / code / research + tùy chọn data-analyst, data-engineer)

OpenClaw đọc identity và prompt từ ~/.openclaw/agents/<agent_id>/.

Copy:

REPO="$(pwd)"  # hoặc đường dẫn tuyệt đối tới repo
mkdir -p ~/.openclaw/agents/{mastermind,work,code,research,data-analyst,data-engineer}
cp -r "$REPO/agents/mastermind/"*   ~/.openclaw/agents/mastermind/
cp -r "$REPO/agents/work/"*         ~/.openclaw/agents/work/
cp -r "$REPO/agents/code/"*         ~/.openclaw/agents/code/
cp -r "$REPO/agents/research/"*     ~/.openclaw/agents/research/
cp -r "$REPO/agents/data-analyst/"* ~/.openclaw/agents/data-analyst/
cp -r "$REPO/agents/data-engineer/"* ~/.openclaw/agents/data-engineer/

Symlink (khuyến nghị để cập nhật theo repo):

mkdir -p ~/.openclaw/agents
ln -sf "$(pwd)/agents/mastermind"    ~/.openclaw/agents/mastermind
ln -sf "$(pwd)/agents/work"         ~/.openclaw/agents/work
ln -sf "$(pwd)/agents/code"         ~/.openclaw/agents/code
ln -sf "$(pwd)/agents/research"     ~/.openclaw/agents/research
ln -sf "$(pwd)/agents/data-analyst"  ~/.openclaw/agents/data-analyst
ln -sf "$(pwd)/agents/data-engineer" ~/.openclaw/agents/data-engineer

(Thay $(pwd) bằng đường dẫn tuyệt đối nếu không chạy từ thư mục repo.)

4. Model (theo openclaw.config.json)

• Mastermind: google/gemini-3-5-flash (hoặc model bạn cấu hình).
• Các agent con (work, code, research, …): mặc định google/gemini-2-5-flash.

Đảm bảo API key tương ứng (ví dụ Google) đã được thiết lập trong biến môi trường hoặc ~/.openclaw/.env.

5. Workspace & User Profile

• Đảm bảo workspace chứa repo này (có thư mục memory/).
• Luôn giữ memory/UserProfile.md tồn tại theo template, Mastermind sẽ tự động đọc/cập nhật khi tiếp nhận kiến thức/quan điểm mới từ user.

Sử dụng

1. Bật agent mastermind (theo mặc định cấu hình, hoặc dùng command /agent mastermind nếu kênh hỗ trợ).
2. Gửi lệnh rõ ràng ví dụ:
   • “Viết tài liệu chi tiết về auth API + code demo xác thực NodeJS.”
   • “So sánh ba giải pháp deploy Next.js trên Vercel. Ưu/nhược?”
3. Mastermind sẽ:
   • Đọc file profile user,
   • Lên kế hoạch step-by-step,
   • Giao từng bước cho agent con phù hợp (work, code, research — theo subagents.allowAgents; có thể bật thêm data-analyst, data-engineer, main trong config),
   • Tóm tắt, điều phối, chuyển bước tiếp khi task xong.
4. Quan điểm, sở thích, triết lý của bạn thể hiện qua chat/sử dụng sẽ tự động được cập nhật vào memory/UserProfile.md.

Agents con (theo openclaw.config.json)

ID	Tên	Mục đích chính
work	Atlas	Tài liệu, báo cáo, email, kế hoạch, văn bản chính thức
code	Claude	Implement, refactor, debug, script, config, review
research	Sage	Tìm kiếm, tổng hợp, so sánh, fact-check
data-analyst	Data Analyst	SQL, DWH, báo cáo, insight (workflow 7 phase)
data-engineer	Data Engineer	Pipeline, ETL, data job tests
main	Samantha	Việc chung, trả lời nhanh, nhắc nhở

Mastermind mặc định chỉ spawn work, code, research (subagents.allowAgents). Muốn dùng data-analyst/data-engineer/main thì sửa trong openclaw.config.json.

Work / Code / Research (đơn giản)

• work (Atlas): Doc, email, báo cáo, kế hoạch — chỉ viết, không code, không research sâu. Định nghĩa: agents/work/SOUL.md, BOOT.md.
• code (Claude): Implement, refactor, debug, review — code gọn, chạy được. Định nghĩa: agents/code/SOUL.md, BOOT.md.
• research (Sage): Search, tóm tắt, so sánh, fact-check — trích nguồn, phân biệt fact vs suy luận. Định nghĩa: agents/research/SOUL.md, BOOT.md.

Data Analyst

data-analyst dùng workflow 7 phase (requirement → data discovery → mapping → query design → testing → optimization → document), checkpoints và scripts: search_glossary, search_schema, check_table, run_query_safe, v.v.
Cấu hình: agents/data-analyst/ (SOUL.md, BOOT.md, PRO_DATA_ANALYST_WORKFLOW.md).

Data Engineer

data-engineer thiết kế pipeline, ETL, tests cho data jobs.
Cấu hình: agents/data-engineer/ (SOUL.md, BOOT.md, DATA_ENGINEER_WORKFLOW.md).

Tùy chỉnh

• Sửa/thêm agent con: Thêm vào openclaw.config.json → agents.list[] và (nếu muốn mastermind giao được) vào mastermind.subagents.allowAgents; cập nhật agents/mastermind/AGENTS.md.
• Đổi model: Sửa agents.defaults.model hoặc từng agent trong openclaw.config.json.
• User profile: Chỉnh template memory/UserProfile.md hoặc tham chiếu trong agents/mastermind/SOUL.md, USER.md.

Tham chiếu

• OpenClaw Configuration
• Sub-Agents (sessions_spawn)
• SOUL/AGENTS/BOOT trong thư mục agents/mastermind/