`openclaw agents`

격리된 agent를 관리합니다. (workspace + auth + routing) Related:

Multi-agent routing: Multi-Agent Routing
Agent workspace: Agent workspace

Examples

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

Routing bindings

routing binding을 사용하면 inbound channel traffic을 특정 agent에 고정할 수 있습니다. List bindings:

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

Add bindings:

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

accountId를 생략하고 --bind <channel>만 주면, OpenClaw는 가능할 때 channel default와 plugin setup hook을 이용해 이를 resolve합니다.

Binding scope behavior

accountId가 없는 binding은 channel default account에만 매칭됩니다.
accountId: "*"는 channel-wide fallback이며, explicit account binding보다 덜 구체적입니다.
같은 agent에 대해 accountId 없는 matching channel binding이 이미 있는데, 나중에 explicit 또는 resolved accountId로 bind하면 OpenClaw는 duplicate를 만들지 않고 기존 binding을 그 자리에서 upgrade합니다.

Example:

# 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

upgrade 후에는 해당 binding의 routing 범위가 telegram:ops로 제한됩니다. default-account routing도 원한다면 --bind telegram:default처럼 명시적으로 추가해야 합니다. Remove bindings:

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

Identity files

각 agent workspace는 workspace root에 IDENTITY.md를 둘 수 있습니다.

예시 path: ~/.openclaw/workspace/IDENTITY.md
set-identity --from-identity는 workspace root 또는 명시적인 --identity-file에서 읽습니다.

avatar path는 workspace root 기준으로 resolve됩니다.

Set identity

set-identity는 agents.list[].identity에 다음 field를 기록합니다.

name
theme
emoji
avatar (workspace-relative path, http(s) URL, 또는 data URI)

IDENTITY.md에서 로드:

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

field를 명시적으로 override:

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

Config sample:

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

agent approvals

CLI 명령

RPC 및 API

템플릿

기술 참조

내부 구조

프로젝트

릴리스 노트

실험

agents

`openclaw agents`

Examples

Routing bindings

Binding scope behavior

Identity files

Set identity

​openclaw agents

​Examples

​Routing bindings

​Binding scope behavior

​Identity files

​Set identity

`openclaw agents`

Examples

Routing bindings

Binding scope behavior

Identity files

Set identity