Claude Code를 영구적인 개인용 에이전트로 변환하는 ClawCode 플러그인

실용적 조언

기존 OpenClaw 사용자는 /agent:import 명령어를 통해 설정과 기억을 15분 내외로 이전할 수 있다.
macOS의 launchd나 Linux의 systemd를 사용하여 에이전트를 백그라운드 서비스로 상시 실행할 수 있다.
/agent:doctor 명령어를 사용하여 설정 오류나 메모리 이슈를 자동으로 점검하고 복구할 수 있다.

섹션별 상세

Claude Code의 세션 초기화 문제를 해결하기 위해 SQLite와 FTS5를 활용한 영구 기억 시스템을 구축했다. 사용자의 질문이 입력되면 데이터베이스 내의 과거 대화 기록을 검색하여 맥락을 파악하며, 특히 스페인어 질문으로 영어 기억을 찾는 등의 교차 언어 검색을 지원한다. 이를 통해 에이전트가 사용자의 개인적 선호나 과거 결정을 기억하고 답변에 반영하는 것이 가능해졌다.

bash

/plugin marketplace add crisandrews/ClawCode
/plugin install agent@clawcode

Claude Code 내에서 ClawCode 플러그인을 설치하는 명령어

에이전트의 인격과 정체성을 유지하기 위해 세션 시작 시 이름, 성격, 고유 이모지를 설정하는 기능을 도입했다. 설정된 페르소나는 모든 세션에서 유지되며, 사용자의 특정 취향이나 싫어하는 요소를 기억하여 맞춤형으로 응답한다. 단순한 도구를 넘어 사용자와의 관계를 형성하는 '개인 비서'로서의 역할을 수행하도록 설계됐다.

매일 새벽 3시에 실행되는 '꿈(Dream)' 프로세스를 통해 단기 기억을 장기 기억으로 정제하는 메커니즘을 구현했다. Light, REM, Deep의 3단계 과정을 거치며 하루 동안 발생한 정보 중 중요한 내용을 선별하여 데이터베이스에 저장한다. 이 과정은 인간의 수면 중 기억 정리 방식을 모방하여 에이전트의 지식 구조를 효율적으로 관리한다.

WhatsApp, Telegram, Discord, Slack 등 다양한 외부 채널과의 연동을 위해 MCP 서버 아키텍처를 채택했다. 각 메시징 플러그인은 독립적인 MCP 서버로 작동하여 충돌 없이 실행되며, 터미널 외부에서도 에이전트가 사용자에게 알림을 보내거나 대화를 이어갈 수 있게 한다. ElevenLabs와 Whisper를 통한 음성 입출력 기능도 통합되어 인터페이스의 제약을 없앴다.

용어 해설

모델 컨텍스트 프로토콜(MCP): — Anthropic에서 제안한 표준 프로토콜로, AI 모델이 외부 도구나 데이터 소스와 안전하고 일관되게 상호작용할 수 있도록 돕는 인터페이스 규격이다. 이를 통해 다양한 메시징 앱이나 데이터베이스를 에이전트의 확장 기능으로 쉽게 연결할 수 있다.
전체 텍스트 검색 엔진(FTS5): — SQLite 데이터베이스에서 제공하는 가상 테이블 모듈로, 대량의 텍스트 데이터 내에서 특정 단어나 구문을 매우 빠르게 검색할 수 있게 해준다. 에이전트의 장기 기억 장치에서 관련 과거 대화나 정보를 효율적으로 찾아내는 데 핵심적인 역할을 한다.
서버 전송 이벤트 스트리밍(SSE Streaming): — 서버가 클라이언트에 실시간으로 데이터를 밀어주는 단방향 통신 기술이다. LLM이 답변을 생성하는 과정에서 텍스트를 한 글자씩 실시간으로 웹 UI에 표시하여 사용자 경험을 개선하는 데 주로 사용된다.

언급된 도구

ClawCode추천링크

Claude Code용 개인 에이전트 확장 플러그인

ElevenLabs추천

에이전트의 음성 출력을 위한 TTS 엔진

SQLite추천

에이전트의 장기 기억 및 대화 로그 저장소

언급된 리소스

GitHubClawCode GitHub Repository