iMessage Hermes on a Raspberry Pi

1) 필요한 하드웨어 및 계정 확보: 라즈베리 파이 4 또는 5(Pi 5 권장; 4GB+ RAM, 8GB 편안함), 안정적인 전원, 그리고 가급적 이더넷을 사용하십시오. 또한 다음이 필요합니다: (a) 64비트 OS 이미지(Raspberry Pi OS Lite 64비트 / Ubuntu Server arm64 / Debian arm64), (b) LLM 제공업체 계정(Nous Portal, OpenRouter, Anthropic 등—모델은 원격으로 실행되며, Pi는 오케스트레이션합니다), (c) 실제 전화번호를 통해 iMessage/SMS/RCS를 원한다면 Claw Messenger 계정 + API 키.

2) 64비트 헤드리스 OS를 SD 카드(또는 Pi 5의 NVMe)에 플래시: Raspberry Pi Imager에서: Pi 모델을 선택하고, Raspberry Pi OS(기타) 아래에서 Raspberry Pi OS Lite (64비트)를 선택한 다음, Imager의 고급 설정에서 SSH를 활성화하고 호스트 이름/사용자/비밀번호를 설정하십시오. 64비트(aarch64)는 필수이며, 32비트(armhf)는 작동하지 않습니다.

3) Pi 부팅 및 IP 주소 찾기: Pi를 이더넷에 연결하고 전원을 켜십시오. 라우터의 DHCP 클라이언트 목록을 통해 IP를 찾거나(설정한 호스트 이름, 예: "hermespi"를 찾으십시오), LAN을 스캔하십시오(예: nmap -sn 192.168.1.0/24).

4) Pi에 SSH 접속: 컴퓨터에서: ssh <user>@<pi-ip> (또는 mDNS가 작동하면 ssh <user>@hermespi.local). 재설치 후 호스트 키 경고가 발생하면, 오래된 키를 지우십시오: ssh-keygen -R hermespi.local 및/또는 ssh-keygen -R <pi-ip>, 그리고 다시 연결하십시오.

5) (권장) Pi의 IP를 안정적으로 만들기: 가장 좋은 방법은 라우터에서 DHCP 예약을 하는 것입니다(Pi의 MAC을 고정 IP에 고정). 이렇게 하면 재부팅 후에도 항상 켜져 있는 에이전트에 접근할 수 있습니다.

6) Pi에 Hermes Agent 설치 (공식 curl 설치 프로그램): 한 줄 설치 프로그램을 실행하십시오(sudo 필요 없음): curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash. 이것은 uv(Python 관리자)를 사용하여 Hermes를 설정하고, Python 3.11을 설치하고, Hermes를 클론하고, ~/.hermes/ 아래에 uv 관리 가상 환경을 생성합니다.

7) Hermes 시작 및 기본 에이전트가 로컬에서 작동하는지 확인: Hermes CLI를 사용하여 실행되고 채팅할 수 있는지 확인하십시오. 최소한의 접근 방식을 따르는 경우, 메시징 게이트웨이를 추가하기 전에 CLI 채팅이 작동하는지 먼저 확인하십시오. (정확한 CLI 명령은 Hermes 버전에 따라 다르지만, 목표는: 에이전트가 실행되고, 프롬프트를 보낼 수 있으며, 응답을 반환하는 것입니다.)

8) LLM 제공업체 선택 및 구성: Pi의 Hermes는 일반적으로 호스팅된 LLM 제공업체(Nous Portal/OpenRouter/Anthropic 등)를 사용합니다. Hermes의 구성에서 제공업체를 구성하십시오(일반적으로 Hermes 구성 명령을 통해 또는 설정에 따라 ~/.hermes/config.yaml 및/또는 ~/.hermes/.env를 편집하여). 선택한 제공업체를 사용하여 에이전트가 응답할 수 있는지 확인하십시오.

9) Hermes venv에 iMessage 통합 플러그인 설치: uv 관리 Hermes 가상 환경에 Hermes iMessage 플러그인을 설치하십시오(시스템 pip 사용 금지): uv pip install --python ~/.hermes/hermes-agent/venv hermes-imessage. 이것은 가장 흔한 실패 지점입니다. 잘못된 Python 환경에 설치하면 Hermes가 플러그인을 로드하지 못합니다.

10) Hermes 구성에서 iMessage/Claw Messenger 플랫폼 활성화: ~/.hermes/config.yaml을 편집하여 Claw Messenger 플랫폼과 iMessage 플러그인을 활성화하십시오(기존 구성을 덮어쓰지 않고 병합해야 합니다). claw_messenger 플랫폼이 활성화되어 있고 해당 플러그인 목록에 imessage가 포함되어 있으며, 필요한 경우 플랫폼 도구 세트 매핑에 Claw Messenger 도구 세트가 포함되어야 합니다.

