메인 콘텐츠로 건너뛰기

​
openclaw hooks

에이전트 hooks를 관리합니다(/new, /reset, gateway 시작과 같은 명령을 위한 이벤트 기반 자동화). 하위 명령 없이 openclaw hooks를 실행하면 openclaw hooks list와 동일합니다. 관련 문서:

​
모든 hooks 나열

openclaw hooks list
workspace, managed, extra, bundled 디렉터리에서 검색된 모든 hooks를 나열합니다. 옵션:
  • --eligible: 적격한 hook만 표시(요구 사항 충족)
  • --json: JSON으로 출력
  • -v, --verbose: 누락된 요구 사항을 포함한 자세한 정보 표시
출력 예시: 
Hooks (4/4 ready)

Ready:
  🚀 boot-md ✓ - gateway 시작 시 BOOT.md 실행
  📎 bootstrap-extra-files ✓ - 에이전트 bootstrap 중 추가 workspace bootstrap 파일 주입
  📝 command-logger ✓ - 모든 명령 이벤트를 중앙 감사 파일에 기록
  💾 session-memory ✓ - /new 또는 /reset 명령이 실행되면 세션 컨텍스트를 메모리에 저장
예시(상세): 
openclaw hooks list --verbose
적격하지 않은 hooks에 대해 누락된 요구 사항을 표시합니다. 예시(JSON): 
openclaw hooks list --json
프로그래밍 방식으로 사용할 수 있도록 구조화된 JSON을 반환합니다.

​
Hook 정보 가져오기

openclaw hooks info <name>
특정 hook에 대한 자세한 정보를 표시합니다. 인수:
  • <name>: hook 이름 또는 hook 키(예: session-memory)
옵션:
  • --json: JSON으로 출력
예시: 
openclaw hooks info session-memory
출력: 
💾 session-memory ✓ Ready

/new 또는 /reset 명령이 실행되면 세션 컨텍스트를 메모리에 저장

Details:
  Source: openclaw-bundled
  Path: /path/to/openclaw/hooks/bundled/session-memory/HOOK.md
  Handler: /path/to/openclaw/hooks/bundled/session-memory/handler.ts
  Homepage: https://docs.openclaw.ai/automation/hooks#session-memory
  Events: command:new, command:reset

Requirements:
  Config: ✓ workspace.dir

​
Hooks 적격성 확인

openclaw hooks check
hook 적격성 상태 요약(준비 완료 개수와 미준비 개수)을 표시합니다. 옵션:
  • --json: JSON으로 출력
출력 예시: 
Hooks Status

Total hooks: 4
Ready: 4
Not ready: 0

​
Hook 활성화

openclaw hooks enable <name>
config(기본값: ~/.openclaw/openclaw.json)에 추가하여 특정 hook을 활성화합니다. 참고: workspace hooks는 여기서 또는 config에서 활성화하기 전까지 기본적으로 비활성화됩니다. plugins가 관리하는 hooks는 openclaw hooks list에서 plugin:<id>로 표시되며 여기서 활성화/비활성화할 수 없습니다. 대신 plugin 자체를 활성화/비활성화하세요. 인수:
  • <name>: hook 이름(예: session-memory)
예시: 
openclaw hooks enable session-memory
출력: 
✓ Enabled hook: 💾 session-memory
수행 내용:
  • hook이 존재하고 적격한지 확인
  • config의 hooks.internal.entries.<name>.enabled = true를 업데이트
  • config를 디스크에 저장
hook이 <workspace>/hooks/에서 온 경우, Gateway가 이를 로드하기 전에 이 옵트인 단계가 필요합니다. 활성화 후:
  • hooks가 다시 로드되도록 gateway를 재시작하세요(macOS에서는 메뉴 바 앱 재시작, 개발 환경에서는 gateway 프로세스 재시작).

​
Hook 비활성화

openclaw hooks disable <name>
config를 업데이트하여 특정 hook을 비활성화합니다. 인수:
  • <name>: hook 이름(예: command-logger)
예시: 
openclaw hooks disable command-logger
출력: 
⏸ Disabled hook: 📝 command-logger
비활성화 후:
  • hooks가 다시 로드되도록 gateway를 재시작하세요

