ClawdBot: 나만의 개인 AI Assistant 만들기 (2026)

ClawdBot: 나만의 개인용 AI 어시스턴트 구축하기 (2026)

ClawdBot은 일상적인 워크플로우를 위해 맞춤형으로 상시 대기하는 AI 동반자를 구축할 수 있게 해주는 오픈 소스 개인용 AI 어시스턴트 프레임워크입니다. 작업 관리, 문서 요약, 코드 작성 또는 반복적인 업무 자동화 등 무엇이 필요하든 ClawdBot은 사용자의 요구에 맞춘 어시스턴트를 만드는 데 필요한 빌딩 블록을 제공합니다.

이 가이드는 ClawdBot을 처음부터 설정하고, 동작을 커스터마이징하며, 즐겨 사용하는 도구 및 서비스에 연결하는 과정을 안내합니다.

ClawdBot이란 무엇인가요?

ClawdBot은 대규모 언어 모델(LLM)을 기반으로 구축된 모듈형 AI 어시스턴트 프레임워크입니다. 일반적인 챗봇과 달리 ClawdBot은 셀프 호스팅이 가능하고 개인정보를 존중하며 깊이 있는 커스터마이징이 가능하도록 설계되었습니다. 사용자가 직접 페르소나, 기능 및 통합 서비스를 정의할 수 있습니다.

주요 기능

기능	설명
멀티 모델 지원	Claude, GPT, Gemini 또는 Ollama를 통한 로컬 모델 연결
플러그인 시스템	퍼스트 파티 및 커뮤니티 플러그인으로 기능 확장
메모리 관리	설정 가능한 보존 기간을 가진 지속적인 대화 메모리
도구 호출 (Tool calling)	쉘 명령어, API 호출 및 파일 작업 실행
멀티 채널	Discord, Slack, Telegram 배포 또는 CLI를 통한 사용
프라이버시 우선	데이터에 대한 완전한 제어권을 갖는 셀프 호스팅 방식

사전 요구 사항

시작하기 전에 다음 사항이 준비되었는지 확인하세요:

Node.js 20+ 설치됨
npm 또는 pnpm 패키지 매니저
최소 하나 이상의 LLM 제공업체 API 키 (Anthropic, OpenAI, 또는 Ollama를 통한 로컬 모델)
작업에 익숙한 터미널 환경

1단계: ClawdBot 설치

저장소를 클론하고 의존성 패키지를 설치합니다:

git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install

환경 변수 예시 파일을 복사합니다:

cp .env.example .env

2단계: LLM 제공업체 설정

.env 파일을 열고 API 자격 증명을 추가합니다. ClawdBot은 여러 제공업체를 동시에 지원하므로 필요한 만큼 구성할 수 있습니다.

# 기본 제공업체
ANTHROPIC_API_KEY=sk-ant-your-key-here
DEFAULT_MODEL=claude-sonnet-4-20250514

# 선택 사항: 보조 제공업체
OPENAI_API_KEY=sk-your-openai-key
OLLAMA_BASE_URL=http://localhost:11434

제공업체 비교

제공업체	최적의 용도	비용	지연 시간
Anthropic Claude	복잡한 추론, 코딩	$3-15/M 토큰	낮음
OpenAI GPT-5	일반적인 작업, 비전	$2-30/M 토큰	낮음
Google Gemini	긴 컨텍스트, 멀티모달	$1-7/M 토큰	중간
Ollama (로컬)	프라이버시, 오프라인 사용	무료 (하드웨어 비용)	가변적

3단계: 어시스턴트 페르소나 정의

ClawdBot은 구성 파일을 사용하여 어시스턴트의 행동을 정의합니다. config/persona.yaml 파일을 생성하거나 수정하세요:

name: "Atlas"
personality:
  tone: professional
  verbosity: concise
  humor: subtle
instructions: |
  당신은 개인 생산성 어시스턴트 Atlas입니다.
  항상 이론보다는 실행 가능한 조언을 우선시하세요.
  작업에 대해 질문을 받으면 먼저 작업 목록을 확인하세요.
  도움이 되는 경우 응답을 마크다운 형식으로 작성하세요.
capabilities:
  - task_management
  - code_review
  - document_summary
  - web_search
  - calendar_integration

여러 페르소나 파일을 만들어 전환하며 사용할 수 있습니다:

clawdbot --persona config/persona-coding.yaml
clawdbot --persona config/persona-writing.yaml

4단계: 플러그인 추가

