OpenClaw cho người mới #3: Memory, AGENTS, USER khác nhau thế nào?

Cập nhật lần cuối: 19/03/2026 | Phiên bản: 1.0

OpenClaw hoạt động dựa trên hệ thống file Markdown trong workspace. Ba khái niệm cốt lõi bạn cần hiểu là: AGENTS.md (quy trình vận hành của agent), USER.md (thông tin về bạn — người dùng), và Memory (hệ thống trí nhớ dài hạn). Hiểu đúng ba thứ này sẽ giúp bạn biến OpenClaw từ “một con chatbot” thành “trợ lý cá nhân thực sự hiểu bạn”.

Bối cảnh: Workspace của OpenClaw hoạt động ra sao?

Khi bạn cài OpenClaw, hệ thống tạo một thư mục workspace (thường ở ~/.openclaw/workspace/). Bên trong chứa một loạt file Markdown — đây chính là bộ não của agent. Mỗi khi agent bắt đầu một phiên hội thoại mới, nó đọc các file này để biết: mình là ai, mình phải làm gì, và người dùng cần gì.

Hãy hình dung thế này: mô hình AI là trí thông minh thô. Còn các file workspace là tính cách, trí nhớ, và bộ quy tắc biến trí thông minh đó thành một trợ lý biết bạn là ai.

~/.openclaw/workspace/
├── AGENTS.md
├── SOUL.md
├── USER.md
├── IDENTITY.md
├── TOOLS.md
├── HEARTBEAT.md
├── MEMORY.md
└── memory/
    ├── 2026-03-19.md
    └── 2026-03-18.md

1. AGENTS.md — “Sổ tay vận hành” của Agent

AGENTS.md là file chứa hướng dẫn vận hành, giống như SOP cho AI. File này được nạp vào đầu mỗi phiên hội thoại và quy định agent phải làm gì trước tiên, tuân thủ quy tắc nào, và xử lý tình huống ra sao.

Nội dung thường có gì?

• Boot sequence: agent cần đọc gì khi bắt đầu phiên mới.
• Quy tắc ưu tiên: ví dụ luôn hỏi trước khi làm việc không thể hoàn tác.
• Quy tắc bảo mật: như chỉ đọc MEMORY.md trong phiên riêng.

Nói ngắn gọn: AGENTS.md trả lời câu hỏi “Agent phải làm gì?”

2. USER.md — “Hồ sơ người dùng”

USER.md chứa thông tin về bạn — người dùng. Đây là lớp cá nhân hóa giúp agent hiểu bạn muốn giao tiếp kiểu gì, bạn đang làm gì, dùng ngôn ngữ nào, ở múi giờ nào, và có những ràng buộc hay sở thích gì.

Nội dung thường có gì?

• Thông tin cơ bản: tên, múi giờ, ngôn ngữ.
• Bối cảnh công việc: vai trò, dự án, stack công nghệ.
• Sở thích giao tiếp: ngắn gọn hay chi tiết, chủ động hay chờ hỏi.
• Những ràng buộc: ví dụ không liên hệ khách hàng nếu chưa được phép.

Nói ngắn gọn: USER.md trả lời câu hỏi “Người dùng là ai?”

3. Memory — “Trí nhớ” của Agent

Memory trong OpenClaw giúp agent nhớ thông tin qua nhiều phiên hội thoại. Đây là khác biệt lớn giữa OpenClaw và các phiên chat AI thông thường vốn thường bắt đầu lại từ đầu.

Hai tầng trí nhớ

• MEMORY.md — trí nhớ dài hạn, đã được chắt lọc.
• memory/YYYY-MM-DD.md — ghi chú hằng ngày, mang tính nhật ký công việc.

Theo thời gian, các thông tin quan trọng từ daily notes sẽ được tổng hợp vào MEMORY.md.

Compaction — điều người mới rất dễ bỏ qua

Khi context window đầy, OpenClaw sẽ nén lịch sử hội thoại cũ. Những chỉ dẫn chỉ nói trong chat mà không lưu vào file có thể biến mất sau quá trình này.

Bài học quan trọng: quy tắc quan trọng phải được lưu vào file như AGENTS.md, USER.md hoặc MEMORY.md, đừng chỉ nói miệng trong chat.

So sánh nhanh: AGENTS.md vs USER.md vs Memory

• AGENTS.md: Sổ tay quy trình — agent phải làm gì.
• USER.md: Hồ sơ người dùng — người dùng là ai.
• Memory: Nhật ký và trí nhớ — đã xảy ra chuyện gì, cần nhớ gì lâu dài.

Bonus: Những file khác nên biết

• SOUL.md — tính cách, giọng điệu, giá trị cốt lõi của agent.
• IDENTITY.md — tên, emoji, avatar, nhận dạng.
• HEARTBEAT.md — checklist cho heartbeat tự động.
• TOOLS.md — ghi chú môi trường và cách dùng công cụ cho đúng setup.

Lỗi thường gặp

• Agent quên chỉ dẫn sau một lúc vì chỉ dẫn không được lưu vào file.
• Agent lộ thông tin cá nhân trong group chat vì đọc sai phạm vi của MEMORY.md.
• MEMORY.md quá dài khiến agent chậm và tốn token.
• Tính cách agent thiếu nhất quán vì quy tắc bị rải ở nhiều file.

Mẹo cho người mới bắt đầu

• Tuần đầu chỉ cần tập trung vào AGENTS.md, SOUL.md và USER.md.
• Khi có quyết định quan trọng, hãy yêu cầu agent ghi vào memory.
• Backup workspace bằng Git như backup code.
• Định kỳ đọc lại MEMORY.md để sửa và tinh gọn trí nhớ.

Nguồn tham khảo: OpenClaw Docs, GitHub openclaw/openclaw và kinh nghiệm triển khai thực tế.