시작하기 · 요구사항 · 서버 설정

GUIDE HOME

🧭전체 가이드 한눈에 보기

설치부터 운영까지 5개 페이지로 구성되어 있습니다. 아래 카드를 눌러 원하는 단계로 이동하세요.

🧭설치 순서 (반드시 이 순서대로)

1OpenWebUI + Twilio 전화봇기반 시스템 · API Key 발급

→

2AI 브라우저 에이전트Browser Agent v7 설치

→

3Telegram 봇마지막에 브릿지 연결

⚠️ 설치 순서를 반드시 지켜주세요. OpenWebUI를 먼저 설치해 API Key를 발급한 뒤, AI 브라우저 에이전트를 설치하고, Telegram 봇은 가장 마지막에 설치합니다. 앞 단계의 결과(API Key·실행 중인 서비스)가 다음 단계 설치에 필요하므로 순서가 바뀌면 설치가 실패할 수 있습니다.

🚀 시작하기

시스템 구성 · 서버 최소 사양 · API 키 준비 · Ubuntu 서버 초기 설정(Docker·Ollama)

요구사항서버설정

🌐 OpenWebUI 설치

OpenWebUI + Twilio 전화비서 설치 · 입력값 안내 · 전화/SMS/예약 · 통합 대시보드

전화비서대시보드

💬 Telegram 봇

Telegram 브릿지 설치 · 명령어 · 스트리밍 · 예약 · 보안 · AI 대화 · 파일/음성 · 관리자

설치사용법

🕸️ 브라우저 에이전트 v7

AI 브라우저 에이전트 설치 · 검색 API(네이버·Tavily) · 고급 기능 · API · 문제 해결

설치사용법

🛠️ 운영 & 보안

RAG · 설치 검증 · 유지보수 · 보안 91항목 · 백업 · 미디어 관리 · 디렉토리 구조

보안백업RAG

☁️ 클라우드 배포 설치법

24시간Oracle FreeCloudflare

📊 6개 대시보드

OpenWebUI · AI 전화비서 · Telegram 봇 관리 · Browser Agent API · Qdrant DB · RAG API 문서 — 포트·접속법·기능 정리

:3000:5000:8445:8001:6333:8000

이 페이지(시작하기) 아래에는 시스템 구성 · 요구사항 · 서버 초기 설정이 이어집니다. 처음 설치하신다면 위에서부터 순서대로 진행하세요.

OVERVIEW

📋시스템 구성

사용자 → OpenWebUI (:3000) / Telegram Bot (:8443)
    ↓
  OpenWebUI (:3000) → AI 모델 (Groq / OpenAI / Claude / Gemini)
    ├→ 🤖 Browser Agent (:8001) → Chromium → 웹사이트
    ├→ 📞 Twilio Bot (:5000) → 전화 걸기/받기/SMS
    ├→ 🧠 메모리/학습 → 브라우저 작업 시 사용자 정보 자동 기억
    ├→ 📁 파일 접근 → ~/ai-share 읽기/쓰기
    ├→ 📅 캘린더 → 채팅·전화·텔레그램·브라우저에서 일정 조회·등록·수정·삭제(알림·설명 포함, 전화·문자 알림 자동 연동)
    └→ 💾 Qdrant (:6333) → RAG 벡터 DB

🆕 두 가지 운영 모드

모드	설치 스크립트	모르는 번호가 전화하면
개인용	`start-openwebui-hardened-admin-only.sh`	차단 (등록된 관리자만)
고객 상담용	`start-openwebui-customer-support.sh`	AI가 상담 응대 (캘린더 등은 관리자만)

🔐 통화 인증: PIN 방식은 폐지되었습니다. 등록된 관리자 번호 기반 인증이 적용됩니다 (유출 위험이 없어 더 안전).

REQUIREMENTS

📦사전 준비

서버 최소 사양

항목	최소	권장
OS	Ubuntu 22.04	Ubuntu 24.04
CPU	2코어	4코어
RAM	4GB	8GB
디스크	20GB	40GB SSD

API 키 (미리 발급)

서비스	필수	발급
Groq API Key	권장	console.groq.com
Telegram Bot Token	필수	Telegram `@BotFather` → `/newbot`

PHASE 1

🖥️서버 초기 설정

빈 Ubuntu 서버에 SSH 접속 후 기본 환경을 구성합니다.

시스템 업데이트

sudo apt update && sudo apt upgrade -y

필수 패키지 설치

sudo apt install -y curl wget git openssl python3 python3-pip jq

일반 사용자 생성 (root로 접속한 경우)

# root로 접속한 경우에만 실행 (이미 일반 사용자면 건너뛰기)
adduser deploy
usermod -aG sudo deploy
su - deploy

Ollama 설치 (RAG 임베딩용)

Ollama는 연락처 벡터 저장(RAG 임베딩)에 사용됩니다. AI 대화는 Groq API가 처리하므로 서버 자원을 거의 사용하지 않습니다.

# Ollama 자동 설치
curl -fsSL https://ollama.ai/install.sh | sh

# 임베딩 모델 다운로드 (약 300MB)
ollama pull nomic-embed-text

# 설치 확인
ollama list
# nomic-embed-text 가 표시되면 성공

Docker 설치

# Docker 자동 설치 스크립트
curl -fsSL https://get.docker.com | sh

# 현재 사용자를 docker 그룹에 추가
sudo usermod -aG docker $USER

# ⚠️ 중요: 그룹 변경 적용을 위해 재접속
exit
# 다시 SSH 접속

Docker 설치 확인

docker --version
docker compose version
docker ps
# 에러 없이 출력되면 성공

방화벽 설정 (선택)

sudo ufw allow 22    # SSH
sudo ufw allow 80    # HTTP
sudo ufw allow 443   # HTTPS
sudo ufw --force enable

OpenWebUI + Twilio AI 전화비서 + AI 브라우저 에이전트 + Telegram 통합 설치 가이드