Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://openclawhub.vn/llms.txt

Use this file to discover all available pages before exploring further.

​
openclaw agents

Quản lý các agent độc lập (workspaces + xác thực + định tuyến). Liên quan:

​
Ví dụ

openclaw agents list
openclaw agents add work --workspace ~/.openclaw/workspace-work
openclaw agents bindings
openclaw agents bind --agent work --bind telegram:ops
openclaw agents unbind --agent work --bind telegram:ops
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
openclaw agents set-identity --agent main --avatar avatars/openclaw.png
openclaw agents delete work

​
Ràng buộc định tuyến

Sử dụng ràng buộc định tuyến để gán lưu lượng kênh đầu vào cho một agent cụ thể. Liệt kê ràng buộc: 
openclaw agents bindings
openclaw agents bindings --agent work
openclaw agents bindings --json
Thêm ràng buộc: 
openclaw agents bind --agent work --bind telegram:ops --bind discord:guild-a
Nếu bạn bỏ qua accountId (--bind <channel>), OpenClaw sẽ tự động xác định từ các thiết lập mặc định của kênh và plugin khi có sẵn.

​
Hành vi phạm vi ràng buộc

  • Một ràng buộc không có accountId chỉ khớp với tài khoản mặc định của kênh.
  • accountId: "*" là phương án dự phòng cho toàn bộ kênh (tất cả tài khoản) và ít cụ thể hơn so với ràng buộc tài khoản rõ ràng.
  • Nếu cùng một agent đã có ràng buộc kênh khớp mà không có accountId, và sau đó bạn ràng buộc với accountId rõ ràng hoặc đã xác định, OpenClaw sẽ nâng cấp ràng buộc hiện có thay vì thêm bản sao.
Ví dụ: 
# ràng buộc chỉ kênh ban đầu
openclaw agents bind --agent work --bind telegram

# sau đó nâng cấp lên ràng buộc theo tài khoản
openclaw agents bind --agent work --bind telegram:ops
Sau khi nâng cấp, định tuyến cho ràng buộc đó sẽ được giới hạn cho telegram:ops. Nếu bạn cũng muốn định tuyến tài khoản mặc định, hãy thêm nó rõ ràng (ví dụ --bind telegram:default). Xóa ràng buộc: 
openclaw agents unbind --agent work --bind telegram:ops
openclaw agents unbind --agent work --all

​
Tệp danh tính

Mỗi workspace của agent có thể bao gồm một IDENTITY.md tại thư mục gốc của workspace:
  • Đường dẫn ví dụ: ~/.openclaw/workspace/IDENTITY.md
  • set-identity --from-identity đọc từ thư mục gốc của workspace (hoặc một --identity-file cụ thể)
Đường dẫn avatar được xác định tương đối so với thư mục gốc của workspace.

​
Đặt danh tính

set-identity ghi các trường vào agents.list[].identity:
  • name
  • theme
  • emoji
  • avatar (đường dẫn tương đối workspace, URL http(s), hoặc data URI)
Tải từ IDENTITY.md: 
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
Ghi đè các trường rõ ràng: 
openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png
Mẫu cấu hình: 
{
  agents: {
    list: [
      {
        id: "main",
        identity: {
          name: "OpenClaw",
          theme: "space lobster",
          emoji: "🦞",
          avatar: "avatars/openclaw.png",
        },
      },
    ],
  },
}
Last modified on March 22, 2026