2026년 5월 TinyHumans OpenHuman이 GitHub에서 급부상했지만, 「brew vs curl|bash」「Ollama 연결」「Memory Tree 기록 여부」에서 막히는 경우가 많습니다. 본 글은 macOS·Windows·Linux에서 당일 데스크톱 Agent를 가동하기 위한 Runbook입니다. 대상: v0.56.x 데스크톱 설치 + 선택적 Ollama 로컬 추론. 산출물: 3 OS 서명 설치, 8단계 검증, 12항 오류표, 7×24 호스트 결론. 구성: 페인포인트 → 스펙표 → 8단계 → 하드 데이터 → 플랫폼 매트릭스 → FAQ. 듀얼 제품 렌탈은 OpenClaw & OpenHuman 클라우드 Mac 가이드를 참고하세요.
여전히 Python clone + requirements.txt 패턴으로 접근하는 경우가 있으나, 2026 공식 제품 형태와 불일치합니다. 메인라인은 TinyHumans의 Rust + Tauri 데스크톱(GPL-3.0)이며 GUI 우선 온보딩이 전제입니다. 실제 병목은 다음과 같습니다.
curl | bash: 원격 스크립트 실행은 보안 리스크입니다. DMG / MSI / brew / apt 서명 체인을 우선하세요.openhuman 병행 시 PATH 충돌로 「설치됐는데 실행 안 됨」 상태가 됩니다.ollama list가 비면 추론 타임아웃이 반복됩니다.OpenClaw 한 줄 비교: CLI·Gateway·Telegram/WhatsApp 채널 운영 강점 vs OpenHuman의 데스크톱 GUI·Memory Tree·118+ 연동·음성/Meet 디지털 휴먼. 본 글은 설치·검증·로컬 모델 연결에 한정합니다. 듀얼 비교는 클라우드 Mac 듀얼 Agent 글을 보세요.
OpenHuman 초기 Beta(2026.5–6)는 일반 채팅 클라이언트보다 리소스 요구가 높습니다. 로컬 vault·선택 Ollama·화면 인텔리전스 캐시를 예약하세요. 표는 「클라우드 라우팅만」과 「로컬 13B + Memory Tree」 2티어입니다.
| 항목 | 최소(클라우드 모델) | 권장(로컬 Ollama + 연동) |
|---|---|---|
| OS | macOS 12+·Win10 22H2+·Ubuntu 20.04+ | macOS 14+(Apple Silicon)/Win11/Ubuntu 24.04 |
| CPU/칩 | 4코어 x86_64 또는 Apple M1 | Apple M4/M4 Pro(UMA는 Ollama에 유리) |
| 메모리 | 8 GB | 16 GB(13B Q4); 70B급은 64 GB+ 또는 클라우드만 |
| 디스크 | 5 GB(앱+vault 초기) | 40 GB+(Ollama 모델+로그+연동 캐시) |
| GPU | 전용 GPU 불필요(API) | NVIDIA 선택; Apple Silicon은 Ollama→Metal |
| 네트워크 | 구독 라우트·OAuth 도달 | 저지연 안정; 대형 모델 첫 pull은 DC급 대역 권장 |
보안: 프로덕션은 tinyhumans.ai/openhuman 또는 GitHub Releases에서 서명 패키지를 받으세요. curl | bash는 격리 VM·일회성 테스트 머신으로 제한하세요.
macOS/Windows/Linux 공통입니다. 원격 Mac도 VNC·로컬 콘솔에서 동일합니다.
brew install ollama 또는 공식 설치 → ollama serve → ollama pull qwen2.5:7b.http://127.0.0.1:11434, pull 모델 선택 후 동일 prompt 재시도.# 권장: Homebrew tap(서명 체인) brew tap tinyhumansai/core brew install openhuman # 또는: 공식 DMG / GitHub Releases 수동 설치 # https://github.com/tinyhumansai/openhuman/releases/latest # 테스트 머신만(메인 비권장) # curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
sudo apt-get install -y --no-install-recommends gnupg2 curl ca-certificates curl -fsSL https://tinyhumansai.github.io/openhuman/apt/KEY.gpg \ | sudo gpg --dearmor -o /etc/apt/keyrings/openhuman.gpg echo "deb [signed-by=/etc/apt/keyrings/openhuman.gpg arch=amd64] \ https://tinyhumansai.github.io/openhuman/apt stable main" \ | sudo tee /etc/apt/sources.list.d/openhuman.list sudo apt-get update && sudo apt-get install -y openhuman
# 권장: 서명 .msi 다운로드 # https://github.com/tinyhumansai/openhuman/releases/latest # 테스트 머신(스크립트 사전 검토) # irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex
brew install ollama # 또는 https://ollama.com/download ollama serve # 백그라운드 유지 ollama pull qwen2.5:7b # 16GB UMA 친화 ollama list # READY 확인 # OpenHuman 설정: Local AI → http://127.0.0.1:11434
| 오류/현상 | 원인 | 조치 |
|---|---|---|
| 설치 후 실행 불가/크래시 | 경로 혼용·구버전 잔존 | 단일 경로 유지; 완전 제거 후 서명 패키지 재설치 |
| macOS 「손상됨」 | Gatekeeper 미공증 차단 | 공식/Releases만; 제3자 repack 금지 |
| 화면 인텔리전스 무반응 | 화면 녹화 미허용 | 시스템 설정→개인정보→화면 녹화→OpenHuman |
| Local AI Pending 지속 | Ollama 미기동·포트 오류 | ollama serve; URL 127.0.0.1:11434 |
connection refused(Ollama) |
FW/원격 listen만 | 11434 공인 노출 금지 |
| 추론 극저속/OOM | 모델>가용 메모리 | 7B/13B Q4 또는 클라우드 라우팅 |
| Gmail/Slack 연결 실패 | OAuth 미완·기업 정책 | 설정 마법사 재인증; 프록시 확인 |
| Memory Tree 공백 | 인덱싱 컨텍스트 미생성 | 파일/메일 태스크 1회; vault 경로 확인 |
| Meet 디지털 휴먼 무영상 | 카메라/마이크 미허용 | TCC·브라우저 확장 충돌 확인 |
| Linux GUI 없음 | 서버판(데스크톱 없음) | 데스크톱 세션 필수; 헤드리스는 OpenClaw 등 CLI |
| 업그레이드 후 설정 소실 | 사용자 디렉터리 미백업 | Application Support OpenHuman 사전 아카이브 |
| 구독 모델 429 | 라우트 레이트 리밋 | Local AI 전환·재시도; 계정 할당량 확인 |
설치는 「대화 가능」을 만듭니다. 연동 동기화 + Memory Tree 복리는 「당신을 아는」 상태를 만들며, 안정 GUI 세션·장기 온라인이 전제입니다.
| 플랫폼 | 7×24 가용성 | 로컬 Ollama | 적합 |
|---|---|---|---|
| 개인 MacBook | 덮개 닫으면 단절 | M 시리즈 Metal 최적 | POC·당일 디버그 |
| Linux 데스크톱 | 상시 가능(데스크톱 필요) | NVIDIA CUDA 유리 | 기존 GPU 워크스테이션 |
| x86 클라우드 VPS | 고가용 | 공식 GUI 경로 없음 | OpenHuman 비권장 |
| Mac Mini M4 렌탈 | DC급 온라인 | UMA+원격 VNC | Meet/화면 인텔리전스+로컬 13B 프로덕션 |
8단계를 따르면 대부분 45–90분 내 OpenHuman 데스크톱 1차 통과·Ollama 스모크가 가능합니다. 대안 한계도 명확합니다: (a) 노트북 덮개=Webhook·백그라운드 중단 (b) 데스크톱 없는 Linux=Tauri GUI 불가 (c) 자가 Mac Mini=감가·전력·7×24 소음 자부담.
Memory Tree·연동이 반복 업무를 줄인다면, 고정 월요금·SSH/VNC 10분 내 착수·퇴租 전 vault 아카이브가 필요합니다. MACCOME 전용 Mac Mini M4 클라우드는 실 Apple Silicon·brew/Ollama 완전 호환·OpenClaw 병행 2번째 상시 데스크톱에 적합합니다. 듀얼 Agent 글과 렌탈 가격에서 지역별 주문하세요.
자주 묻는 질문
터미널 설치가 필수인가요?
아닙니다. UI-first 공식 경로(DMG/MSI/brew/apt)로 터미널 없이 가능합니다. 터미널 스크립트는 자동화 테스트용입니다.
OpenClaw와 같은 Mac에 공존 가능한가요?
가능합니다. 메모리·디스크(Ollama+OpenClaw Gateway)를 확인하세요. 7×24 데스크톱+CLI 병행 시 전용 렌탈 노드 또는 32GB 권장합니다.
M2/M3/M4 차이는?
모두 지원. 로컬 Ollama 처리량은 UMA에 거의 비례. 16GB에서 13B Q4 안정, 더 큰 모델은 증설 또는 클라우드 라우팅.
퇴租 전 OpenHuman 데이터 이전?
macOS Application Support OpenHuman + Obsidian vault 경로를 아카이브하세요. MACCOME 퇴租 전 셀프 클린 지원. 고객 센터 참고.