Skip to main content

​
openclaw hooks

에이전트 훅을 관리합니다 (/new, /reset, 게이트웨이 시작과 같은 명령어에 대한 이벤트 기반 자동화). 관련 문서:

​
모든 훅 나열하기

워크스페이스, 관리되고 있는 디렉터리, 번들된 디렉터리에서 발견된 모든 훅을 나열합니다. 옵션:
  • --eligible: 사용 가능한 훅만 표시 (요구 사항 충족)
  • --json: JSON 형식으로 출력
  • -v, --verbose: 누락된 요구 사항을 포함한 상세한 정보 표시
예제 출력:
예제 (verbose):
사용할 수 없는 훅에 대한 누락된 요구 사항을 보여줍니다. 예제 (JSON):
프로그래밍적으로 사용할 수 있는 구조화된 JSON을 반환합니다.

​
훅 정보 가져오기

특정 훅에 대한 자세한 정보를 보여줍니다. 인수:
  • <name>: 훅 이름 (예: session-memory)
옵션:
  • --json: JSON 형식으로 출력
예제:
출력:

​
훅 자격 상태 확인하기

훅 자격 상태의 요약을 표시합니다 (준비된 훅 수 대 준비되지 않은 훅 수). 옵션:
  • --json: JSON 형식으로 출력
예제 출력:

​
훅 활성화하기

구성 파일(~/.openclaw/config.json)에 추가하여 특정 훅을 활성화합니다. 참고: 플러그인이 관리하는 훅은 openclaw hooks list에 plugin:<id>로 표시되며 여기서 활성화/비활성화할 수 없습니다. 대신 플러그인을 활성화/비활성화하십시오. 인수:
  • <name>: 훅 이름 (예: session-memory)
예제:
출력:
작동 방식:
  • 훅이 존재하고 사용 가능한지 확인
  • 구성 파일의 hooks.internal.entries.<name>.enabled = true를 업데이트
  • 구성을 디스크에 저장
활성화 후:
  • 훅이 다시 로드되도록 게이트웨이를 재시작하십시오 (macOS에서는 메뉴 바 앱을 재시작하거나 개발 환경에서는 게이트웨이 프로세스를 재시작).

​
훅 비활성화하기

구성을 업데이트하여 특정 훅을 비활성화합니다. 인수:
  • <name>: 훅 이름 (예: command-logger)
예제:
출력:
비활성화 후:
  • 훅이 다시 로드되도록 게이트웨이를 재시작하십시오

​
훅 설치하기

로컬 폴더/아카이브 또는 npm에서 훅 팩을 설치합니다. npm 사양은 레지스트리 전용입니다 (패키지 이름 + 선택적 정확한 버전 또는 dist-tag). Git/URL/파일 사양과 semver 범위는 거부됩니다. 의존성 설치는 안전성을 위해 --ignore-scripts로 실행됩니다. bare 사양과 @latest는 stable 트랙에 머뭅니다. npm이 이들 중 하나를 prerelease로 해결하면, OpenClaw는 중단하고 @beta/@rc 같은 prerelease 태그나 정확한 prerelease 버전으로 명시적으로 opt-in 하라고 요청합니다. 작동 방식:
  • 훅 팩을 ~/.openclaw/hooks/<id>에 복사
  • 설치된 훅을 hooks.internal.entries.*에서 활성화
  • 설치 기록을 hooks.internal.installs에 기록
옵션:
  • -l, --link: 복사하는 대신 로컬 디렉토리를 연결 (hooks.internal.load.extraDirs에 추가)
  • --pin: npm 설치를 hooks.internal.installs에 정확한 해결된 name@version으로 기록
지원되는 아카이브: .zip, .tgz, .tar.gz, .tar 예제:

​
훅 업데이트하기

설치된 훅 팩을 업데이트합니다 (npm 설치만 해당). 옵션:
  • --all: 추적된 모든 훅 팩 업데이트
  • --dry-run: 쓰기 없이 변경 사항 표시
저장된 무결성 해시가 존재하고 가져온 아티팩트 해시가 변경되면, OpenClaw는 경고를 출력하고 진행하기 전에 확인을 요청합니다. CI/비대화형 실행에서는 전역 --yes 플래그를 사용하여 프롬프트를 건너뛰세요.

​
번들된 훅

​
session-memory

/new 명령을 발급할 때 세션 컨텍스트를 메모리에 저장합니다. 활성화:
출력: ~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md 참조: session-memory 문서

​
bootstrap-extra-files

에이전트 부트스트랩 중 추가 부트스트랩 파일을 주입합니다 (예: 모노레포 로컬 AGENTS.md / TOOLS.md). 활성화:
참조: bootstrap-extra-files 문서

​
command-logger

모든 명령 이벤트를 중앙 집중식 감사 파일에 기록합니다. 활성화:
출력: ~/.openclaw/logs/commands.log 로그 보기:
참조: command-logger 문서

​
boot-md

게이트웨이가 시작될 때 BOOT.md를 실행합니다 (채널 시작 후). 이벤트: gateway:startup 활성화:
참조: boot-md 문서