​
참고

  • openclaw hooks list --json, info --json, check --json은 구조화된 JSON을 stdout에 직접 씁니다.
  • plugin이 관리하는 hooks는 여기서 활성화하거나 비활성화할 수 없습니다. 대신 소유 plugin을 활성화하거나 비활성화하세요.

​
Hook 팩 설치

openclaw plugins install <package>        # 먼저 ClawHub, 그다음 npm
openclaw plugins install <package> --pin  # 버전 고정
openclaw plugins install <path>           # 로컬 경로
통합 plugins 설치 프로그램을 통해 hook 팩을 설치합니다. openclaw hooks install도 호환성 별칭으로 계속 작동하지만, 지원 중단 경고를 출력하고 openclaw plugins install로 전달합니다. npm 스펙은 레지스트리 전용입니다(패키지 이름 + 선택적 정확한 버전 또는 dist-tag). Git/URL/파일 스펙과 semver 범위는 거부됩니다. 안전을 위해 종속성 설치는 --ignore-scripts로 실행됩니다. bare 스펙과 @latest는 stable 트랙을 유지합니다. npm이 이들 중 하나를 prerelease로 해석하면, OpenClaw는 중지하고 @beta/@rc 같은 prerelease 태그 또는 정확한 prerelease 버전으로 명시적으로 옵트인하라고 요청합니다. 수행 내용:
  • hook 팩을 ~/.openclaw/hooks/<id>로 복사
  • 설치된 hooks를 hooks.internal.entries.*에서 활성화
  • 설치 정보를 hooks.internal.installs에 기록
옵션:
  • -l, --link: 로컬 디렉터리를 복사하는 대신 링크합니다(hooks.internal.load.extraDirs에 추가)
  • --pin: npm 설치를 hooks.internal.installs에 정확한 해석 결과 name@version으로 기록
지원되는 아카이브: .zip, .tgz, .tar.gz, .tar 예시: 
# 로컬 디렉터리
openclaw plugins install ./my-hook-pack

# 로컬 아카이브
openclaw plugins install ./my-hook-pack.zip

# NPM 패키지
openclaw plugins install @openclaw/my-hook-pack

# 복사하지 않고 로컬 디렉터리 링크
openclaw plugins install -l ./my-hook-pack
링크된 hook 팩은 workspace hooks가 아니라 운영자가 구성한 디렉터리의 managed hooks로 취급됩니다.

​
Hook 팩 업데이트

openclaw plugins update <id>
openclaw plugins update --all
통합 plugins 업데이터를 통해 추적 중인 npm 기반 hook 팩을 업데이트합니다. openclaw hooks update도 호환성 별칭으로 계속 작동하지만, 지원 중단 경고를 출력하고 openclaw plugins update로 전달합니다. 옵션:
  • --all: 추적 중인 모든 hook 팩 업데이트
  • --dry-run: 쓰기 없이 변경 사항만 표시
저장된 무결성 해시가 존재하고 가져온 아티팩트 해시가 변경된 경우, OpenClaw는 경고를 출력하고 진행 전에 확인을 요청합니다. CI/비대화형 실행에서 프롬프트를 우회하려면 전역 --yes를 사용하세요.

​
번들 hooks

​
session-memory

/new 또는 /reset을 실행할 때 세션 컨텍스트를 메모리에 저장합니다. 활성화: 
openclaw hooks enable session-memory
출력: ~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md 참조: session-memory 문서

​
bootstrap-extra-files

agent:bootstrap 동안 추가 bootstrap 파일(예: monorepo 로컬 AGENTS.md / TOOLS.md)을 주입합니다. 활성화: 
openclaw hooks enable bootstrap-extra-files
참조: bootstrap-extra-files 문서

​
command-logger

모든 명령 이벤트를 중앙 감사 파일에 기록합니다. 활성화: 
openclaw hooks enable command-logger
출력: ~/.openclaw/logs/commands.log 로그 보기: 
# 최근 명령
tail -n 20 ~/.openclaw/logs/commands.log

# 보기 좋게 출력
cat ~/.openclaw/logs/commands.log | jq .

# 작업별 필터링
grep '"action":"new"' ~/.openclaw/logs/commands.log | jq .
참조: command-logger 문서

​
boot-md

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