플러그인은 ClawdBot의 기능을 확장합니다. 플러그인 레지스트리에서 설치하세요:

# 작업 관리 플러그인
clawdbot plugin add @clawdbot/tasks

# 웹 검색 플러그인
clawdbot plugin add @clawdbot/web-search

# 캘린더 연동
clawdbot plugin add @clawdbot/google-calendar

# 코드 실행 샌드박스
clawdbot plugin add @clawdbot/code-runner

각 플러그인은 config/plugins.yaml에서 설정합니다:

plugins:
  tasks:
    storage: sqlite
    db_path: ./data/tasks.db
  web-search:
    provider: tavily
    api_key: ${TAVILY_API_KEY}
  google-calendar:
    credentials_path: ./config/google-credentials.json
  code-runner:
    languages: [python, javascript, bash]
    timeout: 30s
    sandbox: docker

5단계: 메모리 및 컨텍스트 설정

ClawdBot은 이전 대화를 기억하고 향후 상호작용에서 이를 참조할 수 있습니다. config/memory.yaml에서 메모리를 설정하세요:

memory:
  enabled: true
  backend: sqlite
  db_path: ./data/memory.db
  retention:
    conversations: 90d
    facts: permanent
    preferences: permanent
  context_window:
    max_messages: 50
    summary_threshold: 30

대화 내용이 요약 임계값(summary threshold)을 초과하면, ClawdBot은 토큰 제한 내에서 컨텍스트를 유지하기 위해 이전 메시지를 자동으로 요약합니다.

6단계: 채널에 배포

CLI 모드 (기본)

터미널에서 ClawdBot을 시작합니다:

clawdbot start

이제 터미널에서 직접 대화할 수 있습니다:

You: 오늘 내 작업들을 요약해줘.
Atlas: 오늘 예정된 3개의 작업이 있습니다:
  1. PR #142 리뷰 - 프론트엔드 리팩토링 (오후 2시까지)
  2. /users 엔드포인트에 대한 API 문서 작성
  3. 목요일 스탠드업 회의용 슬라이드 준비

Discord 봇

.env 파일에 Discord 자격 증명을 추가합니다:

DISCORD_BOT_TOKEN=your-discord-bot-token
DISCORD_CHANNEL_ID=123456789

Discord 모드로 시작합니다:

clawdbot start --channel discord

Slack 봇

SLACK_BOT_TOKEN=xoxb-your-slack-bot-token
SLACK_SIGNING_SECRET=your-signing-secret

clawdbot start --channel slack

7단계: 커스텀 도구 만들기

대화 중에 ClawdBot이 호출할 수 있는 커스텀 도구를 정의할 수 있습니다. tools/ 디렉토리에 도구 파일을 생성하세요:

// tools/check-website-status.ts
import { defineTool } from '@clawdbot/sdk';

export default defineTool({
  name: 'check_website_status',
  description: '웹사이트의 가동 여부를 확인하고 HTTP 상태 코드를 반환합니다.',
  parameters: {
    url: {
      type: 'string',
      description: '확인할 URL',
      required: true,
    },
  },
  async execute({ url }) {
    const response = await fetch(url, { method: 'HEAD' });
    return {
      url,
      status: response.status,
      ok: response.ok,
      latency: response.headers.get('x-response-time'),
    };
  },
});

설정 파일에 도구를 등록하세요:

tools:
  custom:
    - ./tools/check-website-status.ts
    - ./tools/deploy-preview.ts

실용적인 자동화 예시

모닝 브리핑

일일 브리핑을 받기 위해 cron 작업을 설정하세요:

# crontab 항목 - 매일 오전 8시에 실행
0 8 * * * clawdbot run "오늘의 모닝 브리핑을 해줘: 오늘 일정, 남은 작업, 날씨 요약" --output ./briefing.md

PR 리뷰 자동화

# CI 파이프라인 내부
gh pr diff $PR_NUMBER | clawdbot run "이 풀 리퀘스트 diff를 리뷰해줘. 잠재적인 버그, 보안 이슈, 스타일 문제를 지적해주되 간결하게 작성해줘."

문서 요약 파이프라인

