12 tháng 4, 2026

Workspace là gì và tại sao nó quan trọng?

Khi bạn chạy OpenClaw lần đầu, nó sẽ tạo một thư mục ~/.openclaw/workspace với vài file markdown bên trong. Nhìn đơn giản, nhưng đây chính là “bộ não khởi động” của agent — nơi quyết định agent của bạn là ai, biết gì, và hành xử thế nào.

Triết lý của OpenClaw rất rõ ràng: file là nguồn sự thật duy nhất (files are the source of truth — tìm hiểu thêm về hệ thống trí nhớ 3 tầng của OpenClaw). Không có dashboard phức tạp, không có cơ sở dữ liệu ẩn. Mọi thứ agent cần biết đều nằm trong các file markdown mà bạn có thể đọc và sửa bằng bất kỳ text editor nào.

Điều này mang lại hai lợi ích lớn: bạn luôn kiểm soát được agent đang làm gì, và bạn có thể version control toàn bộ cấu hình bằng Git.

Cấu trúc workspace mặc định

Khi cài đặt xong, workspace sẽ trông như thế này:

~/.openclaw/workspace/ ├── AGENTS.md        # Hướng dẫn vận hành chính ├── SOUL.md          # Tính cách và phong cách giao tiếp ├── IDENTITY.md      # Tên, ID, vai trò ├── USER.md          # Thông tin về bạn (chủ sở hữu) ├── TOOLS.md         # Ghi chú về công cụ và thiết bị ├── HEARTBEAT.md     # Tác vụ tự động định kỳ ├── MEMORY.md        # Trí nhớ dài hạn └── memory/          # Thư mục ghi chú hàng ngày     └── 2026-04-12.md 

Mỗi file có một vai trò riêng. Hãy đi vào từng file.

AGENTS.md — Bản hướng dẫn vận hành

Đây là file quan trọng nhất. AGENTS.md được load vào context mỗi phiên làm việc, giống như bạn đưa cho nhân viên mới một tờ “Quy tắc làm việc” vào ngày đầu tiên.

Nội dung nên có:

# Hướng dẫn vận hành



Vai trò



Bạn là trợ lý AI cá nhân của [Tên bạn]. Nhiệm vụ chính:



Quản lý lịch trình và nhắc việc
Hỗ trợ viết code và debug
Nghiên cứu và tóm tắt thông tin



Quy tắc giao tiếp



Trả lời bằng tiếng Việt trừ khi được yêu cầu khác
Ngắn gọn, đi thẳng vào vấn đề
Nếu không chắc, hỏi lại thay vì đoán



Quy tắc an toàn



Không chạy lệnh xoá dữ liệu mà không hỏi trước
Không chia sẻ thông tin cá nhân ra bên ngoài
Log lại mọi thao tác quan trọng



Khi mắc lỗi



Nếu bạn làm sai điều gì, hãy ghi lại vào AGENTS.md  để lần sau không lặp lại. 

Mẹo quan trọng: Giữ AGENTS.md ngắn gọn — dưới 100 dòng nếu có thể. File này được load mỗi phiên, nên mỗi dòng thừa đều tốn token. Viết rõ ràng, dùng bullet points, tránh lặp ý.

SOUL.md — Tính cách của agent

Nếu AGENTS.md là “bản mô tả công việc”, thì SOUL.md là “tính cách con người”. File này định nghĩa cách agent giao tiếp, giọng điệu, và phong cách.

# Soul



Tính cách



Thân thiện nhưng chuyên nghiệp. Nói chuyện tự nhiên  như đồng nghiệp, không quá trang trọng cũng không quá  suồng sã.



Giọng điệu



Dùng "mình" và "bạn" thay vì "tôi" và "quý khách"
Có thể pha chút hài hước khi phù hợp
Giải thích kỹ thuật bằng ví dụ đời thường



Điều không làm



Không dùng emoji quá nhiều
Không trả lời dài dòng khi câu hỏi đơn giản
Không tỏ ra biết tuốt — thừa nhận khi không chắc

Phần hay nhất của SOUL.md: bạn có thể thử nghiệm nhiều “tính cách” khác nhau cho cùng một agent. Muốn agent nghiêm túc hơn cho công việc? Sửa SOUL.md. Muốn agent vui vẻ hơn cho chat cá nhân? Sửa SOUL.md. Không cần cài đặt lại bất cứ thứ gì.

IDENTITY.md — Agent này là ai?

File ngắn nhất nhưng cần thiết, đặc biệt khi bạn chạy nhiều agent trên cùng một máy.

# Identity



name: Minh role: Personal Assistant id: main-agent 

OpenClaw dùng thông tin trong IDENTITY.md để định tuyến tin nhắn khi bạn chạy multi-agent setup. Nếu chỉ dùng một agent thì file này không cần phức tạp.

