openclaw hooks
에이전트 훅(/new, /reset, Gateway 시작과 같은 명령을 위한 이벤트 기반 자동화)을 관리합니다. 인수 없는 openclaw hooks는 openclaw hooks list와 동일합니다.
관련 문서: 훅 - Plugin 훅
훅 목록 보기
--eligible: 요구 사항이 충족된 훅만 표시합니다.--json: 구조화된 출력입니다.-v, --verbose: 충족되지 않은 요구 사항이 표시되는 누락 열을 포함합니다.
훅 정보 가져오기
<name>은 훅 이름 또는 훅 키입니다(예: session-memory). 소스, 파일/핸들러 경로, 홈페이지, 이벤트 및 요구 사항별 상태(바이너리, 환경 변수, 구성, 운영 체제)를 표시합니다.
사용 가능 여부 확인
훅 활성화
hooks.internal.entries.<name>.enabled = true를 추가하거나 업데이트하고 hooks.internal.enabled 마스터 스위치도 켭니다(Gateway는 하나 이상의 내부 훅이 구성될 때까지 내부 훅 핸들러를 로드하지 않습니다). 훅이 존재하지 않거나, Plugin에서 관리하거나, 요구 사항 누락으로 사용할 수 없는 경우 실패합니다.
Plugin에서 관리하는 훅은 hooks list에 plugin:<id>로 표시되며 여기서는 활성화하거나 비활성화할 수 없습니다. 대신 해당 훅을 소유한 Plugin을 활성화하거나 비활성화하세요.
훅을 다시 로드하도록 활성화 후 Gateway를 다시 시작하세요(macOS 메뉴 막대 앱을 다시 시작하거나 개발 환경의 Gateway 프로세스를 다시 시작).
훅 비활성화
hooks.internal.entries.<name>.enabled = false로 설정합니다. 이후 Gateway를 다시 시작하세요.
훅 팩 설치 및 업데이트
openclaw hooks install / openclaw hooks update도 지원 중단된 별칭으로 계속 작동하지만, 경고를 출력하고 plugins 명령으로 전달합니다.
- Npm 사양은 레지스트리만 지원합니다. 패키지 이름과 선택적인 정확한 버전 또는 배포 태그로 구성됩니다. Git/URL/파일 사양과 시맨틱 버전 범위는 거부됩니다. 종속성 설치는 프로젝트 로컬에서
--ignore-scripts를 사용해 실행됩니다. - 한정자 없는 사양과
@latest는 안정 버전 트랙을 유지합니다. npm에서 시험판 버전으로 확인되면 OpenClaw는 중단하고 명시적으로 선택하도록 요청합니다(@beta,@rc또는 정확한 시험판 버전). - 지원되는 아카이브:
.zip,.tgz,.tar.gz,.tar. -l, --link는 로컬 디렉터리를 복사하지 않고 연결합니다(hooks.internal.load.extraDirs에 추가). 연결된 훅 팩은 워크스페이스 훅이 아니라 운영자가 구성한 디렉터리의 관리형 훅입니다.--pin은 npm 설치를 확인된 정확한name@version으로hooks.internal.installs에 기록합니다.- 설치 시 팩을
~/.openclaw/hooks/<id>로 복사하고,hooks.internal.entries.*에서 해당 훅을 활성화하며, 설치 정보를hooks.internal.installs에 기록합니다. - 저장된 무결성 해시가 가져온 아티팩트와 더 이상 일치하지 않으면 OpenClaw는 경고를 표시하고 계속 진행하기 전에 확인을 요청합니다. 확인을 생략하려면 전역
--yes를 전달하세요(예: CI에서).
번들 훅
openclaw hooks enable <hook-name>으로 번들 훅을 활성화할 수 있습니다. 전체 세부 정보, 구성 키 및 기본값: 번들 훅.
command-logger 로그 파일
참고
hooks list --json,info --json,check --json은 구조화된 JSON을 표준 출력에 직접 씁니다.