하나의 Gateway, 여러 비서: Bindings 로 올바른 메시지를 올바른 Agent 에게

4 min read

업무용 그룹과 개인 채팅이 같은 비서에게 말을 걸면 금방 정신이 없어집니다.

그 문제를 해결하는 것이 멀티 Agent + Bindings 입니다. 상황에 맞는 비서가 나오게 할 수 있습니다.

이번 글에서 배울 것

  • 어떤 경우에 여러 Agent 가 필요한지
  • Config 에 여러 Agent 정의하기
  • Bindings 규칙으로 메시지 라우팅하기
  • Telegram 그룹 ID 찾기

왜 여러 Agent 가 필요할까?

상황 필요
업무 그룹 vs 개인 대화 워크스페이스 분리, 데이터 분리
빠른 응답 vs 깊은 분석 다른 모델
여러 독립 프로젝트 프로젝트별 워크스페이스

어떻게 설정할까?

1단계: agents.list 에 비서 정의하기

{
  "agents": {
    "list": [
      { "id": "main",      "name": "Main Assistant", "workspace": "~/.openclaw/workspace-main", "default": true },
      { "id": "project-a", "name": "Project A",      "workspace": "~/.openclaw/workspace-project-a" },
      { "id": "project-b", "name": "Project B",      "workspace": "~/.openclaw/workspace-project-b" }
    ]
  }
}

2단계: bindings 에 라우팅 규칙 추가하기

접수 데스크라고 생각하면 쉽습니다.

"그룹 A 에서 오면 비서 A 로, 그룹 B 에서 오면 비서 B 로, 나머지는 기본 비서로."

{
  "bindings": [
    { "agentId": "project-a", "match": { "channel": "telegram", "peer": { "kind": "group", "id": "-1001234567890" } } },
    { "agentId": "project-b", "match": { "channel": "telegram", "peer": { "kind": "group", "id": "-1009876543210" } } },
    { "agentId": "main",      "match": { "channel": "telegram" } }
  ]
}

⚠️ Bindings 순서는 매우 중요합니다. 더 구체적인 규칙을 앞에 두세요. 매칭은 "먼저 맞는 규칙이 승리" 입니다.


그룹 ID 는 어떻게 찾을까?

방법 1: 그룹에 아무 메시지나 하나 보내고 다음을 실행합니다.

openclaw logs --follow
# 로그에서 chat.id 를 찾는다. 보통 -1001234567890 같은 음수

방법 2: 그 그룹의 메시지를 @userinfobot 으로 전달합니다.


고급편: Bot 계정마다 다른 비서 사용하기

여러 Bot Token 이 있다면:

{
  "channels": {
    "telegram": {
      "accounts": {
        "default": { "botToken": "Bot A 의 Token" },
        "alerts":  { "botToken": "Bot B 의 Token" }
      }
    }
  },
  "bindings": [
    { "agentId": "main",   "match": { "channel": "telegram", "accountId": "default" } },
    { "agentId": "alerts", "match": { "channel": "telegram", "accountId": "alerts" } }
  ]
}

수정 후에는 저장하기

Config 를 바꾼 뒤 Save / Apply 를 누르세요. baseHash conflict 가 뜨면 다른 곳에서 설정이 바뀐 것입니다. 다시 불러온 뒤 재적용하면 됩니다.


다음 글

이제 여러 비서를 갖게 되었습니다. 다음은 그중 하나를 VPS 에 올려 24시간 대기 상태로 만들어 봅시다.

← 이전 글: 메모리와 워크스페이스 | 👉 비서를 VPS 로 옮겨 원격에서 쓰기