# 폴더 내 모든 PDF 요약
for file in ./documents/*.pdf; do
  clawdbot run "이 문서를 3개의 불렛 포인트로 요약해줘" --attach "$file" >> summaries.md
done

트러블슈팅

문제	해결 방법
"API key not found"	`.env` 파일에 올바른 키가 있는지, 변수 이름이 일치하는지 확인하세요.
메모리 데이터베이스 잠금	모든 ClawdBot 인스턴스를 중지한 후 재시작하세요.
플러그인 로드 실패	`clawdbot plugin update`를 실행하고 버전 호환성을 확인하세요.
응답 속도가 느림	더 빠른 모델로 전환하거나 간단한 작업에는 로컬 Ollama 모델을 사용하세요.
컨텍스트가 너무 긺	메모리 설정에서 `max_messages`를 줄이거나 자동 요약 기능을 활성화하세요.

ClawdBot을 최대한 활용하기 위한 팁

페르소나 지침을 구체적으로 작성하세요. 어시스턴트가 어떻게 행동하기를 원하는지 더 많은 컨텍스트를 제공할수록 더 나은 결과를 얻을 수 있습니다.
여러 페르소나를 사용하세요. 코딩, 글쓰기, 개인 용도 등 별도의 구성을 만드세요.
도구 체이닝(Tool chaining)을 활용하세요. ClawdBot은 복잡한 작업을 수행하기 위해 여러 도구를 순차적으로 호출할 수 있습니다.
정기적으로 메모리를 검토하세요. ClawdBot이 저장한 사실들을 확인하고 오래된 정보를 수정하세요.
CLI 모드로 시작하세요. Discord나 Slack에 배포하기 전에 기본 기능에 익숙해지세요.

결론

ClawdBot은 사용자의 정확한 워크플로우에 맞는 AI 어시스턴트를 구축할 수 있는 유연성을 제공합니다. 단순한 작업 관리부터 복잡한 멀티 도구 자동화에 이르기까지, 모듈형 아키텍처 덕분에 작게 시작하여 필요에 따라 확장할 수 있습니다.

AI 기반 프로젝트를 진행 중이며 이미지 생성, 비디오 제작 또는 기타 미디어 작업을 위한 신뢰할 수 있는 인프라가 필요하다면, Hypereal AI에서 ClawdBot과 같은 도구와 원활하게 통합되는 프로덕션 수준의 API를 제공합니다. 개인용 어시스턴트에 강력한 미디어 생성 기능을 추가하려면 확인해 보세요.

ClawdBot: 나만의 개인용 AI 어시스턴트 구축하기 (2026)

이 가이드는 ClawdBot을 처음부터 설정하고, 동작을 커스터마이징하며, 즐겨 사용하는 도구 및 서비스에 연결하는 과정을 안내합니다.

ClawdBot이란 무엇인가요?

주요 기능

기능	설명
멀티 모델 지원	Claude, GPT, Gemini 또는 Ollama를 통한 로컬 모델 연결
플러그인 시스템	퍼스트 파티 및 커뮤니티 플러그인으로 기능 확장
메모리 관리	설정 가능한 보존 기간을 가진 지속적인 대화 메모리
도구 호출 (Tool calling)	쉘 명령어, API 호출 및 파일 작업 실행
멀티 채널	Discord, Slack, Telegram 배포 또는 CLI를 통한 사용
프라이버시 우선	데이터에 대한 완전한 제어권을 갖는 셀프 호스팅 방식

사전 요구 사항

시작하기 전에 다음 사항이 준비되었는지 확인하세요:

Node.js 20+ 설치됨
npm 또는 pnpm 패키지 매니저
최소 하나 이상의 LLM 제공업체 API 키 (Anthropic, OpenAI, 또는 Ollama를 통한 로컬 모델)
작업에 익숙한 터미널 환경

1단계: ClawdBot 설치

저장소를 클론하고 의존성 패키지를 설치합니다:

git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install

환경 변수 예시 파일을 복사합니다:

cp .env.example .env

2단계: LLM 제공업체 설정

.env 파일을 열고 API 자격 증명을 추가합니다. ClawdBot은 여러 제공업체를 동시에 지원하므로 필요한 만큼 구성할 수 있습니다.

# 기본 제공업체
ANTHROPIC_API_KEY=sk-ant-your-key-here
DEFAULT_MODEL=claude-sonnet-4-20250514

# 선택 사항: 보조 제공업체
OPENAI_API_KEY=sk-your-openai-key
OLLAMA_BASE_URL=http://localhost:11434

제공업체 비교

제공업체	최적의 용도	비용	지연 시간
Anthropic Claude	복잡한 추론, 코딩	$3-15/M 토큰	낮음
OpenAI GPT-5	일반적인 작업, 비전	$2-30/M 토큰	낮음
Google Gemini	긴 컨텍스트, 멀티모달	$1-7/M 토큰	중간
Ollama (로컬)	프라이버시, 오프라인 사용	무료 (하드웨어 비용)	가변적

3단계: 어시스턴트 페르소나 정의

ClawdBot은 구성 파일을 사용하여 어시스턴트의 행동을 정의합니다. config/persona.yaml 파일을 생성하거나 수정하세요:

name: "Atlas"
personality:
  tone: professional
  verbosity: concise
  humor: subtle
instructions: |
  당신은 개인 생산성 어시스턴트 Atlas입니다.
  항상 이론보다는 실행 가능한 조언을 우선시하세요.
  작업에 대해 질문을 받으면 먼저 작업 목록을 확인하세요.
  도움이 되는 경우 응답을 마크다운 형식으로 작성하세요.
capabilities:
  - task_management
  - code_review
  - document_summary
  - web_search
  - calendar_integration

여러 페르소나 파일을 만들어 전환하며 사용할 수 있습니다:

clawdbot --persona config/persona-coding.yaml
clawdbot --persona config/persona-writing.yaml

4단계: 플러그인 추가

플러그인은 ClawdBot의 기능을 확장합니다. 플러그인 레지스트리에서 설치하세요:

# 작업 관리 플러그인
clawdbot plugin add @clawdbot/tasks

# 웹 검색 플러그인
clawdbot plugin add @clawdbot/web-search

# 캘린더 연동
clawdbot plugin add @clawdbot/google-calendar

# 코드 실행 샌드박스
clawdbot plugin add @clawdbot/code-runner

각 플러그인은 config/plugins.yaml에서 설정합니다:

plugins:
  tasks:
    storage: sqlite
    db_path: ./data/tasks.db
  web-search:
    provider: tavily
    api_key: ${TAVILY_API_KEY}
  google-calendar:
    credentials_path: ./config/google-credentials.json
  code-runner:
    languages: [python, javascript, bash]
    timeout: 30s
    sandbox: docker

5단계: 메모리 및 컨텍스트 설정

ClawdBot은 이전 대화를 기억하고 향후 상호작용에서 이를 참조할 수 있습니다. config/memory.yaml에서 메모리를 설정하세요:

memory:
  enabled: true
  backend: sqlite
  db_path: ./data/memory.db
  retention:
    conversations: 90d
    facts: permanent
    preferences: permanent
  context_window:
    max_messages: 50
    summary_threshold: 30

대화 내용이 요약 임계값(summary threshold)을 초과하면, ClawdBot은 토큰 제한 내에서 컨텍스트를 유지하기 위해 이전 메시지를 자동으로 요약합니다.

6단계: 채널에 배포

CLI 모드 (기본)

터미널에서 ClawdBot을 시작합니다:

clawdbot start

이제 터미널에서 직접 대화할 수 있습니다:

You: 오늘 내 작업들을 요약해줘.
Atlas: 오늘 예정된 3개의 작업이 있습니다:
  1. PR #142 리뷰 - 프론트엔드 리팩토링 (오후 2시까지)
  2. /users 엔드포인트에 대한 API 문서 작성
  3. 목요일 스탠드업 회의용 슬라이드 준비

Discord 봇

.env 파일에 Discord 자격 증명을 추가합니다:

DISCORD_BOT_TOKEN=your-discord-bot-token
DISCORD_CHANNEL_ID=123456789

Discord 모드로 시작합니다:

clawdbot start --channel discord

Slack 봇

SLACK_BOT_TOKEN=xoxb-your-slack-bot-token
SLACK_SIGNING_SECRET=your-signing-secret

clawdbot start --channel slack

7단계: 커스텀 도구 만들기

대화 중에 ClawdBot이 호출할 수 있는 커스텀 도구를 정의할 수 있습니다. tools/ 디렉토리에 도구 파일을 생성하세요:

// tools/check-website-status.ts
import { defineTool } from '@clawdbot/sdk';

export default defineTool({
  name: 'check_website_status',
  description: '웹사이트의 가동 여부를 확인하고 HTTP 상태 코드를 반환합니다.',
  parameters: {
    url: {
      type: 'string',
      description: '확인할 URL',
      required: true,
    },
  },
  async execute({ url }) {
    const response = await fetch(url, { method: 'HEAD' });
    return {
      url,
      status: response.status,
      ok: response.ok,
      latency: response.headers.get('x-response-time'),
    };
  },
});

설정 파일에 도구를 등록하세요:

tools:
  custom:
    - ./tools/check-website-status.ts
    - ./tools/deploy-preview.ts

실용적인 자동화 예시

모닝 브리핑

일일 브리핑을 받기 위해 cron 작업을 설정하세요:

# crontab 항목 - 매일 오전 8시에 실행
0 8 * * * clawdbot run "오늘의 모닝 브리핑을 해줘: 오늘 일정, 남은 작업, 날씨 요약" --output ./briefing.md

PR 리뷰 자동화

# CI 파이프라인 내부
gh pr diff $PR_NUMBER | clawdbot run "이 풀 리퀘스트 diff를 리뷰해줘. 잠재적인 버그, 보안 이슈, 스타일 문제를 지적해주되 간결하게 작성해줘."

문서 요약 파이프라인

# 폴더 내 모든 PDF 요약
for file in ./documents/*.pdf; do
  clawdbot run "이 문서를 3개의 불렛 포인트로 요약해줘" --attach "$file" >> summaries.md
done

트러블슈팅

문제	해결 방법
"API key not found"	`.env` 파일에 올바른 키가 있는지, 변수 이름이 일치하는지 확인하세요.
메모리 데이터베이스 잠금	모든 ClawdBot 인스턴스를 중지한 후 재시작하세요.
플러그인 로드 실패	`clawdbot plugin update`를 실행하고 버전 호환성을 확인하세요.
응답 속도가 느림	더 빠른 모델로 전환하거나 간단한 작업에는 로컬 Ollama 모델을 사용하세요.
컨텍스트가 너무 긺	메모리 설정에서 `max_messages`를 줄이거나 자동 요약 기능을 활성화하세요.

ClawdBot을 최대한 활용하기 위한 팁

페르소나 지침을 구체적으로 작성하세요. 어시스턴트가 어떻게 행동하기를 원하는지 더 많은 컨텍스트를 제공할수록 더 나은 결과를 얻을 수 있습니다.
여러 페르소나를 사용하세요. 코딩, 글쓰기, 개인 용도 등 별도의 구성을 만드세요.
도구 체이닝(Tool chaining)을 활용하세요. ClawdBot은 복잡한 작업을 수행하기 위해 여러 도구를 순차적으로 호출할 수 있습니다.
정기적으로 메모리를 검토하세요. ClawdBot이 저장한 사실들을 확인하고 오래된 정보를 수정하세요.
CLI 모드로 시작하세요. Discord나 Slack에 배포하기 전에 기본 기능에 익숙해지세요.

Hypereal로 구축 시작하기

ClawdBot: 나만의 개인용 AI 어시스턴트 구축하기 (2026)

ClawdBot이란 무엇인가요?

주요 기능

사전 요구 사항

1단계: ClawdBot 설치

2단계: LLM 제공업체 설정

제공업체 비교

3단계: 어시스턴트 페르소나 정의

4단계: 플러그인 추가

5단계: 메모리 및 컨텍스트 설정

6단계: 채널에 배포

CLI 모드 (기본)

Discord 봇

Slack 봇

7단계: 커스텀 도구 만들기

실용적인 자동화 예시

모닝 브리핑

PR 리뷰 자동화

문서 요약 파이프라인

트러블슈팅

ClawdBot을 최대한 활용하기 위한 팁

결론

관련 아티클

Telegram Bot API 입문 가이드 (2026)

2026년 최고의 오픈 소스 RAG 프레임워크

MCP Server를 처음부터 구축하는 방법 (2026)

지금 바로 개발을 시작하세요

Hypereal로 구축 시작하기

ClawdBot: 나만의 개인용 AI 어시스턴트 구축하기 (2026)

ClawdBot이란 무엇인가요?

주요 기능

사전 요구 사항

1단계: ClawdBot 설치

2단계: LLM 제공업체 설정

제공업체 비교

3단계: 어시스턴트 페르소나 정의

4단계: 플러그인 추가

5단계: 메모리 및 컨텍스트 설정

6단계: 채널에 배포

CLI 모드 (기본)

Discord 봇

Slack 봇

7단계: 커스텀 도구 만들기

실용적인 자동화 예시

모닝 브리핑

PR 리뷰 자동화

문서 요약 파이프라인

트러블슈팅

ClawdBot을 최대한 활용하기 위한 팁

결론

관련 아티클

Telegram Bot API 입문 가이드 (2026)

2026년 최고의 오픈 소스 RAG 프레임워크

MCP Server를 처음부터 구축하는 방법 (2026)

지금 바로 개발을 시작하세요