설정 레퍼런스

동기화

#

PocketHook은 개인 iCloud 계정을 사용해 기기 간에 대화와 앱 설정을 동기화합니다 — PocketHook 계정도, 서드파티 서버도 필요하지 않습니다.

iPhone, iPad, Mac에서 같은 iCloud 계정으로 로그인하면 별도의 설정 없이 모든 것이 자동으로 나타납니다. 데이터는 당신만의 개인 iCloud 데이터베이스에 남아 있으며, PocketHook 서버는 이를 절대 볼 수 없습니다.

서버 구성

#

PocketHook 서버와의 핵심 연결 설정입니다.

서버 URL

#

PocketHook이 채팅 메시지를 보내는 HTTPS 엔드포인트입니다. HTTPS URL만 허용되며, HTTP는 보안상의 이유로 거부됩니다. 서버가 수신 대기하는 기본 엔드포인트입니다.

인증 토큰

#

모든 요청의 Authorization 헤더에 담겨 전송되는 Bearer 토큰입니다. 서버는 이를 사용해 요청이 당신의 기기에서 온 것인지 검증할 수 있습니다. iOS Keychain에 안전하게 저장되며, 절대 평문으로 저장되지 않습니다.

OpenClaw 호환

#

서버가 OpenClaw 플랫폼 또는 OpenAI 호환 Chat Completions API를 사용하는 경우 활성화하세요. 활성화하면 PocketHook은 OpenAI 채팅 형식으로 메시지를 보내고 응답에서 인라인 단축어 마커([SHORTCUT:name], [DATA:{...}], [URL:...])를 해석합니다. 요청에는 x-openclaw-agent-id 헤더가 포함됩니다.

연결 테스트

#

구성된 서버에 테스트 요청을 보내는 버튼입니다. 다음을 표시합니다:

• 응답 시간 (밀리초 단위)
• 헬스 체크 결과 (활성화된 경우)
• 연결 실패 시 오류 세부 정보

서버 URL이나 인증 토큰을 변경한 후 이 버튼을 사용해 모든 것이 정상 작동하는지 확인하세요.

네트워크

#

작업 유형별로 타임아웃 동작을 세밀하게 조정합니다.

요청 타임아웃

#

PocketHook이 서버가 요청에 응답을 시작할 때까지 기다리는 시간입니다. 서버가 무거운 처리(예: AI 모델 호출)를 수행한다면 이 값을 늘리세요. 단순한 웹훅 서버라면 기본값인 5초로 대개 충분합니다.

리소스 타임아웃

#

데이터 전송을 포함해 전체 응답이 완료되기까지의 최대 시간입니다. 요청 타임아웃보다 커야 합니다. 서버가 큰 페이로드를 반환하거나 업로드 속도가 느리다면 늘리세요.

헬스 체크

#

서버 상태 모니터링을 활성화합니다. 활성화되면 PocketHook은 연결 테스트 중 헬스 체크 URL로 GET 요청을 보내고 서버가 정상이라고 보고하는지 표시합니다.

헬스 체크 URL

#

평문 true 또는 false를 반환하는 별도의 HTTPS 엔드포인트입니다. 이 URL은 연결 테스트 중 호출되어 서버가 작동 중인지 확인합니다. 메인 API 엔드포인트가 인증 뒤에 있지만 간단한 상태 확인이 필요할 때 유용합니다.

자동화

#

서버 응답으로 트리거되는 iOS 단축어를 PocketHook이 실행하는 방식을 제어합니다.

iOS 단축어

#

단축어 실행의 마스터 토글입니다. OFF일 때 PocketHook은 서버의 메시지를 계속 표시하지만 응답의 shortcut 필드는 무시합니다. 디버깅이나 자동화를 일시적으로 비활성화할 때 유용합니다.

단축어 간 지연

#

서버가 하나의 응답으로 여러 자동화를 반환할 때 연속된 단축어 실행 사이에 기다리는 시간입니다. 단축어들이 서로 의존한다면(예: 첫 번째 단축어가 만든 파일을 두 번째가 읽는 경우) 이 값을 늘리세요.

단축어 타임아웃

#

각 단축어가 완료될 때까지 PocketHook이 기다리는 최대 시간이며, 이를 초과하면 시간 초과로 간주합니다. 오래 실행되는 단축어(미디어를 처리하거나 여러 API를 호출하는 것 등)에는 최대치인 5분이 필요할 수 있습니다.

개인 UI

#

맞춤형 웹 인터페이스를 PocketHook에 직접 삽입합니다.

개인 UI

#

