​

Không gian làm việc của Agent

​

Vị trí mặc định

• Mặc định: ~/.openclaw/workspace
• Nếu OPENCLAW_PROFILE được thiết lập và không phải là "default", mặc định sẽ trở thành ~/.openclaw/workspace-<profile>.
• Ghi đè trong ~/.openclaw/openclaw.json:

{
  agent: {
    workspace: "~/.openclaw/workspace",
  },
}

{ agent: { skipBootstrap: true } }

​

Thư mục không gian làm việc bổ sung

​

Bản đồ file không gian làm việc (ý nghĩa của từng file)

• AGENTS.md
  • Hướng dẫn hoạt động cho agent và cách sử dụng bộ nhớ.
  • Được tải khi bắt đầu mỗi phiên.
  • Nơi tốt để đặt quy tắc, ưu tiên và chi tiết “cách hành xử”.
• SOUL.md
  • Nhân cách, giọng điệu và giới hạn.
  • Được tải mỗi phiên.
• USER.md
  • Ai là người dùng và cách gọi họ.
  • Được tải mỗi phiên.
• IDENTITY.md
  • Tên, phong cách và biểu tượng cảm xúc của agent.
  • Được tạo/cập nhật trong quá trình khởi tạo.
• TOOLS.md
  • Ghi chú về các công cụ và quy ước địa phương.
  • Không kiểm soát sự sẵn có của công cụ; chỉ là hướng dẫn.
• HEARTBEAT.md
  • Danh sách kiểm tra nhỏ tùy chọn cho các lần chạy heartbeat.
  • Giữ ngắn gọn để tránh tiêu tốn token.
• BOOT.md
  • Danh sách kiểm tra khởi động tùy chọn thực thi khi khởi động lại gateway khi các hook nội bộ được kích hoạt.
  • Giữ ngắn gọn; sử dụng công cụ tin nhắn để gửi đi.
• BOOTSTRAP.md
  • Nghi thức chạy lần đầu tiên.
  • Chỉ được tạo cho một không gian làm việc hoàn toàn mới.
  • Xóa nó sau khi nghi thức hoàn tất.
• memory/YYYY-MM-DD.md
  • Nhật ký bộ nhớ hàng ngày (một file mỗi ngày).
  • Khuyến nghị đọc hôm nay + hôm qua khi bắt đầu phiên.
• MEMORY.md (tùy chọn)
  • Bộ nhớ dài hạn được chọn lọc.
  • Chỉ tải trong phiên chính, riêng tư (không phải ngữ cảnh chia sẻ/nhóm).

• skills/ (tùy chọn)
  • Kỹ năng cụ thể cho không gian làm việc.
  • Ghi đè kỹ năng được quản lý/gói khi tên trùng lặp.
• canvas/ (tùy chọn)
  • File giao diện Canvas cho hiển thị node (ví dụ canvas/index.html).

​

Những gì KHÔNG có trong không gian làm việc

• ~/.openclaw/openclaw.json (cấu hình)
• ~/.openclaw/credentials/ (OAuth tokens, API keys)
• ~/.openclaw/agents/<agentId>/sessions/ (bản ghi phiên + metadata)
• ~/.openclaw/skills/ (kỹ năng được quản lý)

​

Sao lưu Git (khuyến nghị, riêng tư)

​

1) Khởi tạo kho lưu trữ

cd ~/.openclaw/workspace
git init
git add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/
git commit -m "Thêm không gian làm việc của agent"

​

2) Thêm remote riêng tư (tùy chọn dễ sử dụng cho người mới bắt đầu)

1. Tạo một kho lưu trữ riêng tư mới trên GitHub.
2. Không khởi tạo với README (tránh xung đột merge).
3. Sao chép URL remote HTTPS.
4. Thêm remote và đẩy:

git branch -M main
git remote add origin <https-url>
git push -u origin main

gh auth login
gh repo create openclaw-workspace --private --source . --remote origin --push

1. Tạo một kho lưu trữ riêng tư mới trên GitLab.
2. Không khởi tạo với README (tránh xung đột merge).
3. Sao chép URL remote HTTPS.
4. Thêm remote và đẩy:

git branch -M main
git remote add origin <https-url>
git push -u origin main

​

3) Cập nhật liên tục

git status
git add .
git commit -m "Cập nhật bộ nhớ"
git push

​

Không cam kết thông tin bí mật

• API keys, OAuth tokens, mật khẩu, hoặc thông tin xác thực riêng tư.
• Bất kỳ thứ gì dưới ~/.openclaw/.
• Bản ghi thô của các cuộc trò chuyện hoặc tệp đính kèm nhạy cảm.

.DS_Store
.env
**/*.key
**/*.pem
**/secrets*

​

Di chuyển không gian làm việc sang máy mới

1. Clone kho lưu trữ đến đường dẫn mong muốn (mặc định ~/.openclaw/workspace).
2. Thiết lập agents.defaults.workspace đến đường dẫn đó trong ~/.openclaw/openclaw.json.
3. Chạy openclaw setup --workspace <path> để khởi tạo bất kỳ file nào bị thiếu.
4. Nếu cần phiên, sao chép ~/.openclaw/agents/<agentId>/sessions/ từ máy cũ riêng biệt.

​

Ghi chú nâng cao

• Định tuyến đa agent có thể sử dụng các không gian làm việc khác nhau cho từng agent. Xem Định tuyến kênh để biết cấu hình định tuyến.
• Nếu agents.defaults.sandbox được kích hoạt, các phiên không phải chính có thể sử dụng các không gian làm việc sandbox cho từng phiên dưới agents.defaults.sandbox.workspaceRoot.