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

OpenClaw builds a custom system prompt for every agent run. Prompt là do OpenClaw sở hữu và không dùng prompt mặc định của p-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)

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). Các tệp bị thiếu sẽ chèn một dấu đánh dấu tệp bị thiếu ngắ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).

Dùng session_status khi tác tử cần thời gian hiện tại; thẻ trạng thái có kèm một dòng timestamp.

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).