> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tác tử

# `openclaw agents`

Quản lý các agent biệt lập (không gian làm việc + xác thực + định tuyến). Chạy `openclaw agents` mà không có lệnh con tương đương với `openclaw agents list`.

Liên quan:

* [Định tuyến đa agent](/vi/concepts/multi-agent)
* [Không gian làm việc của agent](/vi/concepts/agent-workspace)
* [Cấu hình Skills](/vi/tools/skills-config): cấu hình khả năng hiển thị của skill.

## Ví dụ

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw agents list
openclaw agents list --bindings
openclaw agents add work --workspace ~/.openclaw/workspace-work
openclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:*
openclaw agents add ops --workspace ~/.openclaw/workspace-ops --bind telegram:ops --non-interactive
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
```

## Bề mặt lệnh

### `agents list`

Tùy chọn: `--json`, `--bindings` (bao gồm đầy đủ các quy tắc định tuyến, không chỉ số lượng/tóm tắt theo từng agent).

### `agents add [name]`

Tùy chọn: `--workspace <dir>`, `--model <id>`, `--agent-dir <dir>`, `--bind <channel[:accountId]>` (có thể lặp lại), `--non-interactive`, `--json`.

* Việc truyền bất kỳ cờ thêm rõ ràng nào sẽ chuyển lệnh sang luồng không tương tác.
* Chế độ không tương tác yêu cầu cả tên agent và `--workspace`.
* `main` được dành riêng và không thể dùng làm mã định danh agent mới.
* Chế độ tương tác khởi tạo xác thực bằng cách chỉ sao chép thông tin xác thực tĩnh có tính di động (các hồ sơ `api_key` và `token` tĩnh), trừ khi thông tin xác thực từ chối bằng `copyToAgents: false`; các hồ sơ mã thông báo làm mới OAuth không được sao chép trừ khi nhà cung cấp chủ động cho phép bằng `copyToAgents: true`. Khi không có bản sao, OAuth chỉ tiếp tục khả dụng thông qua cơ chế kế thừa đọc xuyên từ kho agent `main` thực. Nếu agent mặc định đã cấu hình không phải là `main`, hãy đăng nhập riêng cho các hồ sơ OAuth trên agent mới.

### `agents bindings`

Tùy chọn: `--agent <id>`, `--json`.

### `agents bind`

Tùy chọn: `--agent <id>` (mặc định là agent mặc định hiện tại), `--bind <channel[:accountId]>` (có thể lặp lại), `--json`.

### `agents unbind`

Tùy chọn: `--agent <id>` (mặc định là agent mặc định hiện tại), `--bind <channel[:accountId]>` (có thể lặp lại), `--all`, `--json`. Chấp nhận `--all` hoặc một hay nhiều giá trị `--bind`, nhưng không chấp nhận đồng thời cả hai.

### `agents set-identity`

Tùy chọn: `--agent <id>`, `--workspace <dir>`, `--identity-file <path>`, `--from-identity`, `--name <name>`, `--theme <theme>`, `--emoji <emoji>`, `--avatar <value>`, `--json`. Xem [Đặt danh tính](#set-identity) bên dưới.

### `agents delete <id>`

Tùy chọn: `--force`, `--json`.

* `main` không thể bị xóa.
* Nếu không có `--force`, cần xác nhận tương tác (sẽ thất bại trong phiên không phải TTY; hãy chạy lại với `--force`).
* Các thư mục không gian làm việc, trạng thái agent và bản chép lời phiên được chuyển vào Thùng rác thay vì bị xóa vĩnh viễn. Nếu Thùng rác không khả dụng, việc xóa cấu hình agent vẫn thành công và báo cáo các đường dẫn cần dọn dẹp thủ công.
* Khi có thể kết nối với Gateway, thao tác xóa được định tuyến qua Gateway để quá trình dọn dẹp cấu hình và kho phiên dùng chung trình ghi với lưu lượng thời gian chạy. Nếu không thể kết nối với Gateway, CLI chuyển về đường dẫn cục bộ ngoại tuyến.
* Nếu không gian làm việc của agent khác có cùng đường dẫn, nằm bên trong không gian làm việc này hoặc chứa không gian làm việc này, không gian làm việc sẽ được giữ lại và `--json` báo cáo `workspaceRetained`, `workspaceRetainedReason` và `workspaceSharedWith`.

## Liên kết định tuyến

Sử dụng liên kết định tuyến để ghim lưu lượng kênh đến vào một agent cụ thể.

Nếu cũng muốn mỗi agent hiển thị các skill khác nhau, hãy cấu hình `agents.defaults.skills` và `agents.list[].skills` trong `openclaw.json`. Xem [Cấu hình Skills](/vi/tools/skills-config) và [Tham chiếu cấu hình](/vi/gateway/config-agents#agentsdefaultsskills).

Liệt kê các liên kết:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw agents bindings
openclaw agents bindings --agent work
openclaw agents bindings --json
```

