在 OpenClaw 里跑openclaw hooks list看到 boot-md、session-memory、command-logger 都 Ready新手通常以为配置就到此为止了。其实钩子 Ready 只代表本地文件和事件条件没问题关键不在钩子本身而在它们触发之后模型请求走哪条 API 通道。之前换一次供应商就要改一次模型配置后来我把 Key 统一换成 TaoToken在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建一把新 Key把 OpenClaw 的 Base URL 填成 https://taotoken.net/api网关启动、/new 会话保存、命令审计这些 Hook 事件背后的模型请求就都收敛到了同一处。下面按 OpenClaw CLI 教程的顺序从openclaw hooks list讲到 boot-md把「模型通道」和「钩子状态」一次理顺。1. openclaw hooks list 之前Hook 事件是模型的触发点1.1 gateway:startup 和 command:new 背后都有模型请求Hook 不是替代模型的调度器它是事件监听器。OpenClaw 在特定事件发生时执行对应钩子boot-md 监听 gateway:startupsession-memory 监听 command:newcommand-logger 记录每一次命令事件。钩子脚本本身是本地动作真正会消耗模型调用的是触发之后 Agent 的后续编排把 BOOT.md 注入会话需要模型理解启动指令把 /new 前后的上下文整理成摘要需要模型重新组织一轮对话。所以看到钩子 Ready只代表监听条件齐了不等于模型链路也通了。这两层经常被混在一起排查一旦模型请求发不出去很多人会误以为是钩子配置坏了反复重启网关浪费时间。1.2 用 openclaw hooks list 看本机钩子openclaw hooks list输出示例Hooks (4/4 ready) Ready: boot-md Run BOOT.md on gateway startup bootstrap-extra-files Inject extra workspace bootstrap files during agent bootstrap command-logger Log all command events to a centralized audit file session-memory Save session context to memory when /new command is issued想看得更细加--verbose会列出每个钩子当前缺少的条件加--json会把结果输出成结构化 JSON方便脚本解析。注意这里显示的 Ready 只表示本地条件齐了它不会替你去验证模型 API。很多人看到 4/4 ready 就放心重启网关结果 boot-md 该执行却没执行日志里也没有模型调用记录最后翻出来是模型配置里 Base URL 指错了地方。所以开钩子之前先把模型通道固定好。2. 准备一条统一 API 通道TaoToken Key 与 OpenClaw Base URL2.1 去官网拿 Key确认模型 ID打开 TaoToken 注册在控制台创建 API Key。本文所有配置里 Key 统一用YOUR_API_KEY代替你复制自己的实际 Key 替换进去即可。模型 ID 不要从别人的截图里猜直接看 TaoToken 模型广场当时列表里准确的 ID。不同时期上架的模型会有变化列表里写什么就填什么照抄旧教程里的模型名会在请求发起时直接报错。TaoToken 在这里的角色是统一 API 兼容通道而不是某个具体的模型供应商所以它不挑模型只负责让你把地址和 Key 固定下来。2.2 把 Base URL 写进 OpenClaw 的模型配置OpenClaw 的模型配置一般在~/.openclaw/config.json的 models 段也可以用模型设置界面直接改。以 Anthropic 兼容通道为例{ models: { default: { provider: anthropic-compatible, baseUrl: https://taotoken.net/api, apiKey: YOUR_API_KEY, model: YOUR_MODEL_ID } } }如果习惯用环境变量OpenClaw 的 Anthropic 兼容通道同样读下面这套export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export ANTHROPIC_MODELYOUR_MODEL_ID注意两个地址的区别https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end是用来注册、创建 Key、看用量的操作台https://taotoken.net/api是填进 OpenClaw 的接口地址。后者不要加/v1不要带任何 UTM 参数。YOUR_MODEL_ID按模型广场列表填。提示OpenClaw 不同版本对 models 段的字段命名略有差异以你本机版本生成的 config.json 为准上面示例的核心是把 Base URL 和 Key 填对。2.3 先用普通对话验证通道再开 Hook在 TaoToken 模型对话 里用同一把 Key 发一条消息把最容易错的三个点一次性排查掉Key 是否复制完整、模型 ID 是否准确、Base URL 是否多写了/v1。这一步通过后再操作 Hook 就有一个干净的前提钩子不触发或报错时至少能排除模型通道的嫌疑。别小看这一分钟它能省掉接下来所有「钩子为什么不跑」的无效排查。3. 用 openclaw hooks check / enable / disable 管住内置钩子3.1 先看单个钩子的信息和就绪状态openclaw hooks info session-memory输出会包含事件类型command:new、配置要求workspace.dir、脚本路径和文档地址。看 info 的意义在于确认这个钩子监听哪个事件session-memory 等/newboot-md 等网关启动。事件对不上验证时就会白等。然后执行openclaw hooks check输出Hooks Status Total hooks: 4 Ready: 4 Not ready: 0加--json可以拿到结构化状态。Not ready 会指出缺了什么条件照着补即可。由插件管理的钩子在 list 里以plugin:前缀显示这类钩子不能在这里 enable / disable要去插件设置里开关。3.2 enable 之后必须重启网关才生效openclaw hooks enable session-memory命令会把hooks.internal.entries.session-memory.enabled写成 true并保存到~/.openclaw/config.json。钩子不是即时热加载的改完要重启网关macOS 上重启菜单栏应用开发环境里重启网关进程。同理openclaw hooks disable command-logger这条会关闭命令日志钩子同样需要重启。很多人开了钩子不重启然后发现hooks check显示正常但事件不执行问题往往就出在这里。3.3 安装和更新钩子包openclaw hooks install ./my-hook-pack openclaw hooks install ./my-hook-pack.zip openclaw hooks install some-org/my-hook-pack --pin openclaw hooks install -l ./my-hook-pack本地目录或归档会被复制到~/.openclaw/hooks/-l表示以链接方式挂载到本地目录而不是复制。npm 安装默认使用--ignore-scripts保证安全看到这个提示不用紧张。更新时openclaw hooks update --all openclaw hooks update --all --dry-run--dry-run可以先看要改什么再实际写入。npm 包安装后会记录解析出的精确nameversion存放在hooks.internal.installs下方便后续回溯版本。4. 内置钩子逐个过boot-md、session-memory、command-logger4.1 boot-md网关启动就要模型openclaw hooks enable boot-mdgateway:startup 事件发生后OpenClaw 会把 BOOT.md 的启动指令读出来交给 Agent。这个钩子一旦启用每次启动网关都会触发一次模型请求所以它是验证模型通道最稳定的入口启动后去控制台看有没有新增记录有记录就说明模型链路是通的。如果 BOOT.md 写得很大一次请求里塞的上下文也多模型 ID 选错时最容易在这步暴露。相反如果控制台没有记录钩子检查再多次也查不出问题因为断点在模型配置。4.2 session-memory/new 之后把会话交给模型整理openclaw hooks enable session-memory发/new命令时OpenClaw 会把本次会话的上下文交给模型整理成摘要写入~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md这是日常最容易出现问题的环节钩子状态正常但/new之后摘要文件缺失或内容残缺。原因是模型请求发出后没返回完整结果而钩子不会替你做重试。用 TaoToken 这把 Key 后模型请求统一走 https://taotoken.net/apiBase URL 不再随供应商切换而变动/new的摘要生成就稳定很多。验证时记得主动输入/new不要等它自动触发。4.3 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 本身不消耗模型额度但它是排查「模型请求到底有没有发出」的关键参照命令事件执行完模型请求才会跟上来。如果日志里命令已经记下控制台却没有调用记录说明请求在发出前就被模型配置挡住了。如果命令日志都没更新则要回头检查钩子是否 enable、网关是否重启。它记录的只是事件流不涉及生产环境操作像生成 SQL 这类动作OpenClaw 只负责产出文本执行仍然要在你自己的数据库客户端里完成再把报错贴回对话。4.4 bootstrap-extra-files注入额外引导文件openclaw hooks enable bootstrap-extra-files在 agent:bootstrap 阶段它会读取工作区里的 AGENTS.md、TOOLS.md 等额外引导文件同内置引导内容一起注入到 Agent 的启动上下文。monorepo 场景下根目录和子项目各放一份引导文件时这个钩子能把对应的那份自动带上省去手动拼接。它本身不额外调用模型但注入内容越准确后续模型请求携带的上下文越干净输出质量也越稳定。如果你的项目只有单一目录这个钩子可以不开。5. 验证一次完整的 Hook 触发链路5.1 事件、钩子、模型调用、控制台记录四件事对上重启网关后先跑openclaw hooks check openclaw hooks list --verbose确认 4 个内置钩子 ready然后在对话框输入/new主动触发 session-memory。等几秒查看 memory 目录ls -lt ~/.openclaw/workspace/memory/ | head当天日期的摘要文件出现后回到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 登录控制台在用量页面找对应时段的调用记录。完整的验证标准是事件发生了、钩子执行了、模型请求发出了、控制台账单记上了四件事全部对上。这一步能同时确认 Hook 机制和模型通道都正常之后再调别的钩子就有参照系了。5.2 排障钩子状态和模型通道分开查OpenClaw 的钩子与模型通道是两个独立层报错时先分清是哪一层钩子 Ready 但事件来了没反应多半是 enable 之后没有重启网关。重启再试。模型返回 401Key 复制不完整或没创建成功。回到控制台重新创建确认YOUR_API_KEY已完整替换。模型名报错不要照抄教程里的模型 ID以 TaoToken 模型广场当时列表为准。摘要文件生成了但内容为空模型请求发出去了但摘要生成失败。检查所选模型 ID 是否适合对话摘要任务。command-logger 有日志但控制台没有记录请求在发出前就被 Base URL 或模型配置拦截检查https://taotoken.net/api是否多写了/v1。另一个容易忽视的细节同时启用 command-logger 和 session-memory 时/new事件会先记命令日志再触发模型摘要请求。如果摘要文件没生成先回命令日志确认钩子执行了再确认模型请求是否发送。两步分开查比乱重启网关管用。6. 下一步去控制台把这次的 Hook 调用对上6.1 用同一把 Key 再发一条测试消息打开 TaoToken 模型对话 再发一条消息和刚才/new产生的摘要调用放在一起对比。两条记录都出现在用量里说明 Key 和 Base URL 的配置已经稳定钩子触发的模型请求也真实发出去了。如果只有模型对话有记录而/new没有问题一定出在 session-memory 的触发链路上回到第 5 节排查。6.2 长期自动化前确认用量档位如果准备把 OpenClaw 长期跑作自动化入口提前看一眼 Coding Plan 的用量档位避免跑批任务中途额度见底。新 Key 都在 控制台 API Keys 创建换 Key 后同步更新~/.openclaw/config.json里的 apiKey再重启网关。这样整套 Hook 事件里的模型请求就都走同一把 TaoToken Key 了。