여러 개의 격리된 에이전트를 실행합니다. 각 에이전트는 자체 워크스페이스, 상태 디렉터리(agentDir), 세션 기록을 가지며, 하나의 실행 중인 Gateway 안에서 여러 채널 계정(예: 두 개의 WhatsApp)을 함께 사용할 수 있습니다. 인바운드 메시지는 바인딩을 통해 올바른 에이전트로 라우팅됩니다.여기서 에이전트는 워크스페이스 파일, 인증 프로필, 모델 레지스트리, 세션 저장소를 포함하는 전체 페르소나별 범위입니다. agentDir는 이 에이전트별 구성을 ~/.openclaw/agents/<agentId>/에 보관하는 온디스크 상태 디렉터리입니다. 바인딩은 채널 계정(예: Slack 워크스페이스 또는 WhatsApp 번호)을 이러한 에이전트 중 하나에 매핑합니다.
여기서도 sessions_history가 더 안전한 세션 간 회상 경로입니다. 원시 transcript 덤프가 아니라 제한되고 정리된 뷰를 반환합니다. 어시스턴트 회상은 편집/잘라내기 전에 thinking 태그, <relevant-memories> 스캐폴딩, 일반 텍스트 도구 호출 XML 페이로드(<tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls>, 잘린 도구 호출 블록 포함), 다운그레이드된 도구 호출 스캐폴딩, 유출된 ASCII/전각 모델 제어 토큰, 잘못된 MiniMax 도구 호출 XML을 제거합니다.
에이전트 간에 agentDir를 재사용하지 마세요. 인증/세션 충돌이 발생합니다. 에이전트는 로컬 프로필이 없을 때 기본/메인 에이전트의 인증 프로필을 읽을 수 있지만, OpenClaw는 OAuth 새로 고침 토큰을 보조 에이전트 저장소로 복제하지 않습니다. 독립적인 OAuth 계정을 원하면 해당 에이전트에서 로그인하세요. 자격 증명을 수동으로 복사하는 경우 이식 가능한 정적 api_key 또는 token 프로필만 복사하세요.
Skills는 각 에이전트 워크스페이스와 ~/.openclaw/skills 같은 공유 루트에서 로드된 다음, 구성된 경우 유효한 에이전트 Skills 허용 목록으로 필터링됩니다. 공유 기준에는 agents.defaults.skills를 사용하고, 에이전트별 대체에는 agents.list[].skills를 사용하세요. Skills: 에이전트별 vs 공유 및 Skills: 에이전트 Skills 허용 목록을 참고하세요.Gateway는 하나의 에이전트(기본값) 또는 여러 에이전트를 나란히 호스팅할 수 있습니다.
워크스페이스 참고: 각 에이전트의 워크스페이스는 기본 cwd이며, 강제 샌드박스가 아닙니다. 상대 경로는 워크스페이스 안에서 해석되지만, 샌드박싱이 활성화되어 있지 않으면 절대 경로로 호스트의 다른 위치에 접근할 수 있습니다. 샌드박싱을 참고하세요.
한 에이전트가 다른 에이전트의 QMD 세션 transcript를 검색해야 한다면 agents.list[].memorySearch.qmd.extraCollections 아래에 추가 컬렉션을 추가하세요. 모든 에이전트가 같은 공유 transcript 컬렉션을 상속해야 할 때만 agents.defaults.memorySearch.qmd.extraCollections를 사용하세요.
하나의 WhatsApp 계정을 유지하면서 서로 다른 WhatsApp DM을 서로 다른 에이전트로 라우팅할 수 있습니다. peer.kind: "direct"와 함께 발신자 E.164(예: +15551234567)로 매칭합니다. 답장은 여전히 같은 WhatsApp 번호에서 전송됩니다(에이전트별 발신자 ID 없음).
직접 채팅은 에이전트의 메인 세션 키로 접히므로, 진정한 격리에는 사람마다 하나의 에이전트가 필요합니다.
여러 계정을 지원하는 채널(예: WhatsApp)은 각 로그인을 식별하기 위해 accountId를 사용합니다. 각 accountId를 다른 에이전트로 라우팅할 수 있으므로, 하나의 서버가 세션을 섞지 않고 여러 전화번호를 호스팅할 수 있습니다.accountId가 생략되었을 때 채널 전체 기본 계정을 원하면 channels.<channel>.defaultAccount를 설정하세요(선택 사항). 설정하지 않으면 OpenClaw는 default가 있으면 그것으로 폴백하고, 없으면 구성된 첫 번째 계정 ID(정렬 기준)로 폴백합니다.이 패턴을 지원하는 일반적인 채널은 다음과 같습니다.
{ agents: { list: [ { id: "personal", workspace: "~/.openclaw/workspace-personal", sandbox: { mode: "off", // No sandbox for personal agent }, // No tool restrictions - all tools available }, { id: "family", workspace: "~/.openclaw/workspace-family", sandbox: { mode: "all", // Always sandboxed scope: "agent", // One container per agent docker: { // Optional one-time setup after container creation setupCommand: "apt-get update && apt-get install -y git curl", }, }, tools: { allow: ["read"], // Only read tool deny: ["exec", "write", "edit", "apply_patch"], // Deny others }, }, ], },}
setupCommand는 sandbox.docker 아래에 있으며 컨테이너 생성 시 한 번 실행됩니다. 확인된 범위가 "shared"인 경우 에이전트별 sandbox.docker.* 재정의는 무시됩니다.
장점:
보안 격리: 신뢰할 수 없는 에이전트의 도구를 제한합니다.
리소스 제어: 특정 에이전트는 sandbox에 두고 다른 에이전트는 호스트에 유지합니다.
유연한 정책: 에이전트별로 다른 권한을 적용합니다.
tools.elevated는 전역이며 발신자 기반입니다. 에이전트별로 구성할 수 없습니다. 에이전트별 경계가 필요하면 agents.list[].tools를 사용해 exec를 거부합니다. 그룹 타기팅에는 agents.list[].groupChat.mentionPatterns를 사용해 @멘션이 의도한 에이전트에 깔끔하게 매핑되도록 합니다.