USER.md — Thông tin về chủ sở hữu

Đây là nơi bạn cho agent biết về bản thân. Càng cung cấp nhiều ngữ cảnh, agent càng trả lời chính xác hơn.

# User



Thông tin cơ bản



Tên: Hùng
Nghề: Full-stack developer
Ngôn ngữ: Tiếng Việt (chính), English (đọc tốt)
Múi giờ: UTC+7 (Việt Nam)



Công việc hiện tại



Đang phát triển OnMay — nền tảng VPS hosting
Tech stack: Next.js, TypeScript, PostgreSQL
Ưu tiên: hoàn thiện tính năng payment



Sở thích / thói quen



Code nhiều nhất vào buổi tối (20h-1h)
Thích giải thích ngắn gọn, có ví dụ cụ thể
Ghét câu trả lời chung chung kiểu "tuỳ trường hợp"

Lưu ý bảo mật: Không đưa mật khẩu, API key, hay thông tin tài chính vào USER.md. File này có thể bị đọc bởi model AI — chỉ đưa thông tin mà bạn thoải mái chia sẻ với một đồng nghiệp tin cậy.

TOOLS.md — Ghi chú về công cụ

TOOLS.md không phải nơi cấu hình tool (việc đó nằm trong openclaw.json). Đây là nơi ghi chú những thông tin thực tế mà agent cần biết khi dùng tool.

# Tools Notes



SSH Servers



Production: ssh deploy@10.10.10.2 (dùng key ~/.ssh/onmay_deploy)
Staging: ssh dev@10.10.10.3



Camera nhà



Phòng khách: rtsp://192.168.1.100/stream
Tên model: Hikvision DS-2CD2143G2



API Keys location



Anthropic: lưu trong .env.local
OpenAI: lưu trong 1Password vault "Dev Keys"

Kết hợp tất cả lại

Sức mạnh thực sự của workspace là khi các file phối hợp với nhau. Hãy xem một ví dụ thực tế:

Bạn nhắn cho agent: “Kiểm tra server production có ổn không?”

Agent sẽ:

1. Đọc AGENTS.md → biết mình là trợ lý kỹ thuật, cần cẩn thận với server
2. Đọc USER.md → biết bạn là developer, không cần giải thích SSH là gì
3. Đọc TOOLS.md → biết IP server production là 10.10.10.2
4. Đọc SOUL.md → trả lời ngắn gọn, đi thẳng vào vấn đề
5. Đọc MEMORY.md → nhớ lần trước server bị lỗi do disk full

Kết quả: agent SSH vào server, kiểm tra CPU/RAM/disk, và báo lại kết quả — tất cả chỉ từ một câu hỏi đơn giản.

Mẹo từ thực tế

Bắt đầu đơn giản, mở rộng dần. Không cần viết workspace hoàn hảo ngay từ đầu. Bắt đầu với AGENTS.md và SOUL.md cơ bản, rồi bổ sung khi bạn thấy agent thiếu ngữ cảnh nào.

Version control workspace. Đặt workspace vào Git repo riêng. Mỗi lần tinh chỉnh tính cách hay thêm quy tắc mới, bạn có thể commit và rollback nếu cần.

Thay đổi workspace path. Nếu bạn muốn workspace ở chỗ khác (ví dụ trong project repo), cấu hình agents.defaults.workspace trong openclaw.json:

{   "agents": {     "defaults": {       "workspace": "~/projects/my-agent-workspace"     }   } } 

Review định kỳ. Mỗi tuần dành 5 phút đọc lại AGENTS.md. Xoá những quy tắc không còn cần, thêm bài học mới. Workspace gọn gàng = agent nhanh hơn và rẻ hơn.

Chạy trên VPS OnMay

Trên VPS OnMay, OpenClaw đã được cài sẵn cùng workspace mặc định. Bạn chỉ cần SSH vào VPS và bắt đầu tuỳ chỉnh:

# SSH vào VPS OnMay ssh root@your-vps-ip -p 10122



Xem workspace hiện tại



ls ~/.openclaw/workspace/



Sửa AGENTS.md bằng nano



nano ~/.openclaw/workspace/AGENTS.md



Hoặc clone workspace từ Git repo của bạn



cd ~/.openclaw rm -rf workspace git clone https://github.com/yourname/my-agent-config workspace 

OpenClaw trên VPS OnMay chạy 24/7, nên mọi thay đổi workspace sẽ có hiệu lực ngay từ phiên chat tiếp theo — không cần restart.

Tổng kết

Workspace là nền tảng của mọi thứ trong OpenClaw. Đầu tư 30 phút cấu hình workspace đúng cách sẽ tiết kiệm cho bạn hàng giờ đồng hồ sau này. Agent hiểu bạn hơn, trả lời chính xác hơn, và ít mắc lỗi ngớ ngẩn hơn.