> ## 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.

# Агенты

# `openclaw agents`

Управление изолированными агентами (рабочие области + аутентификация + маршрутизация).

Связанные разделы:

* [Маршрутизация нескольких агентов](/ru/concepts/multi-agent)
* [Рабочая область агента](/ru/concepts/agent-workspace)
* [Конфигурация Skills](/ru/tools/skills-config): настройка видимости Skills.

## Примеры

```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
```

## Привязки маршрутизации

Используйте привязки маршрутизации, чтобы закрепить входящий трафик канала за конкретным агентом.

Если вам также нужны разные видимые Skills для каждого агента, настройте `agents.defaults.skills` и `agents.list[].skills` в `openclaw.json`. См. [Конфигурация Skills](/ru/tools/skills-config) и [Справочник по конфигурации](/ru/gateway/config-agents#agents-defaults-skills).

Список привязок:

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

Добавить привязки:

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

Привязки также можно добавить при создании агента:

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

Если вы опускаете `accountId` (`--bind <channel>`), OpenClaw определяет его через хуки настройки Plugin, принудительную привязку аккаунта или настроенное количество аккаунтов канала.

Если вы опускаете `--agent` для `bind` или `unbind`, OpenClaw выбирает текущего агента по умолчанию.

### Формат `--bind`

| Формат                       | Значение                                                                                                                   |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `--bind <channel>:*`         | Сопоставлять все аккаунты в канале.                                                                                        |
| `--bind <channel>:<account>` | Сопоставлять один аккаунт.                                                                                                 |
| `--bind <channel>`           | Сопоставлять только аккаунт по умолчанию, если CLI не может безопасно определить область аккаунта, специфичную для Plugin. |

### Поведение области привязки

* Сохраненная привязка без `accountId` сопоставляет только аккаунт канала по умолчанию.
* `accountId: "*"` — резервная привязка на весь канал (все аккаунты), менее специфичная, чем явная привязка аккаунта.
* Если у того же агента уже есть совпадающая привязка канала без `accountId`, а затем вы выполняете привязку с явным или определенным `accountId`, OpenClaw обновляет существующую привязку на месте вместо добавления дубликата.

Примеры:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# match all accounts on the channel
openclaw agents bind --agent work --bind telegram:*

# match a specific account
openclaw agents bind --agent work --bind telegram:ops

# initial channel-only binding
openclaw agents bind --agent work --bind telegram

# later upgrade to account-scoped binding
openclaw agents bind --agent work --bind telegram:alerts
```

После обновления маршрутизация для этой привязки ограничена `telegram:alerts`. Если вам также нужна маршрутизация для аккаунта по умолчанию, добавьте ее явно (например, `--bind telegram:default`).

Удалить привязки:

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

`unbind` принимает либо `--all`, либо одно или несколько значений `--bind`, но не оба варианта одновременно.

## Поверхность команд

### `agents`

Запуск `openclaw agents` без подкоманды эквивалентен `openclaw agents list`.

### `agents list`

Параметры:

* `--json`
* `--bindings`: включить полные правила маршрутизации, а не только счетчики/сводки по агентам

### `agents add [name]`

Параметры:

* `--workspace <dir>`
* `--model <id>`
* `--agent-dir <dir>`
* `--bind <channel[:accountId]>` (можно повторять)
* `--non-interactive`
* `--json`

Примечания:

* Передача любых явных флагов добавления переводит команду в неинтерактивный режим.
* Для неинтерактивного режима требуются и имя агента, и `--workspace`.
* `main` зарезервирован и не может использоваться как id нового агента.
* В интерактивном режиме заполнение данных аутентификации копирует только переносимые статические профили
  (`api_key` и статический `token` по умолчанию). Профили с refresh-token OAuth остаются
  доступными только через сквозное наследование чтения из настоящего хранилища агента `main`.
  Если настроенный агент по умолчанию не `main`, войдите отдельно для профилей OAuth
  на новом агенте.

### `agents bindings`

Параметры:

* `--agent <id>`
* `--json`

### `agents bind`

Параметры:

* `--agent <id>` (по умолчанию текущий агент по умолчанию)
* `--bind <channel[:accountId]>` (можно повторять)
* `--json`

### `agents unbind`

Параметры:

* `--agent <id>` (по умолчанию текущий агент по умолчанию)
* `--bind <channel[:accountId]>` (можно повторять)
* `--all`
* `--json`

### `agents delete <id>`

Параметры:

* `--force`
* `--json`

Примечания:

* `main` нельзя удалить.
* Без `--force` требуется интерактивное подтверждение.
* Рабочая область, состояние агента и каталоги транскриптов сессий перемещаются в корзину, а не удаляются безвозвратно.
* Когда Gateway доступен, удаление отправляется через Gateway, чтобы очистка конфигурации и хранилища сессий использовала тот же механизм записи, что и runtime-трафик. Если Gateway недоступен, CLI возвращается к автономному локальному пути.
* Если рабочая область другого агента находится по тому же пути, внутри этой рабочей области или содержит эту рабочую область,
  рабочая область сохраняется, а `--json` сообщает `workspaceRetained`,
  `workspaceRetainedReason` и `workspaceSharedWith`.

## Файлы идентификации

Каждая рабочая область агента может содержать `IDENTITY.md` в корне рабочей области:

* Пример пути: `~/.openclaw/workspace/IDENTITY.md`
* `set-identity --from-identity` читает данные из корня рабочей области (или из явно указанного `--identity-file`)

Пути к аватарам разрешаются относительно корня рабочей области.

## Настройка идентификации

`set-identity` записывает поля в `agents.list[].identity`:

* `name`
* `theme`
* `emoji`
* `avatar` (путь относительно рабочей области, URL http(s) или data URI)

Параметры:

* `--agent <id>`
* `--workspace <dir>`
* `--identity-file <path>`
* `--from-identity`
* `--name <name>`
* `--theme <theme>`
* `--emoji <emoji>`
* `--avatar <value>`
* `--json`

Примечания:

* `--agent` или `--workspace` можно использовать для выбора целевого агента.
* Если вы полагаетесь на `--workspace` и несколько агентов используют эту рабочую область совместно, команда завершается ошибкой и просит передать `--agent`.
* Локальные файлы изображений аватара с путем относительно рабочей области ограничены 2 МБ. HTTP(S) URL и URI `data:` не проверяются по локальному ограничению размера файла.
* Если явные поля идентификации не указаны, команда читает данные идентификации из `IDENTITY.md`.

Загрузить из `IDENTITY.md`:

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

Явно переопределить поля:

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

Пример конфигурации:

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

## Связанные разделы

* [Справочник CLI](/ru/cli)
* [Маршрутизация нескольких агентов](/ru/concepts/multi-agent)
* [Рабочая область агента](/ru/concepts/agent-workspace)