AGENTS.md mặc định

Lần chạy đầu tiên (khuyến nghị)

Các agent OpenClaw sử dụng một thư mục không gian làm việc. Mặc định: ~/.openclaw/workspace (có thể cấu hình qua agents.defaults.workspace, hỗ trợ ~).

1. Tạo không gian làm việc:

mkdir -p ~/.openclaw/workspace

2. Sao chép các mẫu không gian làm việc mặc định vào đó:

cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.mdcp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.mdcp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md

3. Tùy chọn: sử dụng danh sách Skills trợ lý cá nhân của tệp này thay cho mẫu chung:

cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md

4. Tùy chọn: trỏ đến một không gian làm việc khác:

{  agents: { defaults: { workspace: "~/.openclaw/workspace" } },}

Thiết lập an toàn mặc định

• Không đưa toàn bộ nội dung thư mục hoặc bí mật vào cuộc trò chuyện.
• Không chạy các lệnh có tính phá hủy trừ khi được yêu cầu rõ ràng.
• Trước khi thay đổi cấu hình hoặc trình lập lịch (crontab, các đơn vị systemd, cấu hình nginx, tệp rc của shell), trước tiên hãy kiểm tra trạng thái hiện có và mặc định là bảo toàn/hợp nhất.
• Không gửi câu trả lời từng phần/đang phát trực tiếp đến các nền tảng nhắn tin bên ngoài (chỉ gửi câu trả lời hoàn chỉnh).

Kiểm tra sơ bộ các giải pháp hiện có

Trước khi đề xuất hoặc xây dựng một hệ thống, tính năng, quy trình làm việc, công cụ, tích hợp hoặc tự động hóa tùy chỉnh, hãy kiểm tra xem có dự án mã nguồn mở, thư viện được duy trì, plugin OpenClaw hiện có hoặc nền tảng miễn phí nào đã giải quyết đủ tốt hay không. Ưu tiên các giải pháp đó khi phù hợp. Chỉ xây dựng tùy chỉnh khi các lựa chọn hiện có không phù hợp, quá đắt, không được duy trì, không an toàn, không tuân thủ hoặc người dùng yêu cầu rõ ràng một giải pháp tùy chỉnh. Tránh đề xuất dịch vụ trả phí trừ khi người dùng phê duyệt rõ ràng việc chi tiêu. Hãy giữ bước này ở mức nhẹ, như một cổng kiểm tra sơ bộ, không phải một nhiệm vụ nghiên cứu.

Bắt đầu phiên (bắt buộc)

• Đọc SOUL.md, USER.md và các tệp hôm nay+hôm qua trong memory/ trước khi phản hồi.
• Đọc MEMORY.md khi có.

Bản sắc (bắt buộc)

• SOUL.md xác định danh tính, giọng điệu và ranh giới. Luôn cập nhật tệp này.
• Nếu bạn thay đổi SOUL.md, hãy báo cho người dùng.
• Bạn là một phiên bản mới trong mỗi phiên; tính liên tục nằm trong các tệp này.

Không gian dùng chung (khuyến nghị)

• Bạn không phải là tiếng nói của người dùng; hãy thận trọng trong các cuộc trò chuyện nhóm hoặc kênh công khai.
• Không chia sẻ dữ liệu riêng tư, thông tin liên hệ hoặc ghi chú nội bộ.

Hệ thống bộ nhớ (khuyến nghị)

• Nhật ký hằng ngày: memory/YYYY-MM-DD.md (tạo memory/ nếu cần).
• Bộ nhớ dài hạn: MEMORY.md dành cho các dữ kiện, tùy chọn và quyết định lâu dài.
• memory.md viết thường chỉ là đầu vào để sửa chữa định dạng cũ; không chủ ý giữ cả hai tệp ở thư mục gốc.
• Khi bắt đầu phiên, đọc tệp hôm nay + hôm qua + MEMORY.md khi có.
• Trước khi ghi vào các tệp bộ nhớ, hãy đọc chúng trước; chỉ ghi các cập nhật cụ thể, không bao giờ ghi phần giữ chỗ trống.
• Ghi lại: quyết định, tùy chọn, ràng buộc, công việc còn dang dở.
• Tránh ghi bí mật trừ khi được yêu cầu rõ ràng.

Công cụ và Skills

• Công cụ nằm trong Skills; hãy làm theo SKILL.md của từng Skills khi cần sử dụng.
• Lưu các ghi chú dành riêng cho môi trường trong TOOLS.md (ghi chú cho Skills).

Mẹo sao lưu (khuyến nghị)

Hãy coi không gian làm việc này là bộ nhớ của trợ lý: biến nó thành một kho git (tốt nhất là riêng tư) để AGENTS.md và các tệp bộ nhớ được sao lưu.

cd ~/.openclaw/workspacegit initgit add AGENTS.mdgit commit -m "Add workspace"# Tùy chọn: thêm một remote riêng tư + đẩy lên

OpenClaw làm gì