11) Hermes 환경에 Claw Messenger API 키 추가: Claw Messenger 대시보드에서 API 키를 가져온 다음, Hermes의 env 파일에 추가하십시오: echo 'CLAW_MESSENGER_API_KEY=cm_live_…' >> ~/.hermes/.env. env/config 변경 후 Hermes를 다시 시작하여 플러그인과 자격 증명을 다시 로드하십시오.

12) Hermes에서 Claw Messenger 도구 세트 활성화 (필요할 때 그룹을 생성할 수 있도록): Claw Messenger 도구를 Hermes에 노출하는 도구 세트를 활성화하십시오: hermes tools enable hermes-claw-messenger. 그런 다음 구성이 해당 도구 세트를 claw_messenger 플랫폼에 매핑하는지 확인하십시오(platform_toolsets: claw_messenger: - hermes-claw-messenger).

13) Hermes 게이트웨이 시작 및 메시징 채널 연결: Hermes의 게이트웨이 설정/실행기를 실행하여 구성된 플랫폼을 통해 메시지를 수신하고 보낼 수 있도록 하십시오. Hermes UI(또는 게이트웨이 설정 흐름)에서 Claw Messenger 채널을 연결/활성화하고, UI가 지원하는 경우 허용된 사용자를 제한하십시오(권장).

14) Hermes가 사용해야 할 iMessage/SMS 스레드 생성 또는 식별: 새 그룹의 chat_id를 얻으려면, 두 개 이상의 E.164 전화번호로 새 iMessage/RCS/SMS 그룹을 만들고 첫 메시지를 보내십시오. 통합은 후속 전송을 위한 chat_id를 반환합니다. 발신 DM 및 기존 그룹에 대한 답장의 경우, Hermes는 일반적으로 그룹 생성 도구 없이도 일반 메시징 흐름을 통해 라우팅할 수 있습니다.

15) 전화번호에서 테스트 메시지 전송 및 Hermes 응답 확인: 에이전트에게 간단한 메시지(예: "ping" 또는 "오늘 내 캘린더에 뭐가 있어?")를 보내십시오. 다음을 확인하십시오: (a) 수신 메시지가 Hermes에 도달하는지, (b) Hermes가 응답을 생성하는지, (c) 응답이 동일한 iMessage/SMS 스레드로 다시 전달되는지.

16) 항상 켜져 있고 재부팅에 안전하게 만들기: Hermes를 백그라운드 서비스/데몬으로 실행하십시오(또는 Docker 경로를 선택한 경우 --restart unless-stopped 옵션으로 Docker를 통해). 재부팅 후에도 작동하고 게이트웨이가 자동으로 다시 시작되는지 확인하십시오.

17) (선택 사항) 주방/냉장고에 대시보드 화면 추가: Pi를 항상 켜져 있는 에이전트로 사용하고, 별도의 항상 켜져 있는 화면/태블릿을 장착하여 "생활 대시보드"(캘린더, 날씨, 식사 계획, 요약)를 표시하십시오. 그런 다음 Hermes에게 문자 메시지를 보내 업데이트합니다("금요일 7시에 김씨네와 저녁 식사", "발표회는 언제야?") 그러면 에이전트가 대시보드를 최신 상태로 유지합니다.

18) (선택 사항) cron으로 일일 워크플로 자동화: 반복 작업(예: 매일 아침 요약)을 위해 Hermes cron 작업을 설정하십시오. hermes cron run이 게이트웨이와 별도로 실행될 때, iMessage 플러그인은 발신 메시지를 전달하기 위해 일회성 WebSocket 연결을 열고 닫을 수 있습니다.

19) 일반적인 iMessage 플러그인 문제 해결: iMessage가 작동하지 않는 경우: (a) hermes-imessage가 Hermes venv에 설치되어 있는지 확인하십시오: uv pip list --python ~/.hermes/hermes-agent/venv | grep hermes-imessage; (b) ~/.hermes/config.yaml에 올바른 플러그인 활성화 및 platform_toolsets 매핑이 포함되어 있는지 확인하십시오; (c) ~/.hermes/.env에 유효한 CLAW_MESSENGER_API_KEY가 포함되어 있는지 확인하십시오; (d) 변경 후 Hermes/게이트웨이를 다시 시작하십시오; (e) 필요한 경우, 정확한 실패 명령, 첫 번째 오류 블록, uv pip list 출력, 그리고 관련 (수정된) 구성 섹션: plugins, platform_toolsets, 및 gateway.platforms.claw_messenger.plugins를 제공하여 지원을 요청하십시오.

20) 사용자 지정 기술 및 커뮤니티 예제로 에이전트 확장: 기반을 구축하십시오: 가족 캘린더 관리, 식사 계획 + 장보기 목록, 승인 루프가 있는 Airbnb 손님 메시징, 결혼 계획 대시보드 등. 공식 사용 방법 페이지에 링크된 커뮤니티 Discord에서 다른 사람들과 공유하고 배우십시오.