`moltbot hooks`
适用范围
使用本页面当：
- 需要管理 agent 钩子
- 需要安装或更新钩子
管理 agent 钩子（针对 /new、/reset 等命令和网关启动的事件驱动自动化）。
相关：
列出所有钩子
moltbot hooks list从工作区、托管和捆绑目录列出所有发现的钩子。
选项：
--eligible: 仅显示符合条件的钩子（要求已满足）--json: 以 JSON 格式输出-v, --verbose: 显示详细信息，包括缺失的要求
示例输出：
Hooks (4/4 ready)
Ready:
🚀 boot-md ✓ - Run BOOT.md on gateway startup
📝 command-logger ✓ - Log all command events to a centralized audit file
💾 session-memory ✓ - Save session context to memory when /new command is issued
😈 soul-evil ✓ - Swap injected SOUL content during a purge window or by random chance示例（详细）：
moltbot hooks list --verbose显示不符合条件的钩子的缺失要求。
示例（JSON）：
moltbot hooks list --json返回结构化 JSON 供程序化使用。
获取钩子信息
moltbot hooks info <name>显示特定钩子的详细信息。
参数：
<name>: 钩子名称（例如session-memory）
选项：
--json: 以 JSON 格式输出
示例：
moltbot hooks info session-memory输出：
💾 session-memory ✓ Ready
Save session context to memory when /new command is issued
Details:
Source: moltbot-bundled
Path: /path/to/moltbot/hooks/bundled/session-memory/HOOK.md
Handler: /path/to/moltbot/hooks/bundled/session-memory/handler.ts
Homepage: https://docs.clawd.bot/hooks#session-memory
Events: command:new
Requirements:
Config: ✓ workspace.dir检查钩子资格
moltbot hooks check显示钩子资格状态摘要（有多少已准备好 vs 未准备好）。
选项：
--json: 以 JSON 格式输出
示例输出：
Hooks Status
Total hooks: 4
Ready: 4
Not ready: 0启用钩子
moltbot hooks enable <name>通过将钩子添加到配置（~/.moltbot/config.json）来启用特定钩子。
注意： 插件管理的钩子在 moltbot hooks list 中显示 plugin:<id>，不能在此处启用/禁用。请改为启用/禁用插件。
参数：
<name>: 钩子名称（例如session-memory）
示例：
moltbot hooks enable session-memory输出：
✓ Enabled hook: 💾 session-memory它做什么：
- 检查钩子是否存在并符合条件
- 在配置中更新
hooks.internal.entries.<name>.enabled = true - 将配置保存到磁盘
启用后：
- 重启网关以便钩子重新加载（macOS 上的菜单栏应用重启，或在开发中重启网关进程）。
禁用钩子
moltbot hooks disable <name>通过更新配置来禁用特定钩子。
参数：
<name>: 钩子名称（例如command-logger）
示例：
moltbot hooks disable command-logger输出：
⏸ Disabled hook: 📝 command-logger禁用后：
- 重启网关以便钩子重新加载
安装钩子
moltbot hooks install <path-or-spec>从本地文件夹/存档或 npm 安装钩子包。
它做什么：
- 将钩子包复制到
~/.moltbot/hooks/<id> - 在
hooks.internal.entries.*中启用已安装的钩子 - 在
hooks.internal.installs下记录安装
选项：
-l, --link: 链接本地目录而不是复制（将其添加到hooks.internal.load.extraDirs）
支持的存档： .zip、.tgz、.tar.gz、.tar
示例：
# 本地目录
moltbot hooks install ./my-hook-pack
# 本地存档
moltbot hooks install ./my-hook-pack.zip
# NPM 包
moltbot hooks install @moltbot/my-hook-pack
# 链接本地目录而不复制
moltbot hooks install -l ./my-hook-pack更新钩子
moltbot hooks update <id>
moltbot hooks update --all更新已安装的钩子包（仅 npm 安装）。
选项：
--all: 更新所有跟踪的钩子包--dry-run: 显示将要更改的内容而不写入
内置钩子
session-memory
当您发出 /new 时将会话上下文保存到内存。
启用：
moltbot hooks enable session-memory输出： ~/clawd/memory/YYYY-MM-DD-slug.md
参见： session-memory 文档)#session-memory)
command-logger
将所有命令事件记录到集中审计文件。
启用：
moltbot hooks enable command-logger输出： ~/.moltbot/logs/commands.log
查看日志：
# 最近的命令
tail -n 20 ~/.moltbot/logs/commands.log
# 美化打印
cat ~/.moltbot/logs/commands.log | jq .
# 按操作过滤
grep '"action":"new"' ~/.moltbot/logs/commands.log | jq .参见： command-logger 文档)#command-logger)
soul-evil
在清除窗口期间或随机机会时，用 SOUL_EVIL.md 交换注入的 SOUL.md 内容。
启用：
moltbot hooks enable soul-evil参见： SOUL Evil Hook)
boot-md
当网关启动时运行 BOOT.md（在频道启动后）。
事件: gateway:startup
启用：
moltbot hooks enable boot-md参见： boot-md 文档)#boot-md)