메인 콘텐츠로 건너뛰기

​
openclaw agents

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

​
예시

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

​
라우팅 바인딩

인바운드 채널 트래픽을 특정 에이전트에 고정하려면 라우팅 바인딩을 사용하세요. 에이전트별로 서로 다른 표시 Skills도 원한다면, openclaw.json에서 agents.defaults.skills와 agents.list[].skills를 구성하세요. 자세한 내용은 Skills config 및 Configuration Reference를 참조하세요. 바인딩 나열: 
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는 가능할 때 채널 기본값과 plugin 설정 훅에서 이를 해석합니다. bind 또는 unbind에서 --agent를 생략하면 OpenClaw는 현재 기본 에이전트를 대상으로 합니다.

​
바인딩 범위 동작

  • accountId가 없는 바인딩은 채널 기본 계정에만 일치합니다.
  • accountId: "*"는 채널 전체 대체값(모든 계정)이며, 명시적 계정 바인딩보다 덜 구체적입니다.
  • 동일한 에이전트에 이미 accountId 없는 일치하는 채널 바인딩이 있고, 나중에 명시적이거나 해석된 accountId로 바인딩하면, OpenClaw는 중복을 추가하는 대신 기존 바인딩을 제자리에서 업그레이드합니다.
예시: 
# initial channel-only binding
openclaw agents bind --agent work --bind telegram

# later upgrade to account-scoped binding
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
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
참고:
  • 명시적인 add 플래그를 하나라도 전달하면 명령은 non-interactive 경로로 전환됩니다.
  • Non-interactive 모드에서는 에이전트 이름과 --workspace가 모두 필요합니다.
  • main은 예약되어 있으며 새 에이전트 ID로 사용할 수 없습니다.

​
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가 없으면 대화형 확인이 필요합니다.
  • 워크스페이스, 에이전트 상태, 세션 transcript 디렉터리는 영구 삭제되지 않고 휴지통으로 이동됩니다.

​
identity 파일

각 에이전트 워크스페이스는 워크스페이스 루트에 IDENTITY.md를 포함할 수 있습니다.
  • 예시 경로: ~/.openclaw/workspace/IDENTITY.md
  • set-identity --from-identity는 워크스페이스 루트(또는 명시적인 --identity-file)에서 읽습니다
아바타 경로는 워크스페이스 루트를 기준으로 해석됩니다.

​
identity 설정

set-identity는 필드를 agents.list[].identity에 기록합니다.
  • name
  • theme
  • emoji
  • avatar(워크스페이스 상대 경로, http(s) URL, 또는 data URI)
옵션:
  • --agent <id>
  • --workspace <dir>
  • --identity-file <path>
  • --from-identity
  • --name <name>
  • --theme <theme>
  • --emoji <emoji>
  • --avatar <value>
  • --json
참고:
  • 대상 에이전트를 선택하려면 --agent 또는 --workspace를 사용할 수 있습니다.
  • --workspace에 의존하는데 여러 에이전트가 해당 워크스페이스를 공유하면, 명령은 실패하고 --agent를 전달하라고 안내합니다.
  • 명시적인 identity 필드가 제공되지 않으면, 명령은 IDENTITY.md에서 identity 데이터를 읽습니다.
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",
        },
      },
    ],
  },
}