Hướng dẫn đầy đủ về file workspace, skills, channels, permissions và cách cấu hình chúng đúng cách.
Hầu hết người dùng OpenClaw cài đặt nó, kết nối một channel và không bao giờ mở thư mục workspace.
Đây là một sai lầm.
Workspace của bạn là trung tâm điều khiển cho cách AI assistant của bạn hoạt động. Nó chứa danh tính, kỹ năng tùy chỉnh, kết nối kênh và bộ nhớ của bạn. Khi bạn hiểu cái gì nằm ở đâu, bạn có thể cấu hình OpenClaw chính xác theo cách bạn cần.
Hướng dẫn này sẽ đi qua giải phẫu của một thiết lập hoàn hảo.
PS: Openclaw chỉ là sự khởi đầu.
Bên trong cộng đồng Build With AI của chúng tôi, chúng tôi sẽ dạy bạn cách xây dựng các agent, ứng dụng và tự động hóa tùy chỉnh mà bạn có thể tự sử dụng hoặc bán cho khách hàng. Sắp ra mắt.
Tham gia danh sách chờ tại đây: [https://return-my-time.kit.com/1bd2720397](https://return-my-time.kit.com/1bd2720397)
-----------------------------------------
Hai lớp cấu hình, không phải một
Trước khi đi sâu, có một điều đáng biết trước: OpenClaw sử dụng hai lớp cấu hình.
Lớp đầu tiên là thư mục workspace của bạn (thường là ~/clawd/ hoặc bất cứ nơi nào bạn khởi tạo). Nó chứa cấu hình cá nhân, kỹ năng, bộ nhớ và bí mật của bạn.
Lớp thứ hai là bản cài đặt toàn cục tại opt/homebrew/lib/node_modules/clawdbot/ (hoặc tương đương trên hệ thống của bạn). Nó chứa tài liệu cốt lõi, các kỹ năng tích hợp sẵn và các hành vi mặc định.
Workspace của bạn là nơi bạn tùy chỉnh. Bản cài đặt toàn cục là thứ bạn cập nhật.
AGENTS.md: Hướng dẫn vận hành của bạn
Đây là file quan trọng nhất trong toàn bộ thiết lập của bạn. Khi OpenClaw bắt đầu một phiên, điều đầu tiên nó đọc là AGENTS.md. Nó tải trực tiếp vào system prompt và giữ nó trong suốt cuộc trò chuyện.
Nói một cách đơn giản: bất cứ điều gì bạn viết trong AGENTS.md, agent của bạn sẽ tuân theo.
Nếu bạn bảo nó luôn kiểm tra lịch của bạn trước khi đề xuất thời gian họp, nó sẽ làm. Nếu bạn nói "không bao giờ gửi email mà không có sự chấp thuận rõ ràng của tôi," nó sẽ tôn trọng điều đó mọi lúc.
Những gì thực sự nên có trong AGENTS.md:
Viết:
- Chỉ thị vận hành cốt lõi của bạn (công việc của agent là gì?)
- Các công cụ chính và cách sử dụng chúng (CLI email, quy trình quản lý tác vụ)
- Các quy tắc cứng không bao giờ được phá vỡ
- Liên kết đến các tài nguyên quan trọng (tài liệu API, vị trí skill)
- Trình kích hoạt quy trình làm việc (những gì nên tự động xảy ra)
Đừng viết:
- Tài liệu đầy đủ mà bạn có thể liên kết đến thay vào đó
- Đoạn văn dài giải thích lý thuyết
- Thông tin thay đổi thường xuyên
Giữ AGENTS.md dưới 300 dòng. Các file dài hơn sẽ bắt đầu tiêu tốn quá nhiều ngữ cảnh và việc tuân thủ hướng dẫn thực sự giảm xuống.
Đây là một ví dụ tối thiểu nhưng hiệu quả:
1# AGENTS.md - Clawdbot Workspace23## Chỉ thị vận hành cốt lõi4Assistant của tôi hoạt động như một người trợ giúp chủ động cho công việc kinh doanh của tôi.56**Nhiệm vụ:**7- Giải quyết càng nhiều việc càng tốt8- Hãy chủ động - đừng chờ được yêu cầu910## Công cụ chính11- **Email:** Kiểm tra hộp thư đến hàng ngày, gắn cờ các mục khẩn cấp12- **Lịch:** Xác minh không có xung đột trước khi lên lịch13- **Trình quản lý tác vụ:** Đồng bộ công việc đã hoàn thành vào bảng điều khiển1415## Quy tắc cứng16- KHÔNG BAO GIỜ khởi động lại dịch vụ mà không có sự cho phép rõ ràng17- Luôn xác minh ngày tháng bằng lệnh `date` trước khi lên lịch18- Ghi lại tất cả công việc đã hoàn thành vào hệ thống theo dõi
Đó là khoảng 20 dòng chỉ thị cốt lõi. Nó cung cấp cho agent của bạn mọi thứ cần thiết để làm việc hiệu quả mà không cần làm rõ liên tục.
SOUL.md: Tính cách và ranh giới
SOUL.md xác định agent của bạn là ai và nó nên giao tiếp như thế nào. Đây là nơi tính cách tồn tại.
1# SOUL.md - Tính cách & Ranh giới23- Giữ câu trả lời ngắn gọn và trực tiếp.4- Đặt câu hỏi làm rõ khi cần.5- Không bao giờ gửi phản hồi streaming/partial ra các bề mặt nhắn tin bên ngoài.
Nếu AGENTS.md là sách hướng dẫn vận hành, thì SOUL.md là hồ sơ tính cách. Một số người dùng viết tính cách mở rộng ở đây. Những người khác giữ nó ở mức tối thiểu. Cả hai đều hiệu quả, tùy thuộc vào mức độ tùy chỉnh tính cách bạn muốn.
IDENTITY.md và USER.md: Ai là ai
Hai file này thiết lập mối quan hệ giữa agent của bạn và bạn.
IDENTITY.md xác định agent của bạn:
1# IDENTITY.md - Danh tính Agent23- Tên: [Tên Agent của bạn]4- Loại: [Tùy chọn: mô tả thú vị]5- Phong cách: Thông minh, hữu ích, đáng tin cậy, người giải quyết vấn đề kiên cường6- Biểu tượng cảm xúc: [Biểu tượng cảm xúc bạn chọn]
USER.md xác định bạn:
1# USER.md - Hồ sơ người dùng23- Tên: [Tên của bạn]4- Cách xưng hô ưa thích: [Biệt danh]5- Múi giờ: [Múi giờ của bạn]6- Điện thoại: [Số của bạn]7- Lịch: [Nền tảng lịch và email]
Tại sao lại là các file riêng biệt? Bởi vì chúng phục vụ các mục đích khác nhau. IDENTITY.md hiếm khi thay đổi sau khi được thiết lập. USER.md cập nhật khi sở thích của bạn phát triển. Giữ chúng riêng biệt giúp việc bảo trì dễ dàng hơn.
HEARTBEAT.md: Kiểm tra theo lịch trình
File này kiểm soát những gì agent của bạn làm trong các lần poll heartbeat - những khoảnh khắc được lên lịch khi hệ thống kiểm tra xem có điều gì cần chú ý hay không.
1# HEARTBEAT.md23**Nếu tin nhắn chứa "⚠️ EXECUTION CRON":**4- Đây KHÔNG phải là kiểm tra heartbeat - đây là công việc cần làm5- Đọc hướng dẫn đầy đủ trong tin nhắn6- Thực hiện tất cả các bước cần thiết7- Không bao giờ trả về HEARTBEAT_OK89**Nếu không:**10- Nếu không có gì cần chú ý, trả về HEARTBEAT_OK11- Giữ nó ở mức tối thiểu
Heartbeats rất mạnh mẽ để tạo ra các agent chủ động. Agent của bạn có thể kiểm tra lịch của bạn, quét hộp thư đến của bạn hoặc chạy bất kỳ quy trình làm việc tự động nào theo lịch trình, tất cả đều được kích hoạt bởi các poll heartbeat.
TOOLS.md: Tài liệu công cụ bên ngoài
File này chứa ghi chú của bạn về các công cụ bên ngoài và quy ước. Nó không xác định công cụ nào tồn tại (OpenClaw xử lý việc đó nội bộ), nhưng nó là nơi bạn ghi lại cách BẠN sử dụng chúng.
1# TOOLS.md - Ghi chú công cụ người dùng23## CLI Email4- Tài khoản: [email protected]5- Phổ biến: `cli email search`, `cli calendar create`67## API quản lý tác vụ8- Vị trí token: ~/.secrets/task-api-token.txt9- Luôn sử dụng `limit=100` để tránh các vấn đề phân trang10- Chuyển đổi trạng thái: [ghi lại quy trình làm việc cụ thể của bạn]1112## Công cụ scraping web (khi các trang web chặn các yêu cầu thông thường)13- Vị trí: ~/clawd/.venv/scraper14- Sử dụng chế độ ẩn danh cho các trang web được bảo vệ
Đây trở thành hướng dẫn tham khảo cá nhân của bạn. Khi agent của bạn cần sử dụng một công cụ, nó sẽ kiểm tra TOOLS.md để biết các quy ước cụ thể của bạn.
Thư mục skills/: Quy trình làm việc có thể tái sử dụng
Skills là nơi OpenClaw trở nên mạnh mẽ. Mỗi skill là một quy trình làm việc khép kín mà agent của bạn có thể gọi khi tác vụ phù hợp với mô tả của skill.
Mỗi skill nằm trong thư mục con riêng của nó với một file SKILL.md:
1skills/2├── meeting-prep/3│ └── SKILL.md4├── social-post-writer/5│ ├── SKILL.md6│ └── references/7│ └── templates.md8└── podcast-show-notes/9 └── SKILL.md
Một file SKILL.md sử dụng YAML frontmatter để mô tả khi nào nên sử dụng nó:
1---2name: meeting-prep3description: Nghiên cứu và tóm tắt tự động trước cuộc gọi. Sử dụng khi người dùng yêu cầu kiểm tra các cuộc họp sắp tới hoặc chạy chuẩn bị cuộc họp.4---56# Skill Chuẩn bị cuộc họp78## Khi nào kích hoạt:9- Người dùng yêu cầu kiểm tra các cuộc họp sắp tới10- Được lên lịch chạy mỗi 10 phút qua cron11- Chỉ tóm tắt cho CUỘC GỌI LẦN ĐẦU1213## Quy trình:141. Kiểm tra lịch cho các cuộc họp trong 15-45 phút tới152. Nghiên cứu người tham dự (LinkedIn, trang web công ty)163. Tạo tài liệu tóm tắt174. Đính kèm liên kết đến sự kiện lịch
Sự khác biệt chính so với các hướng dẫn tĩnh: skills có thể đi kèm với các file hỗ trợ. File references/templates.md có thể chứa các đầu ra ví dụ, các định dạng đã được chứng minh hoặc ngữ cảnh bổ sung chỉ tải khi skill đang hoạt động.
Thư mục memory/: Ngữ cảnh liên tục
Đây là bộ nhớ dài hạn của agent của bạn. Bản ghi phiên, sở thích đã học và nhật ký hàng ngày đều nằm ở đây.
1memory/2├── 2026-03-22.md3├── 2026-03-21.md4├── email-style.md5├── business-context-2026-02.md6└── workflow-playbook.md
Các thực hành tốt:
- Giữ nhật ký hàng ngày tại memory/YYYY-MM-DD.md
- Khi bắt đầu phiên, agent của bạn đọc hôm nay + hôm qua nếu có
- Ghi lại các sự kiện, sở thích và quyết định bền vững
- Tránh lưu trữ bí mật
Các file memory là thứ cung cấp cho agent của bạn ngữ cảnh qua các phiên. Nếu không có chúng, mọi cuộc trò chuyện đều bắt đầu từ con số không.
Thư mục .secrets/: Thông tin đăng nhập
API token, mật khẩu và cấu hình nhạy cảm nằm ở đây. Thư mục này nên được gitignored và không bao giờ được commit.
1.secrets/2├── task-api-token.txt3├── openai-api-key.txt4├── anthropic-api-key.txt5└── service-credentials.txt
AGENTS.md hoặc TOOLS.md của bạn có thể tham chiếu các đường dẫn này mà không để lộ các giá trị thực tế.
Cấu hình channel: Nơi bạn nói chuyện với agent của mình
OpenClaw hỗ trợ nhiều kênh nhắn tin: Discord, Telegram, Signal, WhatsApp, v.v. Cấu hình channel nằm trong cấu hình gateway của bạn (được quản lý thông qua các lệnh clawdbot gateway).
Các khái niệm chính:
- Mỗi channel có hành vi phiên riêng
- Bạn có thể có nhiều channel hoạt động đồng thời
- Các quy tắc dành riêng cho channel (như "không trả lời trừ khi được @nhắc đến trong Discord") nằm trong AGENTS.md
Bức tranh toàn cảnh
Đây là cách mọi thứ kết hợp với nhau:
1~/clawd/2├── AGENTS.md # Hướng dẫn vận hành (sử dụng hàng ngày)3├── SOUL.md # Tính cách và ranh giới4├── IDENTITY.md # Danh tính Agent5├── USER.md # Hồ sơ của bạn6├── HEARTBEAT.md # Hành vi kiểm tra theo lịch trình7├── TOOLS.md # Tài liệu công cụ bên ngoài8├── BOOTSTRAP.md # Nghi thức chạy lần đầu (xóa sau khi dùng)9│10├── skills/ # Quy trình làm việc tùy chỉnh11│ ├── meeting-prep/12│ ├── podcast-show-notes/13│ └── social-post-writer/14│15├── memory/ # Ngữ cảnh liên tục16│ ├── 2026-03-22.md17│ └── key-context.md18│19├── .secrets/ # Khóa API và thông tin đăng nhập (gitignored)20│ ├── task-api-token.txt21│ └── anthropic-api-key.txt22│23└── output/ # Các file và bản xuất được tạo ra
Một thiết lập thực tế để bắt đầu
Nếu bạn đang bắt đầu từ đầu, đây là một quy trình hoạt động tốt.
Bước 1. Chạy openclaw onboard và hoàn thành thiết lập ban đầu. Chọn nhà cung cấp mô hình của bạn và kết nối ít nhất một channel.
Bước 2. Tạo thư mục workspace của bạn và thêm AGENTS.md với các chỉ thị cốt lõi của bạn. Bắt đầu với 10-20 dòng bao gồm các trường hợp sử dụng chính của bạn.
Bước 3. Thêm IDENTITY.md, USER.md và SOUL.md. Chúng thiết lập mối quan hệ và tính cách.
Bước 4. Tạo skill đầu tiên của bạn cho một quy trình làm việc bạn lặp đi lặp lại. Chuẩn bị cuộc họp, dự thảo email hoặc sáng tạo nội dung là những điểm khởi đầu tốt.
Bước 5. Thiết lập memory/ với một mẫu nhật ký hàng ngày. Agent của bạn sẽ bắt đầu xây dựng ngữ cảnh theo thời gian.
Bước 6. Thêm TOOLS.md khi bạn khám phá các mẫu cụ thể cho công cụ đáng ghi lại.
Đó thực sự là tất cả những gì bạn cần cho 95% các trường hợp sử dụng. Các tính năng nâng cao như công việc cron, thiết lập nhiều agent và plugin channel tùy chỉnh sẽ xuất hiện khi bạn có các quy trình làm việc cụ thể đáng tự động hóa.
Hiểu biết chính
Workspace OpenClaw của bạn thực sự là một giao thức để nói với AI assistant của bạn bạn là ai, bạn cần làm gì và nó nên tuân theo những quy tắc nào. Bạn càng xác định rõ ràng điều đó, bạn càng dành ít thời gian để sửa lỗi cho agent và càng dành nhiều thời gian để nó làm công việc hữu ích.
AGENTS.md là file có đòn bẩy cao nhất của bạn. Làm đúng file đó trước. Mọi thứ khác là tối ưu hóa.
Hãy bắt đầu nhỏ, tinh chỉnh khi bạn tiến hành và coi nó như bất kỳ cơ sở hạ tầng nào khác trong quy trình làm việc của bạn: thứ mang lại lợi ích mỗi ngày khi nó được thiết lập đúng cách.
PS: Openclaw chỉ là sự khởi đầu.
Bên trong cộng đồng Build With AI của chúng tôi, tôi sẽ dạy bạn cách xây dựng các agent, ứng dụng và tự động hóa tùy chỉnh mà bạn có thể tự sử dụng hoặc bán cho khách hàng. Sắp ra mắt.
Tham gia danh sách chờ tại đây:
