Use this file to discover all available pages before exploring further.
실행 중인 하나의 Gateway에서 여러 격리된 에이전트(각각 자체 워크스페이스, 상태 디렉터리(agentDir), 세션 기록 포함)와 여러 채널 계정(예: WhatsApp 두 개)을 실행합니다. 인바운드 메시지는 바인딩을 통해 올바른 에이전트로 라우팅됩니다.여기서 에이전트는 워크스페이스 파일, 인증 프로필, 모델 레지스트리, 세션 저장소를 포함하는 전체 페르소나별 범위입니다. agentDir은 이 에이전트별 구성을 ~/.openclaw/agents/<agentId>/에 보관하는 온디스크 상태 디렉터리입니다. 바인딩은 채널 계정(예: Slack 워크스페이스 또는 WhatsApp 번호)을 이러한 에이전트 중 하나에 매핑합니다.
여기에서도 sessions_history가 더 안전한 크로스 세션 회상 경로입니다. 원시 트랜스크립트 덤프가 아니라 제한되고 정리된 뷰를 반환합니다. Assistant 회상은 수정/잘라내기 전에 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 세션 트랜스크립트를 검색해야 하는 경우 agents.list[].memorySearch.qmd.extraCollections 아래에 추가 컬렉션을 넣으세요. 모든 에이전트가 동일한 공유 트랜스크립트 컬렉션을 상속해야 할 때만 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 아래에 있으며 container 생성 시 한 번 실행됩니다. resolved scope가 "shared"이면 agent별 sandbox.docker.* override는 무시됩니다.
장점:
보안 격리: 신뢰할 수 없는 agent의 tool을 제한합니다.
리소스 제어: 특정 agent는 sandbox에 두고 다른 agent는 host에 유지합니다.
유연한 정책: agent별로 서로 다른 권한을 적용합니다.
tools.elevated는 global이며 sender 기반입니다. agent별로 구성할 수 없습니다. agent별 경계가 필요하다면 agents.list[].tools를 사용해 exec를 거부하세요. group targeting에는 agents.list[].groupChat.mentionPatterns를 사용해 @mention이 의도한 agent로 깔끔하게 매핑되도록 합니다.
