​

openclaw agents

• Routing wielu agentów
• Obszar roboczy agenta
• Konfiguracja Skills: konfiguracja widoczności Skills.

​

Przykłady

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

​

Powiązania routingu

openclaw agents bindings
openclaw agents bindings --agent work
openclaw 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:*

​

Format --bind

​

Zachowanie zakresu powiązania

• Zapisane powiązanie bez accountId dopasowuje tylko konto domyślne kanału.
• accountId: "*" to zapasowe ustawienie dla całego kanału (wszystkie konta) i jest mniej szczegółowe niż jawne powiązanie konta.
• Jeśli ten sam agent ma już pasujące powiązanie kanału bez accountId, a później utworzysz powiązanie z jawnym lub ustalonym accountId, OpenClaw uaktualni istniejące powiązanie w miejscu zamiast dodawać duplikat.

# 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

openclaw agents unbind --agent work --bind telegram:ops
openclaw agents unbind --agent work --all

​

Zakres poleceń

​

agents

​

agents list

• --json
• --bindings: uwzględnia pełne reguły routingu, a nie tylko liczniki/podsumowania dla poszczególnych agentów

​

agents add [name]

• --workspace <dir>
• --model <id>
• --agent-dir <dir>
• --bind <channel[:accountId]> (powtarzalne)
• --non-interactive
• --json

• Przekazanie dowolnych jawnych flag dodawania przełącza polecenie na ścieżkę nieinteraktywną.
• Tryb nieinteraktywny wymaga zarówno nazwy agenta, jak i --workspace.
• main jest zarezerwowane i nie może zostać użyte jako identyfikator nowego agenta.
• W trybie interaktywnym inicjowanie uwierzytelniania kopiuje tylko przenośne profile statyczne (domyślnie api_key i statyczny token). Profile OAuth z tokenem odświeżania pozostają dostępne tylko przez dziedziczenie z odczytem z rzeczywistego magazynu agenta main. Jeśli skonfigurowany agent domyślny nie jest main, zaloguj się osobno dla profili OAuth na nowym agencie.

​

agents bindings

• --agent <id>
• --json

​

agents bind

• --agent <id> (domyślnie bieżący agent domyślny)
• --bind <channel[:accountId]> (powtarzalne)
• --json

​

agents unbind

• --agent <id> (domyślnie bieżący agent domyślny)
• --bind <channel[:accountId]> (powtarzalne)
• --all
• --json

​

agents delete <id>

• --force
• --json

• main nie może zostać usunięte.
• Bez --force wymagane jest interaktywne potwierdzenie.
• Katalogi obszaru roboczego, stanu agenta i transkryptów sesji są przenoszone do Kosza, a nie trwale usuwane.
• Gdy Gateway jest osiągalny, usunięcie jest wysyłane przez Gateway, dzięki czemu czyszczenie konfiguracji i magazynu sesji używa tego samego zapisującego co ruch w czasie działania. Jeśli Gateway jest nieosiągalny, CLI wraca do lokalnej ścieżki offline.
• Jeśli obszar roboczy innego agenta ma tę samą ścieżkę, znajduje się wewnątrz tego obszaru roboczego albo zawiera ten obszar roboczy, obszar roboczy zostaje zachowany, a --json zgłasza workspaceRetained, workspaceRetainedReason i workspaceSharedWith.

​

Pliki tożsamości

• Przykładowa ścieżka: ~/.openclaw/workspace/IDENTITY.md
• set-identity --from-identity odczytuje z katalogu głównego obszaru roboczego (albo z jawnego --identity-file)

​

Ustawianie tożsamości

• name
• theme
• emoji
• avatar (ścieżka względna względem obszaru roboczego, adres URL http(s) albo data URI)

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

• Do wybrania agenta docelowego można użyć --agent albo --workspace.
• Jeśli polegasz na --workspace, a wiele agentów współdzieli ten obszar roboczy, polecenie kończy się niepowodzeniem i prosi o przekazanie --agent.
• Lokalne pliki obrazów awatarów ze ścieżkami względnymi względem obszaru roboczego są ograniczone do 2 MB. Adresy URL HTTP(S) i URI data: nie są sprawdzane pod kątem lokalnego limitu rozmiaru pliku.
• Gdy nie podano jawnych pól tożsamości, polecenie odczytuje dane tożsamości z 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",
        },
      },
    ],
  },
}

​

Powiązane

• Referencja CLI
• Routing wielu agentów
• Obszar roboczy agenta