OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Chế độ đặc quyền cao

Khi một tác nhân chạy bên trong sandbox, các lệnh exec của tác nhân bị giới hạn trong môi trường sandbox. Chế độ nâng quyền cho phép tác nhân thoát ra và chạy lệnh bên ngoài sandbox, với các cổng phê duyệt có thể cấu hình.

Chỉ thị

Kiểm soát chế độ nâng quyền cho từng phiên bằng các lệnh gạch chéo:

Chỉ thị Tác dụng
/elevated on Chạy bên ngoài sandbox trên đường dẫn máy chủ đã cấu hình, vẫn giữ yêu cầu phê duyệt
/elevated ask Giống on (bí danh)
/elevated full Chạy bên ngoài sandbox trên đường dẫn máy chủ đã cấu hình và bỏ qua phê duyệt khi chính sách phê duyệt của chế độ/máy chủ đã cho phép đầy đủ
/elevated off Quay lại thực thi bị giới hạn trong sandbox

Cũng có thể dùng dưới dạng /elev on|off|ask|full.

Gửi /elevated không có đối số để xem cấp độ hiện tại.

Cách hoạt động

  • Kiểm tra tính khả dụng

    Chế độ nâng quyền phải được bật trong cấu hình và người gửi phải có trong danh sách cho phép:

    json5
    {  tools: {    elevated: {      enabled: true,      allowFrom: {        discord: ["user-id-123"],        whatsapp: ["+15555550123"],      },    },  },}

  • Đặt cấp độ

    Gửi một tin nhắn chỉ chứa chỉ thị để đặt giá trị mặc định cho phiên:

    Code
    /elevated full

    Hoặc dùng trực tiếp trong tin nhắn (chỉ áp dụng cho tin nhắn đó):

    Code
    /elevated on run the deployment script

  • Các lệnh chạy bên ngoài sandbox

    Khi chế độ nâng quyền đang hoạt động, các lệnh gọi exec sẽ thoát khỏi sandbox. Máy chủ thực thi có hiệu lực mặc định là gateway, hoặc là node khi đích exec đã cấu hình/đích exec của phiên là node. Trong chế độ full, phê duyệt exec được bỏ qua khi chính sách phê duyệt chế độ/máy chủ sau khi phân giải đã cho phép hoàn toàn (security full, ask off); nếu không, chính sách phê duyệt thông thường vẫn áp dụng. Trong chế độ on/ask, các quy tắc phê duyệt đã cấu hình luôn áp dụng.

    • Thứ tự phân giải

    1. Chỉ thị trực tiếp trong tin nhắn (chỉ áp dụng cho tin nhắn đó)
    2. Ghi đè của phiên (được đặt bằng cách gửi một tin nhắn chỉ chứa chỉ thị)
    3. Giá trị mặc định toàn cục (agents.defaults.elevatedDefault trong cấu hình)

    Tính khả dụng và danh sách cho phép

    • Cổng toàn cục: tools.elevated.enabled (phải là true)
    • Danh sách người gửi được phép: tools.elevated.allowFrom với danh sách riêng cho từng kênh
    • Cổng cho từng tác nhân: agents.list[].tools.elevated.enabled (chỉ có thể hạn chế thêm; cả cổng toàn cục và cổng cho từng tác nhân đều phải là true)
    • Danh sách cho phép theo tác nhân: agents.list[].tools.elevated.allowFrom (người gửi phải khớp cả danh sách toàn cục và danh sách theo tác nhân)
    • Danh sách cho phép dự phòng do kênh cung cấp: các Plugin kênh có thể tùy chọn cung cấp danh sách cho phép dự phòng thông qua hook bộ điều hợp SDK, được dùng khi tools.elevated.allowFrom.<provider> chưa được cấu hình. Hiện không có kênh đi kèm nào triển khai hook này, nên trên thực tế hiện nay mỗi nhà cung cấp đều cần một mục tools.elevated.allowFrom.<provider> rõ ràng.
    • Tất cả các cổng đều phải được thông qua; nếu không, chế độ nâng quyền được xem là không khả dụng

    Định dạng mục trong danh sách cho phép:

    Tiền tố Khớp với
    (không có) ID người gửi, E.164 hoặc trường From
    name: Tên hiển thị của người gửi
    username: Tên người dùng của người gửi
    tag: Thẻ của người gửi
    id:, from:, e164: Nhắm mục tiêu danh tính một cách rõ ràng

    Những gì chế độ nâng quyền không kiểm soát

    • Chính sách công cụ: nếu exec bị chính sách công cụ từ chối, chế độ nâng quyền không thể ghi đè.
    • Chính sách chọn máy chủ: chế độ nâng quyền không biến auto thành quyền ghi đè liên máy chủ tự do. Chế độ này sử dụng các quy tắc đích exec đã cấu hình/của phiên và chỉ chọn node khi đích vốn đã là node.
    • Tách biệt với /exec: chỉ thị /exec điều chỉnh các giá trị exec mặc định theo phiên (máy chủ, bảo mật, yêu cầu phê duyệt, Node) cho người gửi được ủy quyền và không yêu cầu chế độ nâng quyền.

    Liên quan

    Công cụ exec

    Thực thi lệnh shell từ tác nhân.
    Phê duyệt exec

    Hệ thống phê duyệt và danh sách cho phép dành cho exec.
    Cơ chế sandbox

    Cấu hình sandbox ở cấp Gateway.
    Sandbox so với chính sách công cụ so với chế độ nâng quyền

    Cách ba cổng phối hợp trong một lệnh gọi công cụ.
    Was this useful?
    On this page

    On this page