hansjone/oclaw
1
0
Fork 0
mirror of https://github.com/hansjone/oclaw.git synced 2026-10-10 02:30:46 +08:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
oclaw/hooks
History
oliver ba3836f00f 初始化：独立 oclaw 仓库首提交 
- 在 oclaw/ 下重新初始化 Git 仓库
- 补齐子仓库 .gitignore，避免提交本地运行态数据（_local、node_modules、logs 等）
- 提交当前工程代码与配置

Made-with: Cursor
2026-04-24 22:31:22 +08:00
..
bundled 初始化：独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
__init__.py 初始化：独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
_selftest.py 初始化：独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
frontmatter.py 初始化：独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
internal_hooks.py 初始化：独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
loader.py 初始化：独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
policy.py 初始化：独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
README.md 初始化：独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
workspace.py 初始化：独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00

README.md

oclaw/hooks

Unified Python hooks runtime and hook packages.

What you get

  • In-process hook bus: register on type or type:action, sync/async handlers, isolated failures.
  • Directory discovery: finds hooks by HOOK.md + handler.py (or index.py).
  • Config gating: supports hooks.internal.enabled and hooks.internal.entries.<hookKey>.enabled.
  • Source precedence: bundled / managed / workspace collision resolution.

Hook layout

Put hooks in any of:

  • Bundled: oclaw/hooks/bundled/<hookName>/
  • Managed: ~/.openclaw/hooks/<hookName>/
  • Workspace: <workspace>/hooks/<hookName>/ (explicit opt-in by default)

Each hook directory must contain:

  • HOOK.md with YAML frontmatter including metadata.openclaw.events
  • handler.py (or index.py) exporting a callable handle(event)

Minimal self-test

python "oclaw/hooks/_selftest.py"