• 人工智能
• AI Agent
• 大模型
• Agent 记忆
• LLM 网关

EdgeClaw ClawXTool 是 EdgeClaw（基于 OpenClaw 的边缘云协同个人 AI 助手）内置的聚合扩展插件，一个插件打包了 8 大工具模块、共计 13 个 AI 可调用的工具，覆盖 Shell 命令安全审计、凭据泄露扫描、Git worktree 实验分支、多任务依赖管理等场景，让个人 AI 助手开箱即用地拥有安全护栏与完整开发工作流。

八模块十三工具：ClawXTool 功能清单速览

插件入口与注册逻辑集中在 extensions/clawxtool/index.ts，模块声明见 openclaw.plugin.json。

8 大核心模块详解

1. Ask User：让助手"做选择题"而不是瞎猜

ask_user_question向用户呈现一道带选项的结构化问题（至少 2 个选项），支持多选（allow_multiple）与超时控制（默认 120 秒，可通过askUser.defaultTimeoutMs配置）。当答案集合是已知的，选择题永远比自由文本问答更可靠——用户只需点一下，AI 立即拿到标准答案。

2. Bash Security：命令执行前的安全审计

这是 ClawXTool 的双保险设计：

• 钩子模式（被动拦截）：任何 shell 类工具（exec/shell/terminal/bash等）被调用前，自动对命令做安全分级。判定为dangerous的直接拦截并说明原因，needs_approval的则弹出审批请求。
• 工具模式（主动预检）：bash_analyze允许在执行前手动审查一条命令，返回安全等级（safe / needs_approval / dangerous / unknown）与详细理由。

分级引擎 src/classifier.ts 综合三类规则：用户自定义alwaysBlock黑名单（最高优先级）、autoApprove白名单，以及内置命令模式库 + 启发式分析；管道链命令会被拆开逐段分析。

3. Cron Parser：定时任务时间不再"心算"

cron_parse接收标准 5 段 cron 表达式，支持*、范围（1-5）、步长（*/10）、列表（1,3,5）等常见写法，输出人类可读描述 + 未来 N 次（默认 5 次，上限 50 次）的具体执行时间。配置定时任务时，AI 不再需要靠模型"脑补"下次运行时间，实现代码见 src/cron-parser.ts。

4. Git Worktree：实验性改动不碰主分支

3 个工具组成完整的 worktree 生命周期：

• worktree_create：为实验分支创建独立 worktree（独立分支 + 独立目录），主工作区原样保留；
• worktree_list：列出所有 worktree、分支与 HEAD；
• worktree_exit：退出时二选一——keep保留分支并输出变更摘要，discard强制删除。

worktree 数量默认上限 5 个（gitWorktree.maxWorktrees），防止 AI "开分支开上瘾"。适合让 AI 做实验性重构：搞砸了直接丢弃，主目录毫发无伤。

5. Memory Age：给记忆打上"时间保鲜标"

这是 ClawXTool 中唯一不注册工具的模块，纯靠钩子工作：

• 在系统提示末尾追加"记忆新鲜度指南"，告知模型五级时效标准：fresh（<1 小时）、recent（<24 小时）、aging（<7 天）、old、stale；
• 记忆工具返回的每条带时间戳的条目会被自动标注如[3d ago]，超过staleDays（默认 30 天）的旧条目还会加 ⚠️ 前缀。

标注逻辑在 src/annotate.ts，有效减少 AI 把过时记忆当作事实引用的问题。

6. Notebook Edit：直接读写 Jupyter 笔记本

• notebook_read：读取.ipynb文件并按单元展示内容，可指定cell_index只读某个单元格；
• notebook_edit：按单元索引改写 source，支持 code / markdown / raw 三种 cell 类型，还可通过create_if_missing在文件不存在时自动创建。

和数据类 AI 协作时，不再需要手工拆改 JSON 格式的笔记本文件。

7. Secret Scanner：凭据泄露的最后一道防线

内置规则库覆盖 AWS、GitHub、OpenAI、Anthropic、Google、Slack、Stripe 等主流平台的 Key/Token 形态（见 src/secret-patterns.ts）。除了主动调用secret_scan扫描任意文本外，更关键的是两道被动拦截钩子：

• message_sending：消息出站前扫描，命中默认action: block直接取消发送；
• before_tool_call：工具调用参数中若含疑似密钥同样拦截。

还支持通过secretScanner.customPatterns（id + 正则 + 描述）追加自定义规则，或enabledRules指定启用子集。

8. Task Manager：带依赖关系的任务跟踪

4 个工具（task_create/task_update/task_list/task_get）背后是一个带文件锁的持久化任务库（默认存于~/.openclaw/ct-task-manager/，上限 200 条，见 src/store.ts）。每个任务支持 4 种状态、优先级与blockedBy依赖链——task_get会明确告诉你是被哪些未完成任务卡住。多步骤开发工作从此有账可查，AI 执行到一半也不会"忘了进度"。

配置项速查：6 个可配置模块默认值一览

总结：对号入座选模块

• 怕 AI 乱跑危险命令 →Bash Security
• 怕把 API Key 发到聊天里 →Secret Scanner
• 想并行做实验又不敢动主干 →Git Worktree
• 想让 AI 提问像选择题一样干脆 →Ask User
• 多步骤任务怕断片 →Task Manager
• cron 时间不想心算 →Cron Parser
• 要改 Jupyter 单元格 →Notebook Edit
• 想让 AI 分清新旧记忆 →Memory Age

一个插件装下 13 个工具 + 3 道自动拦截钩子，这就是 ClawXTool 在 EdgeClaw 生态中的定位：不给 AI 加更多"能力"，而是给已有能力加"护栏"和"台账"。插件开发与配置参考 docs/plugins/building-plugins.md 与 docs/plugins/sdk-setup.md，完整源码位于 extensions/clawxtool/。

• 人工智能
• AI Agent
• 大模型
• Agent 记忆
• LLM 网关