내장 웹 뷰가 있는 전용 탭을 표시합니다. 활성화하면 메인 내비게이션에 새 탭이 나타나 맞춤형 웹 페이지가 표시됩니다. 페이지는 즉시 표시되도록 미리 로드되며 당겨서 새로고침을 지원합니다.

개인 UI URL

#

개인 UI 탭에 표시할 URL입니다. HTTP와 HTTPS 모두 허용됩니다(HTTPS 권장). 대시보드, 관리자 패널 등 채팅과 함께 빠르게 접근하고 싶은 어떤 웹 페이지든 될 수 있습니다.

링크

#

PocketHook이 서버 응답의 URL을 처리하는 방식을 구성합니다.

링크 탭

#

메인 내비게이션에서 링크 탭을 표시하거나 숨깁니다. 활성화하면 서버 응답에서 받은 모든 URL이 저장되어 풍부한 링크 미리보기, 검색, 삭제 기능이 있는 전용 탭에 표시됩니다.

URL 자동 열기

#

활성화하면 PocketHook은 서버 응답의 URL을 기본 브라우저에서 자동으로 엽니다. 비활성화하면 URL은 여전히 링크 탭(활성화된 경우)에 저장되지만 자동으로 열리지는 않습니다.

이 설정은 의도적으로 기기별로 적용됩니다: iPhone에서는 링크가 자동으로 열리길 원하지만 Mac에서는 원하지 않을 수 있습니다. 메시지 아래 링크 칩을 탭하면 이 설정과 관계없이 항상 링크가 열립니다.

언어

#

앱과 받아쓰기 언어를 사용자화합니다.

앱 언어

#

기기 언어와 독립적으로 앱의 표시 언어를 재정의합니다. “시스템 기본값"으로 설정하면 PocketHook은 iOS 언어 설정을 따릅니다.

받아쓰기 언어

#

채팅 입력에서 음성 받아쓰기(음성-텍스트 변환)에 사용되는 언어입니다. 사용 가능한 언어:

백그라운드 작업

#

앱이 백그라운드에 있을 때도 대기 중인 작업을 주기적으로 확인합니다.

백그라운드 작업

#

백그라운드 폴링을 활성화합니다. 활성화되면 PocketHook은 폴링 URL로 주기적으로 GET 요청을 보냅니다. 응답이 true이면 앱을 열 때 가져오기 메시지를 메인 서버로 보냅니다. 대기 중인 작업을 알리려면 알림 권한이 필요합니다.

확인 간격

#

PocketHook이 백그라운드에서 폴링 URL을 확인하는 빈도입니다. 간격이 짧을수록 대기 중인 작업을 더 빨리 감지하지만 배터리를 더 많이 사용합니다. iOS는 기기 사용 패턴에 따라 실제 빈도를 조정할 수 있습니다.

폴링 URL

#

PocketHook이 설정된 간격으로 폴링하는 HTTPS 엔드포인트입니다. 평문 true(작업 대기 중) 또는 false(작업 없음)를 반환해야 합니다. 이것은 가벼운 확인입니다 — 서버는 무거운 처리 없이 빠르게 응답해야 합니다.

Agent Server: https://your-host/jobs를 사용하세요(호스트와 포트는 당신의 구성에 맞게 조정하세요).

가져오기 메시지

#

백그라운드 확인에서 대기 중인 작업이 발견되고 앱이 열릴 때 메인 서버로 전송되는 메시지입니다. 서버 응답은 다른 메시지처럼 채팅에 나타납니다. 서버 측에서 특정 동작을 트리거하도록 이를 사용자화하세요.

데이터 관리

#

저장된 메시지를 모니터링하고 관리합니다.

저장된 메시지

#

현재 저장된 메시지 수를 표시합니다. 표시기는 색상으로 구분됩니다:

• 초록 — 용량의 70% 미만
• 주황 — 용량의 70–90%
• 빨강 — 용량의 90% 초과

500개 메시지 한도에 도달하면 새 메시지를 위한 공간을 만들기 위해 가장 오래된 메시지가 자동으로 삭제됩니다.

대화 내보내기

#

저장된 모든 메시지를 iOS 공유 시트를 통해 JSON 파일로 내보내는 버튼입니다. 파일을 저장하거나, AirDrop으로 보내거나, 어떤 앱과도 공유할 수 있습니다. 대화를 백업하거나 메시지 기록을 분석할 때 유용합니다.

모든 메시지 삭제

#

저장된 모든 메시지를 영구적으로 제거하는 파괴적 버튼입니다. 실행 전 확인이 필요합니다. 이 작업은 되돌릴 수 없습니다.

정보

#

PocketHook 설치에 대한 읽기 전용 정보입니다.