Docs: add zh-CN translations

2026-02-01 22:47:44 +01:00
parent e70984745b
commit 149dc7c4e7
298 changed files with 53861 additions and 0 deletions
--- a/docs/zh-CN/cli/hooks.md
+++ b/docs/zh-CN/cli/hooks.md
@@ -0,0 +1,310 @@
+---
+read_when:
+  - 您想管理智能体钩子
+  - 您想安装或更新钩子
+summary: "`openclaw hooks` 的 CLI 参考（智能体钩子）"
+title: hooks
+x-i18n:
+  generated_at: "2026-02-01T19:59:18Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: e2032e61ff4b9135cb2708d92eb7889ac627b85a5fc153e3d5b84265f7bd7bc6
+  source_path: cli/hooks.md
+  workflow: 14
+---
+
+# `openclaw hooks`
+
+管理智能体钩子（用于 `/new`、`/reset` 等命令以及 Gateway 启动的事件驱动自动化）。
+
+相关内容：
+
+- 钩子：[钩子](/hooks)
+- 插件钩子：[插件](/plugin#plugin-hooks)
+
+## 列出所有钩子
+
+```bash
+openclaw 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
+```
+
+**示例（详细模式）：**
+
+```bash
+openclaw hooks list --verbose
+```
+
+显示不符合条件的钩子缺失的需求。
+
+**示例（JSON）：**
+
+```bash
+openclaw hooks list --json
+```
+
+返回结构化 JSON 以供程序化使用。
+
+## 获取钩子信息
+
+```bash
+openclaw hooks info <name>
+```
+
+显示特定钩子的详细信息。
+
+**参数：**
+
+- `<name>`：钩子名称（例如 `session-memory`）
+
+**选项：**
+
+- `--json`：以 JSON 格式输出
+
+**示例：**
+
+```bash
+openclaw hooks info session-memory
+```
+
+**输出：**
+
+```
+💾 session-memory ✓ Ready
+
+Save session context to memory when /new command is issued
+
+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/hooks#session-memory
+  Events: command:new
+
+Requirements:
+  Config: ✓ workspace.dir
+```
+
+## 检查钩子资格
+
+```bash
+openclaw hooks check
+```
+
+显示钩子资格状态摘要（就绪与未就绪的数量）。
+
+**选项：**
+
+- `--json`：以 JSON 格式输出
+
+**示例输出：**
+
+```
+Hooks Status
+
+Total hooks: 4
+Ready: 4
+Not ready: 0
+```
+
+## 启用钩子
+
+```bash
+openclaw hooks enable <name>
+```
+
+通过将特定钩子添加到配置文件（`~/.openclaw/config.json`）来启用它。
+
+**注意：** 由插件管理的钩子在 `openclaw hooks list` 中显示为 `plugin:<id>`，无法在此处启用/禁用。请改为启用/禁用对应的插件。
+
+**参数：**
+
+- `<name>`：钩子名称（例如 `session-memory`）
+
+**示例：**
+
+```bash
+openclaw hooks enable session-memory
+```
+
+**输出：**
+
+```
+✓ Enabled hook: 💾 session-memory
+```
+
+**执行操作：**
+
+- 检查钩子是否存在且符合条件
+- 在配置中更新 `hooks.internal.entries.<name>.enabled = true`
+- 将配置保存到磁盘
+
+**启用后：**
+
+- 重启 Gateway 以重新加载钩子（macOS 上重启菜单栏应用，或在开发环境中重启 Gateway 进程）。
+
+## 禁用钩子
+
+```bash
+openclaw hooks disable <name>
+```
+
+通过更新配置来禁用特定钩子。
+
+**参数：**
+
+- `<name>`：钩子名称（例如 `command-logger`）
+
+**示例：**
+
+```bash
+openclaw hooks disable command-logger
+```
+
+**输出：**
+
+```
+⏸ Disabled hook: 📝 command-logger
+```
+
+**禁用后：**
+
+- 重启 Gateway 以重新加载钩子
+
+## 安装钩子
+
+```bash
+openclaw hooks install <path-or-spec>
+```
+
+从本地文件夹/归档包或 npm 安装钩子包。
+
+**执行操作：**
+
+- 将钩子包复制到 `~/.openclaw/hooks/<id>`
+- 在 `hooks.internal.entries.*` 中启用已安装的钩子
+- 在 `hooks.internal.installs` 下记录安装信息
+
+**选项：**
+
+- `-l, --link`：链接本地目录而非复制（将其添加到 `hooks.internal.load.extraDirs`）
+
+**支持的归档格式：** `.zip`、`.tgz`、`.tar.gz`、`.tar`
+
+**示例：**
+
+```bash
+# 本地目录
+openclaw hooks install ./my-hook-pack
+
+# 本地归档包
+openclaw hooks install ./my-hook-pack.zip
+
+# NPM 包
+openclaw hooks install @openclaw/my-hook-pack
+
+# 链接本地目录而非复制
+openclaw hooks install -l ./my-hook-pack
+```
+
+## 更新钩子
+
+```bash
+openclaw hooks update <id>
+openclaw hooks update --all
+```
+
+更新已安装的钩子包（仅限 npm 安装）。
+
+**选项：**
+
+- `--all`：更新所有已跟踪的钩子包
+- `--dry-run`：显示将要更改的内容而不实际写入
+
+## 内置钩子
+
+### session-memory
+
+在您执行 `/new` 时将会话上下文保存到记忆中。
+
+**启用：**
+
+```bash
+openclaw hooks enable session-memory
+```
+
+**输出：** `~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md`
+
+**参见：** [session-memory 文档](/hooks#session-memory)
+
+### command-logger
+
+将所有命令事件记录到集中审计文件中。
+
+**启用：**
+
+```bash
+openclaw hooks enable command-logger
+```
+
+**输出：** `~/.openclaw/logs/commands.log`
+
+**查看日志：**
+
+```bash
+# 最近的命令
+tail -n 20 ~/.openclaw/logs/commands.log
+
+# 格式化输出
+cat ~/.openclaw/logs/commands.log | jq .
+
+# 按操作过滤
+grep '"action":"new"' ~/.openclaw/logs/commands.log | jq .
+```
+
+**参见：** [command-logger 文档](/hooks#command-logger)
+
+### soul-evil
+
+在清除窗口期间或随机情况下，将注入的 `SOUL.md` 内容替换为 `SOUL_EVIL.md`。
+
+**启用：**
+
+```bash
+openclaw hooks enable soul-evil
+```
+
+**参见：** [SOUL Evil 钩子](/hooks/soul-evil)
+
+### boot-md
+
+在 Gateway 启动时（渠道启动之后）运行 `BOOT.md`。
+
+**事件**：`gateway:startup`
+
+**启用**：
+
+```bash
+openclaw hooks enable boot-md
+```
+
+**参见：** [boot-md 文档](/hooks#boot-md)