QuotaCheap Playbook

OpenClaw Agent Workspace: workspace, memory files và production checklist

Hiểu OpenClaw agent workspace trong thực tế: default cwd, AGENTS.md, SOUL.md, USER.md, TOOLS.md, MEMORY.md, memory theo ngày, skills, canvas, sandboxing và…

Playbook thực tế cho Vietnamese developers và AI builders đang dùng OpenClaw: hiểu workspace là gì, các file memory quan trọng như AGENTS.md, SOUL.md, USER.md, TOOLS.md, HEARTBEAT.md, MEMORY.md, thư mục memory theo ngày, skills, canvas, và checklist trước khi chạy production.

OpenClaw Agent Workspace: workspace, memory files và production checklist Nếu bạn xây AI agent bằng OpenClaw, hãy xem workspace như “nhà chính” của agent: nơi agent bắt đầu làm việc, đọc ngữ cảnh, ghi lại trí nhớ, tạo artefact và phối hợp với các file hướng dẫn.

Hiểu đúng workspace giúp bạn tránh hai lỗi phổ biến: để agent mất ngữ cảnh sau mỗi phiên, hoặc cho agent quá nhiều quyền mà không có cấu trúc kiểm soát.

Bài này tập trung vào facts thực dụng: workspace là home/default cwd của agent; mặc định nằm ở ~/.openclaw/workspace; tách biệt với phần config, credentials và sessions trong ~/.openclaw; và không phải hard sandbox trừ khi sandboxing được bật.

Trong OpenClaw, workspace là thư mục làm việc mặc định của agent.

Khi agent cần đọc file dự án, viết ghi chú, lưu memory, tạo bản nháp hoặc vận hành workflow, workspace là điểm xuất phát tự nhiên.

Mặc định, workspace nằm tại: Điểm quan trọng: workspace không đồng nghĩa với toàn bộ trạng thái OpenClaw.

Nó được tách khỏi các phần khác trong ~/.openclaw, như config, credentials và sessions.

Cách tách này giúp bạn giữ thư mục làm việc của agent rõ ràng hơn: file nào dành cho reasoning và vận hành thì ở workspace; file nào thuộc cấu hình, thông tin xác thực hoặc phiên chạy thì không nên trộn lẫn.

Một hiểu nhầm cần tránh: workspace không tự động là hard sandbox.

Nó là home/default current working directory của agent.

Nếu bạn muốn giới hạn quyền đọc/ghi chặt chẽ, bạn cần bật và cấu hình sandboxing phù hợp.

Không nên giả định rằng chỉ vì agent đang ở workspace thì nó không thể chạm tới vùng khác.

Các file nền tảng trong workspace Một workspace tốt nên có cấu trúc rõ ràng để agent biết mình là ai, đang phục vụ ai, được dùng công cụ nào và cần nhớ điều gì.

Các file thường gặp gồm: AGENTS.md AGENTS.md là nơi mô tả cách agent nên hoạt động trong workspace.

Bạn có thể đặt quy tắc về coding style, cách trả lời, cách chạy test, cách đọc tài liệu, hoặc giới hạn hành vi.

Nếu bạn làm việc theo team, đây là file nên được viết rõ nhất vì nó đóng vai trò như operational contract giữa người dùng và agent.

Ví dụ nội dung nên có: Agent phải đọc tài liệu hiện có trước khi sửa code.

Không tự ý xóa file hoặc reset git state.

Khi không chắc, phải hỏi lại thay vì đoán.

Khi sửa code, phải ghi rõ file đã thay đổi và cách kiểm chứng.

SOUL.md SOUL.md nên lưu identity và nguyên tắc vận hành cấp cao của agent.

File này không cần dài.

Nó trả lời câu hỏi: agent này tồn tại để làm gì, ưu tiên điều gì, và không nên làm gì.

Ví dụ: agent ưu tiên tính đúng, khả năng kiểm chứng, bảo mật dữ liệu và sự rõ ràng trong giao tiếp hơn tốc độ trả lời.