Chuyển đến nội dung chính

​
Lời nhắc hệ thống

OpenClaw builds a custom system prompt for every agent run. Prompt thuộc quyền sở hữu của OpenClaw và không sử dụng prompt mặc định của pi-coding-agent. Prompt được OpenClaw lắp ghép và chèn vào mỗi lần chạy tác tử.

​
Cấu trúc

Prompt được thiết kế gọn nhẹ và sử dụng các phần cố định:
  • Tooling: danh sách công cụ hiện tại + mô tả ngắn.
  • Safety: nhắc nhở guardrail ngắn để tránh hành vi tìm kiếm quyền lực hoặc né tránh giám sát.
  • Skills (khi có): hướng dẫn mô hình cách tải chỉ dẫn kỹ năng theo yêu cầu.
  • OpenClaw Self-Update: cách chạy config.apply và update.run.
  • Workspace: thư mục làm việc (agents.defaults.workspace).
  • Documentation: đường dẫn cục bộ tới tài liệu OpenClaw (repo hoặc gói npm) và khi nào cần đọc.
  • Workspace Files (injected): cho biết các tệp bootstrap được chèn bên dưới.
  • Sandbox (khi bật): cho biết runtime trong sandbox, các đường dẫn sandbox, và liệu có quyền exec nâng cao hay không.
  • Current Date & Time: thời gian theo địa phương của người dùng, múi giờ và định dạng thời gian.
  • Reply Tags: cú pháp thẻ trả lời tùy chọn cho các nhà cung cấp được hỗ trợ.
  • Heartbeats: prompt heartbeat và hành vi ack.
  • Runtime: host, OS, node, model, repo root (khi phát hiện), mức độ suy nghĩ (một dòng).
  • Reasoning: mức độ hiển thị hiện tại + gợi ý bật/tắt /reasoning.
Safety guardrails in the system prompt are advisory. Chúng hướng dẫn hành vi của mô hình nhưng không cưỡng chế chính sách. Sử dụng chính sách công cụ, phê duyệt thực thi, sandboxing và allowlist kênh để cưỡng chế cứng; các toán tử có thể vô hiệu hóa chúng theo thiết kế.

​
Chế độ prompt

OpenClaw có thể kết xuất các system prompt nhỏ hơn cho các tác nhân con. Runtime đặt một promptMode cho mỗi lần chạy (không phải cấu hình hướng người dùng):
  • full (mặc định): bao gồm tất cả các phần ở trên.
  • minimal: dùng cho các tác nhân con; lược bỏ Skills, Memory Recall, OpenClaw Self-Update, Model Aliases, User Identity, Reply Tags, Messaging, Silent Replies, và Heartbeats. Tooling, Safety, Workspace, Sandbox, Ngày & Giờ Hiện Tại (khi biết), Runtime và ngữ cảnh được chèn vẫn khả dụng.
  • none: chỉ trả về dòng nhận diện cơ bản.
Khi promptMode=minimal, các prompt được chèn thêm sẽ được gắn nhãn Subagent Context thay vì Group Chat Context.

​
Chèn bootstrap workspace

Các tệp bootstrap được cắt gọn và nối vào dưới Project Context để mô hình thấy được ngữ cảnh danh tính và hồ sơ mà không cần đọc tường minh:
  • AGENTS.md
  • SOUL.md
  • TOOLS.md
  • IDENTITY.md
  • USER.md
  • HEARTBEAT.md
  • BOOTSTRAP.md (chỉ trên workspace hoàn toàn mới)
  • MEMORY.md và/hoặc memory.md (khi tồn tại trong workspace; có thể chèn một hoặc cả hai)
Tất cả các tệp này đều được chèn vào context window ở mỗi lượt, điều này có nghĩa là chúng tiêu tốn token. Hãy giữ chúng ngắn gọn — đặc biệt là MEMORY.md, vì tệp này có thể tăng dần theo thời gian và dẫn đến mức sử dụng context cao ngoài dự kiến cũng như việc compaction xảy ra thường xuyên hơn.
Lưu ý: các tệp memory/*.md theo ngày không được chèn tự động. Chúng được truy cập theo yêu cầu thông qua các công cụ memory_search và memory_get, vì vậy chúng không tính vào context window trừ khi model chủ động đọc chúng.
Các tệp lớn bị cắt bớt với một dấu đánh dấu. Kích thước tối đa cho mỗi tệp được kiểm soát bởi agents.defaults.bootstrapMaxChars (mặc định: 20000). Tổng nội dung bootstrap được chèn trên tất cả các tệp bị giới hạn bởi agents.defaults.bootstrapTotalMaxChars (mặc định: 24000). Các tệp bị thiếu sẽ chèn một dấu đánh dấu ngắn cho biết tệp không tồn tại. Các phiên sub-agent chỉ chèn AGENTS.md và TOOLS.md (các tệp bootstrap khác bị lọc bỏ để giữ ngữ cảnh của sub-agent nhỏ gọn). Các hook nội bộ có thể chặn bước này thông qua agent:bootstrap để biến đổi hoặc thay thế các tệp bootstrap được chèn (ví dụ hoán đổi SOUL.md bằng một persona thay thế). Để kiểm tra mức đóng góp của từng tệp được chèn (thô so với đã chèn, cắt bớt, cộng thêm overhead schema của công cụ), dùng /context list hoặc /context detail. Xem Context.

​
Xử lý thời gian

System prompt bao gồm một mục Current Date & Time chuyên biệt khi múi giờ người dùng được biết. Để giữ bộ nhớ đệm prompt ổn định, giờ đây nó chỉ bao gồm múi giờ (không có đồng hồ động hay định dạng thời gian). Xem Date & Time để biết đầy đủ chi tiết hành vi. Cấu hình bằng:
  • agents.defaults.userTimezone
  • agents.defaults.timeFormat (auto | 12 | 24)
Xem Date & Time để biết đầy đủ chi tiết hành vi.

​
Skills

Khi tồn tại các kỹ năng đủ điều kiện, OpenClaw chèn một danh sách kỹ năng khả dụng gọn nhẹ (formatSkillsForPrompt) bao gồm đường dẫn tệp cho mỗi kỹ năng. Prompt hướng dẫn mô hình dùng read để tải SKILL.md tại vị trí đã liệt kê (workspace, managed, hoặc bundled). Nếu không có kỹ năng nào đủ điều kiện, mục Skills sẽ bị lược bỏ. 
<available_skills>
  <skill>
    <name>...</name>
    <description>...</description>
    <location>...</location>
  </skill>
</available_skills>
Cách này giữ prompt nền nhỏ gọn trong khi vẫn cho phép sử dụng skill có mục tiêu.

​
Documentation

Khi khả dụng, system prompt bao gồm một mục Documentation trỏ tới thư mục tài liệu OpenClaw cục bộ (hoặc docs/ trong workspace repo hoặc tài liệu được đóng gói trong npm package) và cũng ghi chú mirror công khai, repo nguồn, Discord cộng đồng và ClawHub (https://clawhub.com) để khám phá kỹ năng. Prompt hướng dẫn mô hình tham khảo tài liệu cục bộ trước cho hành vi, lệnh, cấu hình hoặc kiến trúc của OpenClaw, và tự chạy openclaw status khi có thể (chỉ hỏi người dùng khi nó không có quyền truy cập).