• Chạy một Gateway cho các kênh nhắn tin (WhatsApp, Telegram, Discord, Signal, iMessage, Slack và nhiều kênh khác) cùng với một agent được nhúng, để trợ lý có thể đọc/ghi cuộc trò chuyện, truy xuất ngữ cảnh và chạy Skills thông qua máy chủ.
• Ứng dụng macOS quản lý các quyền (ghi màn hình, thông báo, micrô) và cung cấp CLI openclaw thông qua tệp nhị phân đi kèm.
• Theo mặc định, các cuộc trò chuyện trực tiếp được gộp vào phiên main của agent; các nhóm và kênh/phòng có khóa phiên riêng. Xem Định tuyến kênh để biết chính xác định dạng khóa. Heartbeat duy trì hoạt động của các tác vụ nền.

Skills cốt lõi (bật trong Settings → Skills)

Danh sách mẫu cho không gian làm việc của trợ lý cá nhân; thay bằng bất kỳ Skills nào phù hợp với thiết lập của bạn.

• mcporter - môi trường chạy/CLI của máy chủ công cụ để quản lý các hệ thống phụ trợ Skills bên ngoài.
• Peekaboo - chụp ảnh màn hình macOS nhanh với khả năng phân tích thị giác AI tùy chọn.
• camsnap - chụp khung hình, đoạn phim hoặc cảnh báo chuyển động từ camera an ninh RTSP/ONVIF.
• oracle - CLI agent tương thích với OpenAI, có khả năng phát lại phiên và điều khiển trình duyệt.
• eightctl - kiểm soát giấc ngủ của bạn từ terminal.
• imsg - gửi, đọc, phát trực tiếp iMessage và SMS.
• wacli - CLI WhatsApp: đồng bộ, tìm kiếm, gửi.
• discord - các thao tác Discord: bày tỏ cảm xúc, nhãn dán, cuộc thăm dò. Sử dụng đích user:<id> hoặc channel:<id> (ID chỉ gồm số sẽ gây mơ hồ).
• gog - CLI Google Suite: Gmail, Calendar, Drive, Contacts.
• spotify-player - ứng dụng Spotify trên terminal để tìm kiếm/xếp hàng/điều khiển phát lại.
• sag - giọng nói ElevenLabs với trải nghiệm lệnh nói kiểu macOS; mặc định phát trực tiếp đến loa.
• Sonos CLI - điều khiển loa Sonos (khám phá/trạng thái/phát lại/âm lượng/nhóm) từ các tập lệnh.
• blucli - phát, nhóm và tự động hóa các trình phát BluOS từ các tập lệnh.
• OpenHue CLI - điều khiển hệ thống chiếu sáng Philips Hue cho các cảnh và tác vụ tự động hóa.
• OpenAI Whisper - chuyển giọng nói thành văn bản cục bộ để đọc chính tả nhanh và tạo bản chép lời thư thoại.
• Gemini CLI - sử dụng các mô hình Google Gemini từ terminal để hỏi đáp nhanh.
• agent-tools - bộ công cụ tiện ích cho các tác vụ tự động hóa và tập lệnh hỗ trợ.

Ghi chú sử dụng

• Ưu tiên CLI openclaw cho việc viết tập lệnh; ứng dụng máy tính để bàn xử lý các quyền.
• Chạy cài đặt từ thẻ Skills; nút cài đặt sẽ bị ẩn khi tệp nhị phân bắt buộc đã có.
• Duy trì bật Heartbeat để trợ lý có thể lên lịch nhắc nhở, giám sát hộp thư đến và kích hoạt chụp hình từ camera.
• Giao diện Canvas chạy toàn màn hình với các lớp phủ gốc. Tránh đặt các nút điều khiển quan trọng ở các cạnh trên-trái/trên-phải/dưới; thay vào đó, hãy thêm khoảng đệm bố cục rõ ràng thay vì dựa vào phần đệm vùng an toàn.
• Để xác minh thông qua trình duyệt, hãy sử dụng CLI openclaw browser (plugin browser đi kèm) với hồ sơ Chrome/Brave/Edge/Chromium do OpenClaw quản lý.
• Quản lý: status, doctor [--deep], start [--headless], stop, tabs, tab [new|select|close], open <url>, focus <id>, close <id>.
• Kiểm tra: screenshot [--full-page|--ref|--labels], snapshot [--format ai|aria|--interactive|--efficient], console, errors, requests, pdf, responsebody.
• Thao tác: navigate, click <ref>, type <ref> <text>, press, hover, drag, select, upload, download, fill, dialog, wait, evaluate --fn <js>, highlight. Các thao tác cần một ref từ snapshot (không chấp nhận bộ chọn CSS cho các thao tác); sử dụng evaluate khi bạn cần chọn mục tiêu theo kiểu document.querySelector.
• Thêm --json để nhận đầu ra mà máy có thể đọc được cho bất kỳ lệnh kiểm tra nào.

Liên quan

• Không gian làm việc của agent
• Môi trường chạy của agent
• Định tuyến kênh