2026 OpenHuman 설치·설정 완전 가이드:
제로부터 구동까지 및 Mac Mini 상시 호스팅 선택

OpenHuman이란? 2026년에 설치할 이유

OpenHuman은 「영상 업로드로 디지털 휴먼 생성」 Python 추론 프로젝트가 아니라 상시 데스크톱 Agent harness입니다: UI 우선으로 몇 분 안에 계정 연결과 Memory Tree 구축이 끝나고, 백그라운드에서 약 20분마다 auto-fetch가 메일/캘린더/저장소 컨텍스트를 가져온 뒤 TokenJuice로 압축해 모델 라우팅에 넘깁니다. 터미널 우선 OpenClaw·Hermes와 달리 API 설정은 줄이고 OAuth는 늘리며, 기억은 로컬 SQLite + Markdown 볼트에 둡니다.

본문은 완전 설치 골격을 따릅니다: 환경 → 서명 설치 → 첫 검수 → Ollama/연동 심화 → 호스트 선택. Hermes 완전 설치 가이드 또는 OpenClaw 프로덕션 배포를 이미 쓰고 있다면 OpenHuman을 「얼굴과 기억 트리가 있는」 데스크톱 레이어로 NodeMini 원격 Mac과 조합할 수 있습니다.

1. 01

   문제: 구식 튜토리얼의 pip install -r requirements.txt를 잘못 사용해 현재 데스크톱 배포판과 무관함.

2. 02

   문제: curl | bash만으로 설치해 스크립트 무결성을 검증하지 못함(공식이 위험 표기).

3. 03

   문제: Gmail/Notion 연결 후에도 Agent가 「기억 상실」——첫 sync 미완료 또는 vault 경로 오류.

4. 04

   문제: Linux Wayland에서 AppImage 즉시 종료(커뮤니티 issue #2463).

5. 05

   문제: 노트북 뚜껑 닫힘으로 auto-fetch와 Meet 프록시 중단.

6. 06

   본문 산출물: 서명 패키지 설치부터 Memory Tree 검수까지 6단계 체크리스트.

6단계 구현: 서명 설치 → 로그인 → 연동 → Memory Tree 검수

우선: 네이티브 패키지 / 서명 설치 패키지(권장)

# 方式 A：官网 DMG（主机器推荐，可验开发者签名）
# https://tinyhumans.ai/openhuman

# 方式 B：Homebrew（走 bottle 哈希链）
brew tap tinyhumansai/core
brew install openhuman

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

1. 01

   다운로드 및 설치: tinyhumans.ai/openhuman 또는 GitHub Releases에서 플랫폼 패키지를 받습니다. Windows는 서명 .msi입니다.

2. 02

   첫 실행: 계정 로그인을 완료합니다(기본은 OpenHuman 호스팅 모델 라우팅과 Composio OAuth 프록시. 설정에서 BYO Key 전환 가능).

3. 03

   연동 1–2개 연결: 먼저 Gmail + GitHub 또는 Notion을 권장하고 OAuth 마법사 성공 여부를 확인합니다.

4. 04

   첫 auto-fetch 대기: 약 20분 주기입니다. Memory Tree / Obsidian vault에 ≤3k token Markdown 블록이 나타나야 합니다.

5. 05

   대화로 검수: 「이번 주 캘린더와 읽지 않은 메일 요약」을 질문하고, 답이 로컬 컨텍스트를 인용하면 sync 성공입니다.

6. 06

   (선택) 로컬 모델: 설정 → Model Routing → Ollama에서 ollama serve가 실행 중인지 확인합니다(Ollama × 렌탈 Mac 가이드 참조).

자주 보는 오류 대조

인용 가능한 파라미터와 결론: OpenHuman 설치 후 호스트 선택

• 현재 버전: GitHub 릴리스 v0.56.x 전후(2026-05/06, Early Beta, API 변경 가능).
• 연동 규모: 공식 문서 118+ 서드파티 연결, 기본 Composio 호스팅 OAuth.
• 기억 아키텍처: SQLite Memory Tree + Obsidian 호환 .md 볼트, 블록당 약 ≤3k token.
• TokenJuice: 도구 출력을 압축 후 모델에 전달. 문서상 최대 약 80% token 절감(콘텐츠 유형에 따라 변동).

주말에 데스크톱 mascot만 체험한다면 로컬 설치로 충분합니다. Gmail/캘린더/저장소 컨텍스트를 매일 자동 축적하려면 뚜껑 슬립과 가정용 회선 끊김이 「몇 분 만에 사용」을 「몇 주 재입력」으로 되돌립니다. 먼저 30일 월 임대로 워크플로 검증 후 Mac Mini 자가 구매를 결정하는 것이 비용이 가장 적습니다.

저사양 VPS의 GUI 부재, 이웃 과매도, Raspberry Pi 디스크 I/O는 OpenHuman 주 전장에 맞지 않습니다——사용자에게는 「Agent가 또 나를 잊었다」로 보입니다. 안정 7×24 데스크톱 Agent, 로컬 vault, Ollama 통합 메모리가 필요한 프로덕션에서는 NodeMini Mac Mini M4 클라우드 임대가 「타협 노트북 + 수동 재시작」보다 수월한 경우가 많습니다. 기억 복리에 집중하고 새벽 OAuth 수리에서 벗어나세요.