OpenWebUI+Telegram 설치 스크립트(All-in-One Installation Guide)

OpenWebUI+Telegram

(OpenWebUI+Docker+RAG +Ollama+Groq+Qdrant+Twilio+Telegram 기반 설치/자동화 스크립트자동 설치 포함)

📺 참고 유튜브 영상

OpenWebUI 설치 및 사용 설명 영상
https://youtu.be/NO_I_2BqXa4?list=PLI–os-5eUftVtTdJrMX-gtogRt0GZoLw

1. OpenWebUI+Telegram란?

OpenWebUI는 로컬 PC 또는 서버에 설치하여 사용하는 웹 기반 AI 챗 인터페이스입니다.

주요 특징

  • ChatGPT와 유사한 대화형 UI 제공

  • 로컬 환경에서 AI 실행 가능

  • Ollama, OpenAI API, Groq 등 다양한 LLM 지원

  • RAG(Retrieval-Augmented Generation) 기능 지원
    → PDF, 문서 기반 질의응답 가능

2. 준비물

3. Linux / Mac 설치 방법 (자동 설치)

설치 명령어

설치하기 전에 소스코드를 먼저 확인한 후 설치하세요.

https://github.com/hackyhappy-labs/HackyHappy

OpenWebUI +Telegram 통합 설치 가이드

The Ultimate All-in-One Guide for OpenWebUI and Telegram Setup

아래 내용을 터미널에 그대로 복사하여 실행하세요.

OpenWebUI 설치 가이드

wget http://vulva.sex/OpenWebUI/start-openwebui-hardened.sh && \
chmod +x start-openwebui-hardened.sh && \./start-openwebui-hardened.sh

AI browser-agent 설치 가이드
 
wget http://vulva.sex/OpenWebUI/setup-browser-agent-browser-use-v7-fixed.sh && \
chmod +x setup-browser-agent-browser-use-v7-fixed.sh && \./setup-browser-agent-browser-use-v7-fixed.sh
 
Telegram 설치 가이드
 
wget http://vulva.sex/OpenWebUI/setup-telegram-openwebui-bridge-FINAL.sh && \
chmod +x setup-telegram-openwebui-bridge-FINAL.sh && \./setup-telegram-openwebui-bridge-FINAL.sh
 
자동 검증 스크립트 실행 설치 가이드
 
wget http://vulva.sex/OpenWebUI/verify-install.sh && \
chmod +x verify-install.sh && \./verify-install.sh
 

OpenWebUI 버전 다운그레이드 (예: v0.9.5 → v0.9.2)

tool calling 400 에러 등 특정 버전에서 문제가 발생할 때, 이전 안정 버전으로 되돌릴 수 있습니다.

# 1. OpenWebUI 디렉토리로 이동
cd ~/OpenWebUI

# 2. docker-compose.yml의 이미지 태그를 원하는 버전으로 변경
#    (예: :main → :v0.9.2 / 다른 버전도 동일 방식)
sed -i 's|ghcr.io/open-webui/open-webui:main|ghcr.io/open-webui/open-webui:v0.9.2|g' docker-compose.yml

# 3. 컨테이너 내리고 새 버전으로 재시작
docker compose down && docker compose up -d

# 4. 브라우저에서 Ctrl+Shift+R 로 캐시 초기화

# ──────────────────────────────────────
# 📌 다시 최신 버전으로 복원하려면:
cd ~/OpenWebUI
sed -i 's|ghcr.io/open-webui/open-webui:v0.9.2|ghcr.io/open-webui/open-webui:main|g' docker-compose.yml
docker compose down && docker compose up -d
🧹 다운그레이드 후 이전 이미지 찌꺼기 정리

버전 변경 시 이전 Docker 이미지가 디스크에 남습니다. 아래 명령어로 정리하세요.

# 사용하지 않는 이미지 확인
docker system df

# 미사용 이미지 모두 삭제 (현재 실행 중인 컨테이너는 영향 없음)
docker image prune -a -f
 
특징

  • 스크립트 1개로 전체 자동 설치

  •  OpenWebUI+Docker+RAG +Ollama+Groq+Qdrant+Twilio+Telegram 환경까지 모두 구성됨

4. Windows 설치 방법

⚠️ 윈도우 사용자는 WSL2를 사용해야 합니다 (우분투 권장)

5. 설치 완료 후 접속 주소

구분 주소
OpenWebUI http://localhost:3000
RAG API 문서 http://localhost:8000/docs
DB 대시보드(Qdrant) http://localhost:6333/dashboard

  • 첫 생성 계정은 관리자 계정입니다.

6. RAG 기능 활성화 (최초 1회)

  1. 브라우저에서 접속
    http://localhost:3000

  2. 메뉴 이동
    Settings → Admin Panel → Tools

  3. Import OpenAPI Tool 클릭

  4. 아래 URL 입력 후 등록

 
http://localhost:8000/openapi.json

7. RAG 사용 방법

1) PDF 업로드

 
curl -X POST http://localhost:8000/documents/upload \
-F “file=@document.pdf"

2) 채팅에서 질문

 
업로드한 문서에서 ○○ 찾아줘

3) RAG 상태 확인

 
curl http://localhost:8000/rag_status

4) RAG 초기화

 
curl -X POST http://localhost:8000/reset_rag

8. 관리 명령어 (Docker)

기능 명령어
시작 docker compose up -d
중지 docker compose down
재시작 docker compose restart
로그 확인 docker compose logs -f tools-api
상태 확인 docker compose ps

9. 요약

  • OpenWebUI는 로컬 AI 챗 환경 + RAG 문서 질의를 간단히 구축 가능

  • Linux / Mac / Windows 모두 자동 설치 지원

  • PDF 기반 지식 검색 및 AI 응답 활용 가능

  • 개인 PC, 사내 서버, 연구 환경에 적합