SOUL.md Là Gì?
Mỗi tác tử OpenClaw đều có một tệp gọi là SOUL.md đóng vai trò như lớp nhận dạng nền tảng của nó. Đó là một tệp Markdown thuần túy định nghĩa tính cách, phong cách giao tiếp, giá trị cốt lõi, và rào chắn hành vi của tác tử. OpenClaw đọc tệp này khi khởi động và áp dụng nó như một prompt cấp hệ thống cho mọi tương tác — dù tác tử đang phản hồi tin nhắn buổi sáng, soạn email, hay chạy tác vụ theo lịch lúc 3 giờ sáng.
Không giống các chatbot truyền thống đặt lại tính cách với mỗi cuộc hội thoại, tác tử OpenClaw duy trì cảm giác bản thể nhất quán thông qua SOUL.md. Cùng giọng điệu, cùng ưu tiên, cùng quy tắc — luôn luôn.
Nó Ở Đâu?
SOUL.md nằm tại:
~/.openclaw/agents/<agent_id>/SOUL.md
Nếu bạn chỉ có một tác tử (mặc định), đường dẫn thường là ~/.openclaw/agents/default/SOUL.md. OpenClaw tạo một SOUL.md tối thiểu trong quá trình khởi tạo, nhưng hầu hết người dùng tùy chỉnh nó rất nhiều theo thời gian.
Giải Phẫu Một SOUL.md Tốt
Một SOUL.md có cấu trúc tốt gồm bốn phần:
1. Danh Tính
Tác tử là ai? Tên gì? Vai trò gì?
# Identity
You are Atlas, a technical assistant for a software engineering team.
You work for Acme Corp. Your primary user is Sarah, the lead engineer.
2. Phong Cách Giao Tiếp
Tác tử nên nói chuyện như thế nào? Trang trọng hay thân mật? Ngắn gọn hay chi tiết?
# Communication Style
- Be concise. Prefer bullet points over paragraphs.
- Never use emojis unless the user does first.
- Default to English. Switch to Chinese if the user writes in Chinese.
- When explaining technical concepts, use analogies.
3. Giá Trị Cốt Lõi và Quy Tắc
Ranh giới hành vi không thể thương lượng. Đây là phần quan trọng nhất cho an toàn và căn chỉnh.
# Rules
- Never delete files without explicit confirmation.
- Never send messages to contacts unless specifically asked.
- Always summarize what you plan to do before executing multi-step tasks.
- If you are unsure about something, say so. Do not guess.
- Never share API keys, passwords, or sensitive data in chat messages.
4. Kiến Thức Chuyên Ngành
Ngữ cảnh mà tác tử luôn cần truy cập.
# Context
- Our tech stack: Next.js, PostgreSQL, Redis, deployed on AWS
- Sprint cycle: 2-week sprints, standup at 9:30 AM PST daily
- Code style: We follow the Airbnb ESLint config
- Jira project key: ACME
Ví Dụ Thực Tế
Phong Cách Tối Giản
You are a helpful assistant. Be brief. Confirm before destructive actions.
Điều này hoạt động. SOUL.md không cần phải dài. Nhưng hướng dẫn cụ thể tạo ra hành vi cụ thể.
Trợ Lý Điều Hành
# Identity
You are Monday, a personal executive assistant.
# Style
- Professional but warm tone
- Proactive: suggest follow-ups after completing tasks
- Morning briefing at 8 AM: calendar, unread messages, weather, top news
# Rules
- Never schedule meetings without checking calendar conflicts first
- Always include timezone when mentioning times
- Summarize long emails in 3 bullet points before forwarding
Tác Tử DevOps
# Identity
You are Ops, a DevOps automation agent for a small startup.
# Style
- Terse, terminal-style responses
- Use code blocks for all commands
- No pleasantries
# Rules
- Never run destructive commands (rm -rf, DROP TABLE, force push) without confirmation
- Log all infrastructure changes to #ops-log channel
- Alert on-call if any health check fails twice in a row
# Context
- Infrastructure: 3 EC2 instances, RDS PostgreSQL, CloudFront CDN
- Monitoring: Datadog, PagerDuty
- Deploy: GitHub Actions -> ECR -> ECS
Mẹo Viết Soul Tốt Hơn
- 1.Cụ thể, không mơ hồ. "Be helpful" không tạo ra gì. "Tối đa 5 gạch đầu dòng, xác nhận trước khi xóa tệp" tạo ra hành vi nhất quán.
- 2.Bắt đầu ngắn, cải tiến dần. Bắt đầu với 10 dòng. Chỉ thêm quy tắc khi bạn nhận thấy tác tử làm điều gì đó bạn không muốn. Mỗi dòng trong SOUL.md nên xứng đáng vị trí của nó.
- 3.Thử nghiệm với các trường hợp biên. Yêu cầu tác tử làm điều gì đó mơ hồ hoặc rủi ro. Xem cách nó phản hồi. Điều chỉnh quy tắc.
- 4.Dùng tác tử để viết linh hồn của chính nó. Sau một tuần sử dụng, hãy hỏi tác tử: "Dựa trên các tương tác của chúng ta cho đến nay, hãy đề xuất cải tiến cho SOUL.md của bạn." Nó thường xác định được các khoảng trống bạn đã bỏ lỡ.
- 5.Giữ dưới 2.000 từ. SOUL.md được tải vào mọi prompt. Một linh hồn cồng kềnh lãng phí token và làm loãng các quy tắc quan trọng. Nếu bạn cần kiến thức chuyên ngành mở rộng, hãy sử dụng skills hoặc memory thay thế.
SOUL.md vs. Skills vs. Memory
| Lớp | Mục đích | Tính bền vững |
|---|---|---|
| SOUL.md | Danh tính, giọng điệu, quy tắc | Luôn được tải |
| Skills | Khả năng (điều tác tử có thể làm) | Tải theo yêu cầu |
| Memory | Sự kiện học được theo thời gian | Tăng trưởng theo thời gian |
SOUL.md định nghĩa ai là tác tử. Skills định nghĩa nó có thể làm gì. Memory định nghĩa nó biết gì. Cả ba hoạt động cùng nhau, nhưng SOUL.md là nền tảng định hình cách skills được sử dụng và cách memories được diễn giải.
Bắt Đầu
- 1.Mở SOUL.md:
nano ~/.openclaw/agents/default/SOUL.md - 2.Viết danh tính, phong cách, và quy tắc của bạn
- 3.Khởi động lại OpenClaw:
openclaw restart - 4.Thử nghiệm bằng cách trò chuyện với tác tử và quan sát giọng điệu và hành vi
- 5.Cải tiến lặp lại
Linh hồn của tác tử chỉ là văn bản Markdown. Nếu bạn có thể viết tài liệu, bạn có thể tạo hình một tác tử mang dấu ấn của bạn.
Để xem thêm ví dụ và mẫu đóng góp từ cộng đồng, hãy xem tài liệu tham khảo SOUL.md chính thức và dự án mẫu soul.md.