OmeniaClaw agents

Zarządzaj izolowanymi agentami (obszary robocze + uwierzytelnianie + routing).

Powiązane:

• Routing wieloagentowy
• Obszar roboczy agenta
• Konfiguracja Skills: konfiguracja widoczności skills.

Przykłady

OmeniaClaw agents listOmeniaClaw agents list --bindingsOmeniaClaw agents add work --workspace ~/.OmeniaClaw/workspace-workOmeniaClaw agents add ops --workspace ~/.OmeniaClaw/workspace-ops --bind telegram:ops --non-interactiveOmeniaClaw agents bindingsOmeniaClaw agents bind --agent work --bind telegram:opsOmeniaClaw agents unbind --agent work --bind telegram:opsOmeniaClaw agents set-identity --workspace ~/.OmeniaClaw/workspace --from-identityOmeniaClaw agents set-identity --agent main --avatar avatars/OmeniaClaw.pngOmeniaClaw agents delete work

Powiązania routingu

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

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

Wyświetlanie powiązań:

OmeniaClaw agents bindingsOmeniaClaw agents bindings --agent workOmeniaClaw agents bindings --json

Dodawanie powiązań:

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

Jeśli pominiesz accountId (--bind <channel>), OmeniaClaw rozwiąże je z domyślnych ustawień kanału i haków konfiguracji Plugin, gdy są dostępne.

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

Zachowanie zakresu powiązań

• Powiązanie bez accountId pasuje tylko do domyślnego konta kanału.
• accountId: "*" to kanałowa wartość rezerwowa (wszystkie konta) i jest mniej szczegółowa niż jawne powiązanie konta.
• Jeśli ten sam agent ma już pasujące powiązanie kanału bez accountId, a później dodasz powiązanie z jawnym lub rozwiązanym accountId, OmeniaClaw zaktualizuje istniejące powiązanie w miejscu zamiast dodawać duplikat.

Przykład:

# initial channel-only bindingOmeniaClaw agents bind --agent work --bind telegram # later upgrade to account-scoped bindingOmeniaClaw agents bind --agent work --bind telegram:ops

Po aktualizacji routing dla tego powiązania jest ograniczony do telegram:ops. Jeśli chcesz także routing dla konta domyślnego, dodaj go jawnie (na przykład --bind telegram:default).

Usuwanie powiązań:

OmeniaClaw agents unbind --agent work --bind telegram:opsOmeniaClaw agents unbind --agent work --all

unbind akceptuje albo --all, albo jedną lub więcej wartości --bind, ale nie oba naraz.

Powierzchnia poleceń

agents

Uruchomienie OmeniaClaw agents bez podpolecenia jest równoważne z OmeniaClaw agents list.

agents list

Opcje:

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

agents add [name]

Opcje:

• --workspace <dir>
• --model <id>
• --agent-dir <dir>
• --bind <channel[:accountId]> (można powtarzać)
• --non-interactive
• --json

Uwagi:

• 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 zasiewanie uwierzytelniania kopiuje tylko przenośne profile statyczne (api_key i statyczny token domyślnie). Profile OAuth z tokenem odświeżania pozostają dostępne tylko przez dziedziczenie z odczytem z rzeczywistego magazynu agenta main. Jeśli skonfigurowany domyślny agent nie jest main, zaloguj się osobno dla profili OAuth na nowym agencie.

agents bindings

Opcje:

• --agent <id>
• --json

agents bind

Opcje:

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

agents unbind

Opcje:

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

agents delete <id>

Opcje:

• --force
• --json

Uwagi:

• 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, aby czyszczenie konfiguracji i magazynu sesji współdzieliło ten sam mechanizm zapisu co ruch runtime. Jeśli Gateway jest nieosiągalny, CLI wraca do ścieżki lokalnej offline.
• Jeśli obszar roboczy innego agenta jest tą samą ścieżką, znajduje się wewnątrz tego obszaru roboczego albo zawiera ten obszar roboczy, obszar roboczy jest zachowywany, a --json raportuje workspaceRetained, workspaceRetainedReason i workspaceSharedWith.

Pliki tożsamości

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

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

Ścieżki awatarów są rozwiązywane względem katalogu głównego obszaru roboczego.

Ustawianie tożsamości

set-identity zapisuje pola w agents.list[].identity:

• name
• theme
• emoji
• avatar (ścieżka względna wobec obszaru roboczego, URL http(s) albo identyfikator URI danych)

Opcje:

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

Uwagi:

• --agent lub --workspace można użyć do wybrania docelowego agenta.
• Jeśli polegasz na --workspace, a wielu agentów współdzieli ten obszar roboczy, polecenie kończy się niepowodzeniem i prosi o przekazanie --agent.
• Gdy nie podano jawnych pól tożsamości, polecenie odczytuje dane tożsamości z IDENTITY.md.

Wczytywanie z IDENTITY.md:

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

Jawne nadpisanie pól:

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

Przykład konfiguracji:

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

Powiązane

• Dokumentacja CLI
• Routing wieloagentowy
• Obszar roboczy agenta