2026년 OpenHuman 설치를 따라 하다 Homebrew·curl 선택, 로그인 후 빈 화면, Memory Tree 미충전, Linux AppImage 크래시에 막힌 개발자를 위해 재현 가능한 가이드를 정리했습니다. Homebrew·apt·curl·MSI 네 경로, Memory Tree와 선택 Ollama, 다섯 가지 막힘, 배포 비교표, 설치 경로표, 6단계 실습, 오류 대조표를 제공합니다. OpenClaw 병행 가이드와 함께 읽으세요. Python pip 설치는 다루지 않습니다.
01

2026 OpenHuman이란, OpenClaw·ChatGPT와 무엇이 다른가

OpenHuman은 TinyHumans AI의 GPL-3.0 데스크톱 개인 Agent입니다. Rust·Tauri v2·React 19 기반이며 Gmail·GitHub 등 118+ OAuth 연동을 UI에서 연결합니다. 대화·수집 데이터는 Memory Tree로 기기 내 SQLite에 계층 요약되고 Obsidian 호환 Markdown vault에도 기록됩니다. 20분 auto-fetch가 각 연동에서 차분을 당겨 프롬프트 없이 아침에 어제 맥락이 채워집니다.

OpenClaw는 CLI·Gateway 중심으로 Telegram 등 메시지 채널에 강하고 터미널 운영 비중이 큽니다. ChatGPT 브라우저 탭은 세션 기억에 그치며 메일·캘린더 자동 요약 Memory Tree가 없습니다. OpenHuman은 데스크톱 마스코트 UI·음성·Google Meet 참여·TokenJuice 입력 압축이 기본입니다. 모델은 관리 라우팅이 기본이나 config.toml로 Ollama 로컬 추론을 선택 활성화합니다.

본문은 동기 논쟁이 아니라 올바른 패키지 경로 설치→로그인→데이터 소스 연결→Memory Tree 첫 응답 확인까지를 다룹니다. 클린 설치 30–45분, OAuth 다중·auto-fetch 검증 포함 90분 내외를 예상하세요. 영속 데이터는 사용자 디렉터리에 모이므로 공유 Mac에서는 권한·디스크 쿼터를 선확인합니다.

관리 서비스 경계를 먼저 이해하면 롤백이 줄어듭니다. 계정·모델 라우팅·Composio OAuth 일부는 TinyHumans 백엔드를 거치지만 Memory Tree 본체와 vault 파일은 기기에 남습니다. 완전 오프라인 지향이면 Ollama와 direct Composio 키를 검토하되 실시간 트리거는 자체 호스트가 필요합니다.

01

curl 파이프만 사용: 스크립트 별도 서명 없어 변조 검출 불가. 프로덕션 macOS/Linux는 Homebrew 또는 서명 apt를 선택합니다.

02

pip·system Python 혼동: OpenHuman은 데스크톱 앱입니다. pip install 사용자 경로는 공식에 없습니다.

03

Linux AppImage+Wayland: 기동 크래시 보고 다수. Debian/Ubuntu는 .deb 또는 apt 우선합니다.

04

관리 로그인 기대 불일치: 완전 로컬만 가정하면 OAuth·모델 프록시에서 멈춥니다. 온보딩에서 경계를 확인합니다.

05

노트북 슬립: auto-fetch·Memory Tree 갱신 중단으로 Agent가 잊은 것처럼 보입니다. 상시 수집에는 상시 가동 호스트가 필요합니다.

배포면을 정한 뒤 04절 6단계로 진행하세요. 웹에 돌아도는 「Python clone + checkpoints」 구형 개요는 무시하고 공식 GitBook과 GitHub Releases만 따르세요. 다른 디지털 휴먼 학습 레포와 혼동하면 App이 뜨지 않습니다.

02

OpenHuman을 어디서 돌릴까: MacBook·VPS·월 대여 Mac Mini

OpenHuman은 Windows·macOS·Linux 네이티브 패키지를 공식 제공합니다. GUI·Memory Tree만이면 8GB RAM 최소, Ollama 7B 상시면 16GB, OpenClaw 병행 24GB 권장. vault·SQLite 성장분 포함 20GB+ 디스크를 확보하세요.

배포면7×24 가용공식 GUI 완성도auto-fetch/Memory Tree월 비용 체감
개인 MacBook덮개 닫으면 중단(~60%)macOS 최고잦은 끊김0원+운영 불안
Raspberry Pi 4B 8GB~88%Linux, Metal 없음I/O 병목하드 일시불
x86 VPS 4GB~99.5%헤드리스 GUI는 VNC수집 가능종량 과금
월 대여 Mac Mini M4DC SLA ~100%최고(launchd+UMA)연속 축적고정 OpEx, 반납 가능

대용량 Gmail·다중 SaaS 20분 수집 시 네트워크·CPU보다 디스크 I/O·SQLite 쓰기가 먼저 병목입니다. EU 외 VPS도 동작하나 OAuth 리다이렉트·모델 지연은 물리 거리 영향을 받습니다.

「항상 켜짐」과 「Metal 로컬 추론 필요 여부」를 분리해 평가하세요. 전자는 Memory Tree 갱신 주기에, 후자는 Ollama 동시 구동 여부에 영향을 줍니다. Intel Mac도 설치 가능하지만 로컬 7B 처리량은 Apple Silicon보다 낮은 경우가 많습니다. 낮에만 켜 두는 Windows 데스크톱은 야간 ingest 공백이 생깁니다. OpenClaw + OpenHuman 듀얼 스택을 쓰는 팀은 Gateway와 ingest를 서로 다른 메모리 티어 노드로 나누는 편이 16GB 단일 머신 스왑을 줄입니다.

