Skip to main content
Khởi tạo là quy trình lần chạy đầu tiên nhằm tạo dữ liệu ban đầu cho không gian làm việc của agent mới và hướng dẫn agent chọn danh tính. Quy trình này chạy một lần, ngay sau khi onboarding, trong lượt tương tác thực sự đầu tiên của agent.

​
Điều gì diễn ra

Trong lần chạy đầu tiên với một không gian làm việc hoàn toàn mới (mặc định ~/.openclaw/workspace), OpenClaw:
  • Tạo dữ liệu ban đầu cho AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md và BOOTSTRAP.md.
  • Yêu cầu agent thực hiện trình tự khai sinh giới hạn trong ba nhịp: hỏi bạn muốn gọi agent là gì, chia sẻ một câu ngắn về bản chất/phong cách và hỏi bạn muốn bộ plugin tối thiểu được đề xuất hay mức tiện lợi tối đa.
  • Lưu danh tính đã thống nhất hai lần: vào IDENTITY.md và SOUL.md (nội dung agent đọc về chính mình), đồng thời thông qua openclaw agents set-identity (nội dung các kênh và giao diện người dùng hiển thị).
  • Đọc các đề xuất ứng dụng đã được lưu trong quá trình onboarding mà không quét lại. Các plugin chính thức sử dụng openclaw plugins install <id>; Skills ClawHub của bên thứ ba vẫn yêu cầu người dùng chủ động chọn tham gia. Sau khi xử lý lựa chọn, agent xác nhận đề xuất đã lưu để không bao giờ hỏi lại.
  • Xóa BOOTSTRAP.md sau khi không gian làm việc có vẻ đã được cấu hình, để quy trình này chỉ chạy một lần.
Một không gian làm việc được xem là đã cấu hình khi SOUL.md, IDENTITY.md hoặc USER.md đã khác với mẫu khởi đầu tương ứng, hoặc khi thư mục memory/ tồn tại.
BOOTSTRAP.md bao quát toàn bộ cuộc trò chuyện về danh tính. Xem nội dung tại mẫu BOOTSTRAP.md.

​
Các lượt chạy bằng mô hình nhúng và mô hình cục bộ

Đối với các lượt chạy bằng mô hình nhúng hoặc mô hình cục bộ, OpenClaw không đưa BOOTSTRAP.md vào ngữ cảnh hệ thống đặc quyền. Trong lượt chạy tương tác chính đầu tiên, OpenClaw vẫn truyền nội dung tệp qua lời nhắc người dùng, nhờ đó các mô hình không gọi công cụ read một cách đáng tin cậy vẫn có thể hoàn tất quy trình. Nếu lượt chạy hiện tại không thể truy cập không gian làm việc một cách an toàn, agent sẽ nhận được một ghi chú khởi tạo giới hạn ngắn thay vì lời chào chung chung.

​
Bỏ qua khởi tạo

Để bỏ qua bước này trên một không gian làm việc đã được tạo dữ liệu sẵn, hãy chạy:

​
Nơi quy trình chạy

Quá trình khởi tạo luôn chạy trên máy chủ Gateway. Nếu ứng dụng macOS kết nối với một Gateway từ xa, không gian làm việc và các tệp khởi tạo của nó nằm trên máy từ xa đó, không nằm trên máy Mac.
Khi Gateway chạy trên một máy khác, hãy chỉnh sửa các tệp không gian làm việc trên máy chủ gateway (ví dụ: user@gateway-host:~/.openclaw/workspace).

​
Tài liệu liên quan