openclaw agents

Zarządzaj odizolowanymi agentami (obszarami roboczymi, uwierzytelnianiem i trasowaniem). Uruchomienie openclaw agents bez podkomendy jest równoważne poleceniu openclaw agents list.

Powiązane:

• Trasowanie wieloagentowe
• Obszar roboczy agenta
• Konfiguracja Skills: konfiguracja widoczności Skills.

Przykłady

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

Zakres poleceń

agents list

Opcje: --json, --bindings (uwzględnia pełne reguły trasowania, a nie tylko liczniki lub podsumowania dla poszczególnych agentów).

agents add [name]

Opcje: --workspace <dir>, --model <id>, --agent-dir <dir>, --bind <channel[:accountId]> (można podać wielokrotnie), --non-interactive, --json.

• Podanie dowolnej jawnej flagi dodawania przełącza polecenie na tryb nieinteraktywny.
• Tryb nieinteraktywny wymaga zarówno nazwy agenta, jak i opcji --workspace.
• Identyfikator main jest zarezerwowany i nie może zostać użyty jako identyfikator nowego agenta.
• Tryb interaktywny inicjuje uwierzytelnianie, kopiując wyłącznie przenośne, statyczne poświadczenia (profile api_key i statycznego token), chyba że poświadczenie wyłącza kopiowanie za pomocą copyToAgents: false. Profile tokenów odświeżania OAuth nie są kopiowane, chyba że dostawca włączy kopiowanie za pomocą copyToAgents: true. Bez kopii OAuth pozostaje dostępne wyłącznie przez dziedziczenie z odczytem z rzeczywistego magazynu agenta main. Jeśli skonfigurowanym agentem domyślnym nie jest main, zaloguj się osobno do profili OAuth na nowym agencie.

agents bindings

Opcje: --agent <id>, --json.

agents bind

Opcje: --agent <id> (domyślnie bieżący agent domyślny), --bind <channel[:accountId]> (można podać wielokrotnie), --json.

agents unbind

Opcje: --agent <id> (domyślnie bieżący agent domyślny), --bind <channel[:accountId]> (można podać wielokrotnie), --all, --json. Przyjmuje albo --all, albo co najmniej jedną wartość --bind, ale nie oba warianty jednocześnie.

agents set-identity

Opcje: --agent <id>, --workspace <dir>, --identity-file <path>, --from-identity, --name <name>, --theme <theme>, --emoji <emoji>, --avatar <value>, --json. Zobacz sekcję Ustawianie tożsamości poniżej.

agents delete <id>

Opcje: --force, --json.

• Agenta main nie można usunąć.
• Bez opcji --force wymagane jest interaktywne potwierdzenie (polecenie zakończy się niepowodzeniem w sesji bez TTY; uruchom je ponownie z opcją --force).
• Obszar roboczy, stan agenta oraz katalogi transkrypcji sesji są przenoszone do Kosza, a nie trwale usuwane.
• Gdy Gateway jest osiągalny, usuwanie odbywa się za jego pośrednictwem, dzięki czemu czyszczenie konfiguracji i magazynu sesji korzysta z tego samego mechanizmu zapisu co ruch środowiska uruchomieniowego. Jeśli Gateway jest nieosiągalny, CLI przechodzi na lokalną ścieżkę offline.
• Jeśli obszar roboczy innego agenta wskazuje tę samą ścieżkę, znajduje się wewnątrz tego obszaru roboczego lub go zawiera, obszar roboczy zostaje zachowany, a --json zwraca pola workspaceRetained, workspaceRetainedReason i workspaceSharedWith.

Powiązania trasowania

Użyj powiązań trasowania, aby przypisać ruch przychodzący z kanału do konkretnego agenta.

Jeśli chcesz również ustawić różne widoczne Skills dla poszczególnych agentów, skonfiguruj agents.defaults.skills i agents.list[].skills w pliku openclaw.json. Zobacz Konfiguracja Skills i Dokumentacja konfiguracji.

Wyświetlanie powiązań:

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

Dodawanie powiązań:

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

Powiązania można również dodać podczas tworzenia agenta:

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

Jeśli pominiesz accountId (--bind <channel>), OpenClaw ustali je na podstawie haków konfiguracji Pluginu, wymuszonego powiązania konta lub liczby kont skonfigurowanych dla kanału.

Jeśli pominiesz --agent dla polecenia bind lub unbind, OpenClaw wybierze bieżącego agenta domyślnego.

Format --bind

Zachowanie zakresu powiązań

• Zapisane powiązanie bez accountId dopasowuje tylko domyślne konto kanału.
• accountId: "*" jest rezerwowym dopasowaniem dla całego kanału (wszystkich kont) 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 następnie dodasz powiązanie z jawnym lub ustalonym accountId, OpenClaw zaktualizuje istniejące powiązanie w miejscu, zamiast dodawać duplikat.

Przykłady:

# dopasuj wszystkie konta w kanaleopenclaw agents bind --agent work --bind telegram:* # dopasuj określone kontoopenclaw agents bind --agent work --bind telegram:ops # początkowe powiązanie obejmujące tylko kanałopenclaw agents bind --agent work --bind telegram # późniejsze rozszerzenie do powiązania o zakresie kontaopenclaw agents bind --agent work --bind telegram:alerts

Po aktualizacji trasowanie dla tego powiązania jest ograniczone do telegram:alerts. Jeśli chcesz również trasować ruch dla konta domyślnego, dodaj je jawnie (na przykład --bind telegram:default).

Usuwanie powiązań:

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

Pliki tożsamości

Każdy obszar roboczy agenta może zawierać plik IDENTITY.md w swoim katalogu głównym:

• Przykładowa ścieżka: ~/.openclaw/workspace/IDENTITY.md
• set-identity --from-identity odczytuje dane z katalogu głównego obszaru roboczego (lub z pliku podanego jawnie za pomocą --identity-file).

Ścieżki awatarów są rozwiązywane względem katalogu głównego obszaru roboczego i nie mogą wskazywać poza niego, nawet za pośrednictwem dowiązania symbolicznego.

Ustawianie tożsamości

Polecenie set-identity zapisuje pola w agents.list[].identity: name, theme, emoji, avatar (ścieżka względna wobec obszaru roboczego, adres URL HTTP(S) lub identyfikator URI danych).

• --agent lub --workspace wybiera agenta docelowego. Jeśli --workspace pasuje do więcej niż jednego agenta, polecenie kończy się niepowodzeniem i prosi o podanie --agent.
• Lokalne pliki obrazów awatarów ze ścieżkami względnymi wobec obszaru roboczego mogą mieć maksymalnie 2 MB. Adresy URL HTTP(S) i identyfikatory URI data: nie podlegają lokalnemu limitowi rozmiaru pliku.
• Jeśli nie podano jawnie żadnych pól tożsamości, polecenie odczytuje dane tożsamości z pliku IDENTITY.md.

Wczytywanie z pliku IDENTITY.md:

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

Jawne zastępowanie pól:

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

Przykładowa konfiguracja:

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

Powiązane

• Dokumentacja CLI
• Trasowanie wieloagentowe
• Obszar roboczy agenta