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

1. 좌측 하단 사용자 아이콘 → 설정
2. 계정 탭 → API Keys 섹션
3. 새 API Key 생성 → 키 복사 후 안전한 곳에 저장

복사# 단축 명령어 등록 (최초 1회)
echo 'alias dashboard="docker exec twilio-bot curl -s http://127.0.0.1:5000/dashboard > /tmp/dashboard.html && explorer.exe \"$(wslpath -w /tmp/dashboard.html)\""' >> ~/.bashrc
source ~/.bashrc

# 이후부터 이것만 입력
dashboard

복사# 서버에서 토큰 확인
grep INTERNAL_API_SECRET ~/telegram-openwebui-bridge/.env

복사ssh -L 8445:localhost:8445 user@서버IP

복사http://localhost:8445/dashboard

복사# WSL2 IP 확인 후 포트포워딩 설정
$wslIP = (wsl hostname -I).Trim().Split()[0]
netsh interface portproxy add v4tov4 listenport=8445 listenaddress=127.0.0.1 connectport=8445 connectaddress=$wslIP

# 설정 확인
netsh interface portproxy show all

복사http://localhost:8445/dashboard

복사cd ~/telegram-openwebui-bridge
sed -i 's/127.0.0.1:8445:8445/0.0.0.0:8445:8445/g' docker-compose.yml
docker compose restart

복사# API Key 확인
grep BROWSER_AGENT_API_KEY ~/OpenWebUI/.env

# 헬스 체크
curl http://localhost:8001/health

# 브라우저 작업
curl -X POST http://localhost:8001/browse \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"task":"오늘 날씨 알려줘"}'

복사# 저장된 컬렉션 목록 확인
curl -s http://localhost:6333/collections

복사# Tools 서버 헬스 체크
curl -s http://localhost:8000/health

복사# 마운트된 공유 폴더 소유권을 컨테이너 사용자(1002)로 변경
sudo chown 1002:1002 /home/<사용자>/ai-share

복사# 하위 폴더(예: photos/홍길동)에도 저장한다면
# — 단, 읽기전용 마운트(recordings·reports)는 제외
sudo find /home/<사용자>/ai-share -mindepth 1 -maxdepth 1 \
    ! -name recordings ! -name reports -exec chown -R 1002:1002 {} +

복사# 소유자가 1002로 보이면 정상
docker exec openwebui-openapi-tools-1 ls -ld /app/media

복사# PDF 업로드
curl -X POST http://localhost:8000/documents/upload \
     -F "file=@문서.pdf"

# 업로드 결과 예시
# {"status":"indexed","filename":"문서.pdf","chunks":15,"total_chars":12340}

복사# 1) 파일 편집
nano ~/OpenWebUI/twilio-bot/ai_config.py

# 2) 적용 (재시작)
cd ~/OpenWebUI && docker compose restart twilio-bot

복사# 완전 무인 AI 응대 (사람 연결 모두 끔)
OPERATOR_TRANSFER_ENABLED = False
OPERATOR_VOICE_ENABLED    = False

# 음성 키워드 늘리기
OPERATOR_VOICE_KEYWORDS = ["담당자", "상담원", "직원", "사람"]

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

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

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

복사# ── 전체 백업 (업데이트 전 권장) ──
BACKUP_DIR=~/backup_$(date +%Y%m%d_%H%M%S)
mkdir -p $BACKUP_DIR

# 환경변수 + 시크릿
cp ~/OpenWebUI/.env $BACKUP_DIR/
cp -r ~/OpenWebUI/secrets/ $BACKUP_DIR/

# 연락처 + 통화기록 + 녹음 + PDF
cp -r ~/OpenWebUI/twilio-bot/data/ $BACKUP_DIR/twilio-data/

# RAG 문서 원본
cp -r ~/OpenWebUI/openapi-tools/data/ $BACKUP_DIR/rag-data/

# Docker Compose 설정
cp ~/OpenWebUI/docker-compose.yml $BACKUP_DIR/

echo "✅ 백업 완료: $BACKUP_DIR"
ls -la $BACKUP_DIR/

복사# ── 백업에서 복원 ──
BACKUP_DIR=~/backup_20260519_120000  # 백업 폴더명 확인 후 입력

# 환경변수 + 시크릿 복원
cp $BACKUP_DIR/.env ~/OpenWebUI/.env
cp -r $BACKUP_DIR/secrets/ ~/OpenWebUI/

# 데이터 복원
cp -r $BACKUP_DIR/twilio-data/ ~/OpenWebUI/twilio-bot/data/
cp -r $BACKUP_DIR/rag-data/ ~/OpenWebUI/openapi-tools/data/

# 재시작
cd ~/OpenWebUI && docker compose restart
echo "✅ 복원 완료"

복사# ── ① OS 보안 패치 ──
sudo apt update && sudo apt upgrade -y

# ── ② Docker 이미지 최신 버전 갱신 ──
cd ~/OpenWebUI && docker compose pull && docker compose up -d

# ── ③ 브라우저 에이전트 갱신 ──
cd ~/OpenWebUI && docker compose pull browser-agent && docker compose up -d browser-agent

# ── ④ Telegram 브릿지 갱신 ──
cd ~/telegram-openwebui-bridge && docker compose pull && docker compose up -d

# ── ⑤ Ollama 업데이트 ──
curl -fsSL https://ollama.ai/install.sh | sh

# ── ⑥ 미사용 Docker 이미지 정리 (디스크 절약) ──
docker image prune -a -f

복사# ── API_SECRET 교체 (Twilio 봇 내부 인증) ──
NEW_API=$(openssl rand -hex 24)
sed -i "s/API_SECRET=.*/API_SECRET=$NEW_API/" ~/OpenWebUI/.env
cd ~/OpenWebUI && docker compose restart twilio-bot openapi-tools
echo "새 API_SECRET: $NEW_API"

# ── 관리자 번호(ADMIN_NUMBERS) 변경 — PIN은 폐지됨 ──
# 봇에게 전화 걸 수 있는 번호 목록 (쉼표로 여러 개 가능)
read -p "관리자 번호 (예: +821012345678,+821099998888): " NEW_ADMINS
sed -i "s/ADMIN_NUMBERS=.*/ADMIN_NUMBERS=$NEW_ADMINS/" ~/OpenWebUI/.env
cd ~/OpenWebUI && docker compose up -d twilio-bot

# ── Groq API 키 교체 ──
read -p "새 Groq API Key: " NEW_GROQ
sed -i "s/OPENAI_API_KEY=.*/OPENAI_API_KEY=$NEW_GROQ/" ~/OpenWebUI/.env
echo "$NEW_GROQ" > ~/OpenWebUI/secrets/groq_api_key
cd ~/OpenWebUI && docker compose restart

복사# 전체 컨테이너 상태
docker ps --format "table {{.Names}}\t{{.Status}}"

# 디스크 사용량
docker system df

# 각 서비스 헬스체크
curl -s http://localhost:3000/health          # OpenWebUI
curl -s http://localhost:8001/health          # 브라우저 에이전트
curl -s http://localhost:8444/health | jq . # Telegram 브릿지
docker exec twilio-bot curl -s http://127.0.0.1:5000/health # Twilio 봇

# 최근 에러 로그
docker logs twilio-bot --tail 20 2>&1 | grep -i "error\|fail"
docker logs browser-agent --tail 20 2>&1 | grep -i "error\|fail"