Mục lục bài viết[Hide][Show]
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). 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 [email protected] (dùng key ~/.ssh/onmay_deploy)
- Staging: ssh [email protected]
## 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ẽ:
- Đọc AGENTS.md → biết mình là trợ lý kỹ thuật, cần cẩn thận với server
- Đọc USER.md → biết bạn là developer, không cần giải thích SSH là gì
- Đọc TOOLS.md → biết IP server production là 10.10.10.2
- Đọc SOUL.md → trả lời ngắn gọn, đi thẳng vào vấn đề
- Đọ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.
Thủ thuật Keymap với VIA