openclaw agents

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

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

• Маршрутизация нескольких агентов
• Рабочая область агента
• Конфигурация Skills: настройка видимости Skills.

Примеры

openclaw agents listopenclaw agents list --bindingsopenclaw agents add work --workspace ~/.openclaw/workspace-workopenclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:*openclaw agents add ops --workspace ~/.openclaw/workspace-ops --bind telegram:ops --non-interactiveopenclaw agents bindingsopenclaw agents bind --agent work --bind telegram:opsopenclaw agents unbind --agent work --bind telegram:opsopenclaw agents set-identity --workspace ~/.openclaw/workspace --from-identityopenclaw agents set-identity --agent main --avatar avatars/openclaw.pngopenclaw agents delete work

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

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

Если вам также нужны разные видимые Skills для каждого агента, настройте agents.defaults.skills и agents.list[].skills в openclaw.json. См. Конфигурация Skills и Справочник по конфигурации.

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

openclaw agents bindingsopenclaw agents bindings --agent workopenclaw agents bindings --json

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

openclaw agents bind --agent work --bind telegram:ops --bind discord:guild-a

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

openclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:* --bind discord:*

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

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

Формат --bind

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

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

Примеры:

# match all accounts on the channelopenclaw agents bind --agent work --bind telegram:* # match a specific accountopenclaw agents bind --agent work --bind telegram:ops # initial channel-only bindingopenclaw agents bind --agent work --bind telegram # later upgrade to account-scoped bindingopenclaw agents bind --agent work --bind telegram:alerts

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

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

openclaw agents unbind --agent work --bind telegram:opsopenclaw 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:

openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity

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

openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png

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

{  agents: {    list: [      {        id: "main",        identity: {          name: "OpenClaw",          theme: "space lobster",          emoji: "🦞",          avatar: "avatars/openclaw.png",        },      },    ],  },}

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

• Справочник CLI
• Маршрутизация нескольких агентов
• Рабочая область агента