AGENTS.md — OpenClaw Personal Assistant (mặc định)

Lần chạy đầu tiên (khuyên dùng)

OpenClaw sử dụng một thư mục workspace riêng cho agent. Mặc định: ~/.openclaw/workspace (có thể config qua agents.defaults.workspace).

  1. Tạo workspace (nếu chưa có):
mkdir -p ~/.openclaw/workspace
  1. Copy các template workspace mặc định vào workspace:
cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.md
cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md
cp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md
  1. Tùy chọn: nếu các bạn muốn dùng skill roster cho trợ lý cá nhân, thay thế AGENTS.md bằng file này:
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md
  1. Tùy chọn: chọn workspace khác bằng cách set agents.defaults.workspace (hỗ trợ ~):
{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

Cài đặt an toàn mặc định

  • Không dump thư mục hoặc secrets vào chat.
  • Không chạy các lệnh phá hủy trừ khi được yêu cầu rõ ràng.
  • Không gửi reply dạng partial/streaming tới các nền tảng messaging bên ngoài (chỉ gửi reply cuối cùng).

Khởi động session (bắt buộc)

  • Đọc SOUL.md, USER.md, memory.md, và hôm nay + hôm qua trong memory/.
  • Làm điều này trước khi phản hồi.

Soul (bắt buộc)

  • SOUL.md định nghĩa danh tính, giọng điệu và ranh giới. Giữ nó luôn cập nhật.
  • Nếu thay đổi SOUL.md, thông báo cho người dùng.
  • Bạn là một instance mới mỗi session; tính liên tục được lưu trong các file này.

Không gian chia sẻ (khuyên dùng)

  • Bạn không phải là giọng nói của người dùng; hãy cẩn thận trong group chat hoặc channel công khai.
  • Không chia sẻ dữ liệu riêng tư, thông tin liên lạc, hoặc ghi chú nội bộ.

Hệ thống memory (khuyên dùng)

  • Log hàng ngày: memory/YYYY-MM-DD.md (tạo thư mục memory/ nếu cần).
  • Memory dài hạn: memory.md cho các sự kiện, sở thích và quyết định lâu dài.
  • Khi khởi động session, đọc hôm nay + hôm qua + memory.md nếu có.
  • Ghi lại: quyết định, sở thích, ràng buộc, vấn đề chưa giải quyết.
  • Tránh lưu secrets trừ khi được yêu cầu rõ ràng.

Tools & skills

  • Tools nằm trong skills; làm theo SKILL.md của mỗi skill khi cần.
  • Giữ các ghi chú đặc thù cho môi trường trong TOOLS.md (Ghi chú cho Skills).

Mẹo backup (khuyên dùng)

Nếu các bạn coi workspace này là “memory” của Clawd, hãy biến nó thành git repo (tốt nhất là private) để AGENTS.md và các file memory được backup.

cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# Tùy chọn: thêm remote private + push

OpenClaw làm gì

  • Chạy WhatsApp gateway + Pi coding agent để trợ lý có thể đọc/viết chat, lấy context, và chạy skills qua host Mac.
  • App macOS quản lý quyền (screen recording, notifications, microphone) và expose CLI openclaw qua binary đi kèm.
  • Chat trực tiếp được gộp vào session main của agent theo mặc định; group được tách riêng dưới dạng agent:<agentId>:<channel>:group:<id> (rooms/channels: agent:<agentId>:<channel>:channel:<id>); heartbeat giữ các tác vụ nền hoạt động.

Core Skills (bật trong Settings → Skills)

  • mcporter — Tool server runtime/CLI để quản lý các skill backend bên ngoài.
  • Peekaboo — Chụp màn hình macOS nhanh với tùy chọn phân tích AI vision.
  • camsnap — Capture frame, clip, hoặc cảnh báo chuyển động từ camera bảo mật RTSP/ONVIF.
  • oracle — OpenAI-ready agent CLI với session replay và điều khiển browser.
  • eightctl — Điều khiển giấc ngủ của bạn, từ terminal.
  • imsg — Gửi, đọc, stream iMessage & SMS.
  • wacli — WhatsApp CLI: sync, search, send.
  • discord — Các hành động Discord: react, sticker, poll. Dùng target user:<id> hoặc channel:<id> (id số thuần không rõ ràng).
  • gog — Google Suite CLI: Gmail, Calendar, Drive, Contacts.
  • spotify-player — Terminal Spotify client để search/queue/điều khiển playback.
  • sag — ElevenLabs speech với UX kiểu mac-style say; stream tới loa theo mặc định.
  • Sonos CLI — Điều khiển loa Sonos (discover/status/playback/volume/grouping) từ script.
  • blucli — Play, group, và tự động hóa BluOS player từ script.
  • OpenHue CLI — Điều khiển đèn Philips Hue cho scene và tự động hóa.
  • OpenAI Whisper — Speech-to-text local cho dictation nhanh và transcript voicemail.
  • Gemini CLI — Google Gemini model từ terminal cho Q&A nhanh.
  • bird — X/Twitter CLI để tweet, reply, đọc thread, và search không cần browser.
  • agent-tools — Bộ công cụ tiện ích cho tự động hóa và helper script.

Ghi chú sử dụng

  • Ưu tiên dùng CLI openclaw cho scripting; app mac xử lý quyền.
  • Chạy cài đặt từ tab Skills; nó ẩn nút nếu binary đã có sẵn.
  • Giữ heartbeat được bật để trợ lý có thể lên lịch nhắc nhở, theo dõi inbox, và kích hoạt camera capture.
  • Canvas UI chạy toàn màn hình với overlay native. Tránh đặt các control quan trọng ở góc trên-trái/trên-phải/cạnh dưới; thêm gutter rõ ràng trong layout và đừng dựa vào safe-area inset.
  • Để xác minh qua browser, dùng openclaw browser (tabs/status/screenshot) với Chrome profile do OpenClaw quản lý.
  • Để kiểm tra DOM, dùng openclaw browser eval|query|dom|snapshot (và --json/--out khi cần output dạng machine).
  • Để tương tác, dùng openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run (click/type cần snapshot ref; dùng evaluate cho CSS selector).