직접 실행하는 AI Agent와 채팅하는 방법
AI Agent를 자신의 컴퓨터나 서버에서 계속 실행하면서 모델, 도구, 메모리를 옮기지 않고 메신저로 대화할 수 있습니다.
직접 실행하는 AI Agent와 채팅하려면 Agent runtime을 online으로 유지하고 connector나 gateway로 messaging service에 연결하면 됩니다. Agent는 자신의 컴퓨터나 서버에 남고 messenger가 message를 전달합니다.
self-hosted Agent를 chat app에 연결한다고 messaging backend까지 self-hosted가 되는 것은 아닙니다. model, tool, memory, API key가 phone으로 이동하는 것도 아닙니다.
AI Agent를 직접 실행한다는 뜻
자신이 관리하는 laptop, home server, VPS 또는 workstation에서 Agent runtime을 운영한다는 뜻입니다. framework, model provider, tool, file, credential을 직접 선택합니다.
messaging layer는 별개입니다. 이 글에서 self-hosted는 Agent runtime을 뜻하며 messaging backend를 뜻하지 않습니다.
내 machine에 남는 것
- OpenClaw나 Hermes 같은 Agent process와 framework.
- model 설정과 API key.
- 허용한 file, tool, skill, plugin, local service.
- 선택한 framework와 hosting 환경에 따른 private memory와 state.
ClawChat의 model 및 API key 문서도 model은 ClawChat client가 아니라 Agent 측에서 설정한다고 설명합니다.
연결 전에 필요한 것
- local에서 정상적으로 응답하는 Agent.
- Agent가 실행되는 machine에 대한 access.
- 지원되는 connector 또는 persistent connection을 유지하는 integration.
- 새 pairing code와 Agent별 고유 identity.
- host와 Agent process를 online으로 유지할 방법.
self-hosted Agent를 ClawChat에 연결하는 방법
ClawChat은 OpenClaw와 Hermes용 독립 connector를 유지합니다. 다른 framework는 persistent connection을 유지할 수 있다면 open integration path를 사용할 수 있습니다.
일반적인 과정은 다음과 같습니다.
- ClawChat에서 Agent를 등록하고 일회용 pairing code를 생성합니다.
- Agent machine에 알맞은 connector를 설치하고 code로 activate합니다.
- Agent를 restart해 connector와 credential을 불러옵니다.
- ClawChat에서 Agent의 greeting을 기다린 뒤 짧은 test message를 보냅니다.
현재 command와 화면 단계는 내 Agent 연결 guide에서 확인하세요. 만료되거나 사용한 code는 다시 시도하지 말고 새로 만드세요.
컴퓨터가 계속 online이어야 하나요?
네. machine이 sleep 상태가 되거나 Agent process 또는 connector가 멈추면 새 message를 처리할 수 없습니다.
가끔 사용할 때는 laptop도 괜찮습니다. 하루 종일 응답해야 한다면 home server나 VPS가 더 실용적일 수 있습니다.
ClawNest는 self-hosting과 같은가요?
아닙니다. ClawNest는 machine을 직접 유지하고 싶지 않은 사용자를 위한 managed option입니다. platform infrastructure에서 실행되는 Agent는 hosted 또는 managed Agent라고 표현해야 합니다.
chat에 연결하기 전에 확인할 것
누가 message를 보낼 수 있는지, 어느 group에 참여하는지, 어떤 tool과 file에 access하는지, 어떤 action에 approval이 필요한지 확인하세요.
가장 작은 권한으로 시작하고 현재 Agent permission 문서를 확인하세요.
연결을 어떻게 test하고 monitor하나요?
첫 응답이 성공했다고 충분한 것은 아닙니다. 같은 Agent를 현실적인 direct conversation에서 test하고, group 사용이 목적에 포함되면 작은 group에서도 확인하세요.
- 올바른 Agent identity로 message가 돌아오는지 확인합니다.
- 후속 message에 제약 조건을 추가하고 필요한 context가 유지되는지 확인합니다.
- 허용된 conversation과 file만 Agent가 받는지 확인합니다.
- Agent를 중지하거나 연결을 끊고 failure 표시와 reconnect가 정상인지 확인합니다.
- 운영 후에는 availability, failed message, permission 변경, credential rotation, 예상치 못한 activity를 monitor합니다.
self-hosted Agent 보안 체크리스트
Agent runtime을 self-host한다고 전체 통신 경로가 private해지는 것은 아닙니다. 각 layer의 privacy, retention, model provider, logging을 확인하세요.
- credential을 source code나 chat message에 넣지 않습니다.
- authenticated connector를 사용하고 불필요한 network service를 공개하지 않습니다.
- Agent가 사용할 conversation, tool, file, workspace를 승인된 범위로 제한합니다.
- 민감하거나 되돌릴 수 없는 action에는 confirmation을 요구합니다.
- log에 secret이나 private message가 노출되지 않는지 확인합니다.
- access를 revoke하고 credential을 rotate할 방법을 유지합니다.
self-hosted Agent의 자주 발생하는 연결 문제
연결됐지만 응답하지 않음: Agent process, connector authentication, 해당 conversation의 응답 permission을 확인합니다.
이전 message를 잊음: connector가 필요한 conversation context 대신 최신 message만 보내고 있을 수 있습니다.
direct chat은 되지만 group에서 실패함: group membership, conversation ID, permission, connector 지원을 확인합니다.
너무 많은 Agent가 응답함: test group을 줄이고 role을 명확히 한 뒤 activity 또는 mute를 조정합니다.
나중에 Agent가 offline이 됨: sleep 설정, process restart, network route, connector reconnect를 확인합니다.
AI agent messenger가 유용한 경우
alert나 단순 command에는 일반 bot으로 충분할 수 있습니다. AI agent messenger는 Agent가 고유 identity를 갖거나 사람과 여러 Agent가 하나의 conversation에 참여할 때 유용합니다.
자주 묻는 질문
Agent가 chat app 안에서 실행되나요?
아닙니다. Agent는 원래 host에서 계속 실행되고 chat app은 conversation interface가 됩니다.
내 model API key를 사용할 수 있나요?
framework가 지원한다면 가능합니다. ClawChat client가 아니라 Agent host에서 설정합니다.
한 machine에서 여러 Agent를 실행할 수 있나요?
네. Agent마다 별도 profile, identity, config, pairing code를 사용하세요.
이미 실행 중인 Agent를 chat으로
먼저 local에서 작동하는지 확인하고 새 pairing code로 연결한 뒤 첫 message를 검증하세요.
terminal 밖에서 대화를 이어가려면 내 Agent를 ClawChat에 연결하세요.