`openclaw agents`

격리된 에이전트를 관리합니다(워크스페이스 + 인증 + 라우팅).

예시

openclaw agents list
openclaw agents add work --workspace ~/.openclaw/workspace-work
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

라우팅 바인딩

라우팅 바인딩을 사용하여 인바운드 채널 트래픽을 특정 에이전트에 고정합니다.

바인딩 목록 보기:

openclaw agents bindings
openclaw agents bindings --agent work
openclaw agents bindings --json

바인딩 추가:

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

accountId를 생략하면(--bind <channel>), OpenClaw은 가능한 경우 채널 기본값과 플러그인 설정 훅에서 이를 해석합니다.

바인딩 범위 동작

accountId 없는 바인딩은 채널 기본 계정에만 매칭됩니다.
accountId: "*"는 채널 전체 폴백(모든 계정)이며, 명시적 계정 바인딩보다 덜 구체적입니다.
동일 에이전트에 이미 accountId 없는 매칭 채널 바인딩이 있고, 나중에 명시적 또는 해석된 accountId로 바인딩하면, OpenClaw은 중복을 추가하지 않고 기존 바인딩을 업그레이드합니다.

예시:

# 초기 채널만 바인딩
openclaw agents bind --agent work --bind telegram

# 나중에 계정 범위 바인딩으로 업그레이드
openclaw agents bind --agent work --bind telegram:ops

업그레이드 후 해당 바인딩의 라우팅은 telegram:ops로 범위가 지정됩니다. 기본 계정 라우팅도 필요하면 명시적으로 추가하세요(예: --bind telegram:default).

바인딩 제거:

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

아이덴티티 파일

각 에이전트 워크스페이스는 워크스페이스 루트에 IDENTITY.md를 포함할 수 있습니다:

예시 경로: ~/.openclaw/workspace/IDENTITY.md
set-identity --from-identity는 워크스페이스 루트(또는 명시적 --identity-file)에서 읽습니다

아바타 경로는 워크스페이스 루트를 기준으로 해석됩니다.

아이덴티티 설정

set-identity는 agents.list[].identity에 필드를 기록합니다:

name
theme
emoji
avatar (워크스페이스 상대 경로, http(s) URL 또는 data URI)

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",
        },
      },
    ],
  },
}