설치는 «돌아가나»를, 플랫폼은 «Memory Tree가 얼마나 자라나»를 답합니다. 프로덕션 auto-fetch에는 전용 macOS 노드가 현실적입니다.

03

Homebrew·apt·curl·MSI: 권장 설치와 경로 비교

공식은 OS 패키지 매니저 경로를 최우선합니다. macOS:

shell
brew tap tinyhumansai/core
brew install openhuman

Debian/Ubuntu(서명 apt 저장소):

shell
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

Windows는 GitHub Releases 서명 .msi 실행. 개발용 curl(무결성 검증 없음):

shell
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
경로무결성대상 OS적합 용도
Homebrew병 해시macOS프로덕션 macOS 권장
서명 aptGPGDebian/Ubuntu amd64프로덕션 Linux 권장
MSI/DMG/deb릴리스 서명Win/macOS/Linux오프라인 배포
curl 스크립트현재 없음macOS/Linux x64빠른 검증만
npm/pnpm 소스개발자 검증전 OS기여용, 프로덕션 비권장

npm 전역 패키지는 Node 18+ 환경에 맞습니다. 첫 설치 시 플랫폼 바이너리를 받아 SHA-256으로 검증하며, 런타임은 Node에 의존하지 않습니다. 국내에서 brew·GitHub가 느리면 외부망이 안정적인 머신에 먼저 설치한 뒤 vault 디렉터리를 이전하거나, 메일 데이터센터와 가까운 리전의 클라우드 Mac을 고르세요. 업그레이드는 최초 채널과 동일하게 유지해 경로 충돌을 피하세요.

기동 후 앱 Self-Check로 Tauri 셸·로컬 DB를 확인합니다. Ollama 사용 시 ollama serve 선기동, config.toml:

toml
local_ai.runtime_enabled = true
local_ai.opt_in_confirmed = true

사내망이 GitHub raw를 차단하면 Release 자산을 내부 미러에 두고 동일 버전 MSI/deb를 배포합니다. WSL2는 Linux 디스트로 내부에서 apt를 실행하고 Windows PowerShell과 섞지 마세요.

팁: 업데이트 후 설정 누락 시 앱 migrate 또는 설정 내보내기를 확인합니다. Memory Tree SQLite는 앱 종료 중 복사하세요.

04

Memory Tree 통과 6단계: 설치부터 Ollama까지

01

경로 선택·설치: 프로덕션 macOS Homebrew, Ubuntu apt, Windows MSI. curl은 검증 환경만.

02

로그인: 앱 기동 후 TinyHumans 계정. 관리 모델 라우팅 사용 시 여기서 완료.

03

데이터 소스: Gmail·Calendar·GitHub OAuth 연결. 각 연동이 typed tool로 Agent에 노출.

04

로컬·관리 경계: Memory Tree·vault는 기기, OAuth 프록시·기본 모델은 관리측. 필요 시 direct Composio 키.

05

Memory Tree 첫 확인: auto-fetch 1사이클(~20분) 후 vault Markdown 증가·메일 제목 인용 테스트.

06

Ollama·클라우드 Mac: 선택 Ollama 7B–14B Metal. 7×24 수집은 주문 페이지 M4, VNC GUI·SSH 백업.

shell
ollama pull qwen2.5:7b
ollama serve
openhuman

클라우드 이전은 OpenClaw 병행 가이드 체크리스트로 Memory Tree SQLite·vault·config.toml 아카이브 후 rsync. 재부팅 후 auto-fetch 지속을 의도적으로 확인하세요.

OAuth 토큰을 Git에 넣지 마세요. 공유 Mac은 별도 사용자 세션·반납 전 연동 해제·로컬 DB 삭제를 운영 절차에 포함하세요.

05

요구사항·TokenJuice·오류·다음 단계

인용 가능한 세 가지: ① OpenHuman v0.53.x 최소 8GB, Ollama 상시 16GB, Dual-Stack 24GB. ② auto-fetch 20분, 청크 ~3k 토큰 이하 정규화. ③ TokenJuice로 도구 출력 토큰 최대 ~80% 압축 보고, 긴 메일 수집 지연 완화.

증상원인조치
AppImage 즉종료Wayland/sharun.deb 또는 apt
Memory Tree 공백OAuth 미완재인증·20분 대기
로컬 AI 비활성config opt-inlocal_ai.* true
Ollama 연결 실패daemon 미기동ollama serve 11434

백업: vault·SQLite를 Time Machine 또는 객체 스토리지에 주기 복사. 제거 전 앱에서 OAuth 해제·로컬 캐시 삭제로 토큰 잔류를 막으세요. 2026년 6월 기준 GitHub 스타 2만+ 규모이며 Rust 중심 코드베이스는 릴리스마다 동작이 바뀔 수 있어 프로덕션은 버전 고정·릴리스 노트 확인·업그레이드 전 스냅샷 저장을 권장합니다.

대안 정리: 슬립 MacBook은 UI 시험엔 충분하나 auto-fetch 불가. 저가 Linux VPS는 VNC 부담·Metal Ollama 불가. 브라우저 ChatGPT만은 Memory Tree·Meet 없음. KVMNODE Mac Mini M4 월 대여는 launchd·UMA로 Ollama·Memory Tree를 실어 동일 Homebrew를 SSH로 재현. 월 OpEx 30일 검증 후 구매 판단이 대용량 메일 수집 본격화 팀에 현실적입니다.

운영 리듬: 주간 vault 디스크, 월간 OAuth 토큰, 분기 config.toml 백업. SQLite·Markdown 모두 스냅샷 대상, 초기 20GB만 믿지 마세요.

요금 가격 페이지, 납품·네트워크 고객센터. 상시 수집을 CapEx 없이 시험할 준비가 되면 주문으로 당일 SSH M4를 확보하세요.