Thêm liên kết:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw agents bind --agent work --bind telegram:ops --bind discord:guild-a
```

Bạn cũng có thể thêm liên kết khi tạo agent:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:* --bind discord:*
```

Nếu bỏ qua `accountId` (`--bind <channel>`), OpenClaw sẽ phân giải giá trị này từ các hook thiết lập plugin, liên kết tài khoản bắt buộc hoặc số lượng tài khoản đã cấu hình của kênh.

Nếu bỏ qua `--agent` đối với `bind` hoặc `unbind`, OpenClaw nhắm đến agent mặc định hiện tại.

### Định dạng `--bind`

| Định dạng                    | Ý nghĩa                                                                                                        |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------- |
| `--bind <channel>:*`         | Khớp với tất cả tài khoản trên kênh.                                                                           |
| `--bind <channel>:<account>` | Khớp với một tài khoản.                                                                                        |
| `--bind <channel>`           | Chỉ khớp với tài khoản mặc định, trừ khi CLI có thể phân giải an toàn phạm vi tài khoản dành riêng cho plugin. |

### Hành vi phạm vi liên kết

* Một liên kết được lưu mà 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 kênh (tất cả tài khoản) và ít cụ thể hơn một liên kết tài khoản rõ ràng.
* Nếu cùng một agent đã có liên kết kênh phù hợp mà không có `accountId`, rồi sau đó bạn liên kết với `accountId` rõ ràng hoặc đã phân giải, OpenClaw sẽ nâng cấp liên kết hiện có đó tại chỗ thay vì thêm một bản trùng lặp.

Ví dụ:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# khớp với tất cả tài khoản trên kênh
openclaw agents bind --agent work --bind telegram:*

# khớp với một tài khoản cụ thể
openclaw agents bind --agent work --bind telegram:ops

# liên kết ban đầu chỉ dành cho kênh
openclaw agents bind --agent work --bind telegram

# sau đó nâng cấp thành liên kết theo phạm vi tài khoản
openclaw agents bind --agent work --bind telegram:alerts
```

Sau khi nâng cấp, việc định tuyến cho liên kết đó được giới hạn trong `telegram:alerts`. Nếu cũng muốn định tuyến tài khoản mặc định, hãy thêm rõ ràng (ví dụ: `--bind telegram:default`).

Xóa liên kết:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw agents unbind --agent work --bind telegram:ops
openclaw agents unbind --agent work --all
```

## Tệp danh tính

Mỗi không gian làm việc của agent có thể chứa một `IDENTITY.md` tại thư mục gốc của không gian làm việc:

* Đường dẫn ví dụ: `~/.openclaw/workspace/IDENTITY.md`
* `set-identity --from-identity` đọc từ thư mục gốc của không gian làm việc (hoặc một `--identity-file` rõ ràng).

Các đường dẫn ảnh đại diện được phân giải tương đối với thư mục gốc của không gian làm việc và không thể thoát ra ngoài, kể cả thông qua liên kết tượng trưng.

## Đặ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 với không gian làm việc, URL http(s) hoặc URI dữ liệu).

* `--agent` hoặc `--workspace` chọn agent đích. Nếu `--workspace` khớp với nhiều hơn một agent, lệnh sẽ thất bại và yêu cầu bạn truyền `--agent`.
* Các tệp ảnh đại diện cục bộ có đường dẫn tương đối với không gian làm việc bị giới hạn ở 2 MB. URL HTTP(S) và URI `data:` không được kiểm tra theo giới hạn kích thước tệp cục bộ.
* Khi không cung cấp trường danh tính rõ ràng nào, lệnh sẽ đọc dữ liệu danh tính từ `IDENTITY.md`.

Tải từ `IDENTITY.md`:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
```

Ghi đè rõ ràng các trường:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png
```

Mẫu cấu hình:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    list: [
      {
        id: "main",
        identity: {
          name: "OpenClaw",
          theme: "space lobster",
          emoji: "🦞",
          avatar: "avatars/openclaw.png",
        },
      },
    ],
  },
}
```

## Liên quan

* [Tham chiếu CLI](/vi/cli)
* [Định tuyến đa agent](/vi/concepts/multi-agent)
* [Không gian làm việc của agent](/vi/concepts/agent-workspace)