CLI commands
훅
openclaw hooks
에이전트 훅(/new, /reset, Gateway 시작과 같은 명령을 위한 이벤트 기반 자동화)을 관리합니다. 인수 없는 openclaw hooks는 openclaw hooks list와 동일합니다.
훅 목록 보기
openclaw hooks list [--eligible] [--json] [-v|--verbose]워크스페이스, 관리형, 추가 및 번들 디렉터리에서 발견된 훅을 나열합니다.
--eligible: 요구 사항이 충족된 훅만 표시합니다.--json: 구조화된 출력입니다.-v, --verbose: 충족되지 않은 요구 사항이 표시되는 누락 열을 포함합니다.
훅(5개 중 4개 준비됨) 준비됨: 🚀 boot-md ✓ - Gateway 시작 시 BOOT.md 실행 📎 bootstrap-extra-files ✓ - 에이전트 부트스트랩 중에 추가 워크스페이스 부트스트랩 파일 삽입 📝 command-logger ✓ - 모든 명령 이벤트를 중앙 집중식 감사 파일에 기록 💾 session-memory ✓ - /new 또는 /reset 명령이 실행되면 세션 컨텍스트를 메모리에 저장훅 정보 가져오기
openclaw hooks info <name> [--json]<name>은 훅 이름 또는 훅 키입니다(예: session-memory). 소스, 파일/핸들러 경로, 홈페이지, 이벤트 및 요구 사항별 상태(바이너리, 환경 변수, 구성, 운영 체제)를 표시합니다.
사용 가능 여부 확인
openclaw hooks check [--json]준비됨/준비되지 않음 개수 요약을 출력합니다. 준비되지 않은 훅이 있으면 차단 사유와 함께 각각 나열합니다.
훅 활성화
openclaw hooks enable <name>구성에서 hooks.internal.entries.<name>.enabled = true를 추가하거나 업데이트하고 hooks.internal.enabled 마스터 스위치도 켭니다(Gateway는 하나 이상의 내부 훅이 구성될 때까지 내부 훅 핸들러를 로드하지 않습니다). 훅이 존재하지 않거나, Plugin에서 관리하거나, 요구 사항 누락으로 사용할 수 없는 경우 실패합니다.
Plugin에서 관리하는 훅은 hooks list에 plugin:<id>로 표시되며 여기서는 활성화하거나 비활성화할 수 없습니다. 대신 해당 훅을 소유한 Plugin을 활성화하거나 비활성화하세요.
훅을 다시 로드하도록 활성화 후 Gateway를 다시 시작하세요(macOS 메뉴 막대 앱을 다시 시작하거나 개발 환경의 Gateway 프로세스를 다시 시작).
훅 비활성화
openclaw hooks disable <name>hooks.internal.entries.<name>.enabled = false로 설정합니다. 이후 Gateway를 다시 시작하세요.
훅 팩 설치 및 업데이트
openclaw plugins install <package> # 기본값은 npmopenclaw plugins install npm:<package> # npm만 사용openclaw plugins install <package> --pin # 확인된 버전 고정openclaw plugins install <path> # 로컬 디렉터리 또는 아카이브openclaw plugins install -l <path> # 복사하지 않고 로컬 디렉터리 연결 openclaw plugins update <id>openclaw plugins update --allopenclaw plugins update --dry-run훅 팩은 통합 Plugin 설치 프로그램/업데이트 프로그램을 통해 설치됩니다. 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에서).
번들 훅
| 훅 | 이벤트 | 기능 |
|---|---|---|
| boot-md | gateway:startup |
구성된 각 에이전트 범위에 대해 Gateway 시작 시 BOOT.md를 실행합니다. |
| bootstrap-extra-files | agent:bootstrap |
에이전트 부트스트랩 중에 추가 부트스트랩 파일(예: 모노레포의 AGENTS.md/TOOLS.md)을 삽입합니다. |
| command-logger | command |
명령 이벤트를 ~/.openclaw/logs/commands.log에 기록합니다. |
| compaction-notifier | session:compact:before, session:compact:after |
세션 Compaction이 시작되고 완료될 때 채팅에 알림을 표시합니다. |
| session-memory | command:new, command:reset |
/new 또는 /reset 실행 시 세션 컨텍스트를 메모리에 저장합니다. |
openclaw hooks enable <hook-name>으로 번들 훅을 활성화할 수 있습니다. 전체 세부 정보, 구성 키 및 기본값: 번들 훅.
command-logger 로그 파일
tail -n 20 ~/.openclaw/logs/commands.log # 최근 명령cat ~/.openclaw/logs/commands.log | jq . # 보기 좋게 출력grep '"action":"new"' ~/.openclaw/logs/commands.log | jq . # 작업별 필터링참고
hooks list --json,info --json,check --json은 구조화된 JSON을 표준 출력에 직접 씁니다.
