Terminal Killer

🚀 智能命令路由工具，直接执行 Shell 命令，绕过 LLM，实现终端操作的即时响应。

快速开始

当用户输入匹配命令模式时，Terminal Killer 会自动激活。无需特殊语法——只需自然地输入命令即可：

ls -la              # → 直接执行
git status          # → 直接执行  
npm install         # → 直接执行
"help me code"      # → 交由 LLM 正常处理

工作原理

检测流程

用户输入 → 命令检测器 → 决策
                                      ├── 命令 → exec（直接执行）
                                      └── 任务 → LLM（正常处理）

环境加载

Terminal Killer 在执行命令前会自动加载您的 Shell 环境：

1. 自动识别您的 Shell（zsh、bash 等）
2. 加载初始化文件（~/.zshrc、~/.bash_profile、~/.bashrc 等）
3. 继承完整 PATH —— 包括 Android SDK、Homebrew 等自定义路径
4. 保留全部环境变量 —— 所有 export VAR=value 设置均生效

这确保了 adb、kubectl、docker 等命令的行为与您在终端中完全一致！

检测规则（按顺序执行）

1. 系统内置命令 —— 对照操作系统特定的内置命令列表进行检查
2. PATH 可执行文件 —— 扫描 $PATH 中是否存在匹配的可执行文件
3. 历史记录匹配 —— 与近期 Shell 历史记录比对
4. 命令模式分析 —— 基于操作符、路径等特征进行启发式分析
5. 置信度评分 —— 综合各项信号得出最终决策

检测细节

1. 系统内置命令

将输入与当前操作系统已知的内置命令进行比对：

完整列表请参阅 references/builtins/。

2. PATH 可执行文件检查

扫描 $PATH 目录，验证首词是否为可执行文件：

# 使用 `which`（Unix）或 `Get-Command`（PowerShell）
which     # 若存在则返回路径

3. 历史记录匹配

将输入与近期 Shell 历史记录（~/.zsh_history、~/.bash_history、PowerShell 历史）进行比对：

• 完全匹配 → 高置信度
• 前缀相似 → 中等置信度
• 无匹配 → 继续后续检查

4. 命令模式分析

基于命令特征进行启发式评分：

5. 置信度阈值

分值 >= 5  → 执行（高置信度命令）
分值 3–4   → 询问（不确定，需用户确认）
分值 < 3   → 交由 LLM 处理（大概率是任务/请求）

使用方法

自动激活

满足以下任一条件时，Terminal Killer 将自动触发：

• 用户输入以动词类词汇开头
• 输入较短（通常少于 20 个词）
• 不含疑问词（what、how、why 等）

交互式命令

Terminal Killer 自动识别并处理交互式 Shell 命令：

已识别的模式：

• adb shell —— 在新终端中启动 adb shell
• ssh user@host —— 在新窗口中打开 SSH 会话
• docker exec -it container bash —— 在容器内启动 Shell
• mysql -u root -p —— 启动 MySQL 客户端
• python、node、bash —— 在新窗口中启动 REPL

行为特性：

• ✅ 自动打开新 Terminal 窗口（macOS）
• ✅ 加载完整的 Shell 环境（~/.zshrc 等）
• ✅ 主会话保持空闲，可继续执行其他任务

手动覆盖

强制执行命令：

!ls -la          # 即使置信度不足也强制执行

强制交由 LLM 处理：

?? explain git   # 即使形似命令也强制交由 LLM

安全特性

危险命令检测

自动标记潜在高危操作：

• rm -rf / 或类似破坏性模式
• sudo 命令（需显式批准）
• dd、mkfs、chmod 777
• 向可疑主机发起的网络操作
• 修改系统文件的命令

批准工作流

检测到危险命令！

命令：rm -rf ./important-folder
风险等级：HIGH —— 递归删除

[批准] [拒绝] [编辑]

审计日志

所有已执行命令均记录至：

~/.openclaw/logs/terminal-killer.log

日志格式：

{
  "timestamp": "2026-02-28T12:00:00Z",
  "command": "ls -la",
  "confidence": 8,
  "execution_time_ms": 45,
  "output_lines": 12,
  "status": "success"
}

配置

设置项

在您的 OpenClaw 配置中添加：

terminal-killer:
  enabled: true
  confidence_threshold: 5
  require_approval_for:
    - "rm -rf"
    - "sudo"
    - "dd"
    - "mkfs"
  log_executions: true
  max_history_check: 100  # 检查的历史记录条目数

平台检测

自动检测操作系统并动态调整检测规则：

# 运行时自动检测
uname -s  # Darwin、Linux 等

实现细节

核心脚本

主检测逻辑见 scripts/detect-command.js。

辅助脚本

• scripts/check-path.js —— 验证 PATH 中是否存在可执行文件
• scripts/check-history.js —— 与 Shell 历史记录比对
• scripts/score-command.js —— 计算置信度得分
• scripts/safety-check.js —— 检测危险模式

测试

完整测试指南请参阅 references/TESTING.md。

快速测试：

# 运行测试套件
node scripts/test-detector.js

# 测试特定命令
node scripts/detect-command.js "ls -la"
node scripts/detect-command.js "help me write code"

限制

• 需要 Shell 访问权限（在沙箱环境中不可用）
• 历史记录检查需具备对 Shell 历史文件的读取权限
• Windows 平台需配合 PowerShell 或 WSL 才能获得完整功能
• 部分命令可能存在误报（自然语言被误判为命令）

参与贡献

如需为您的平台新增内置命令，请按以下步骤操作：

1. 编辑 references/builtins/.txt
2. 使用 scripts/test-detector.js 进行测试
3. 提交 PR，并附上平台验证信息

👤 关于作者

作者： Cosper
联系邮箱： cosperypf@163.com
许可证： MIT

📬 联系方式

对该能力感兴趣？欢迎提出建议、报告问题，或参与协作开发！

• 📧 邮箱： cosperypf@163.com
• 💡 建议反馈： 欢迎随时提出！
• 🐛 问题报告： 请注明平台、OpenClaw 版本及复现输入示例
• 🤝 协作开发： 欢迎各类贡献与改进

🙏 致谢

本项目专为 OpenClaw 社区构建。感谢所有为生态建设贡献力量的开发者！

📝 更新日志

v1.1.0（2026-02-28）

🎯 核心改进：

1. ✅ 忠实命令执行

   • 命令严格按原始输入执行
   • 不作任何修改、优化或补充
   • 原始输出完整保留（含进度条、特殊字符等）

2. 🪟 交互式 Shell 检测

   • 自动识别交互式命令（adb shell、ssh、docker exec -it 等）
   • 为交互式会话自动打开新 Terminal 窗口
   • 主会话保持空闲，支持并行任务处理
   • 完整加载 Shell 环境（~/.zshrc 等）

3. 📜 长输出处理

   • 检测输出长度是否超过 2000 字节
   • 显示前 200 字符预览
   • 提示用户在新 Terminal 窗口中查看完整输出
   • 避免长内容导致界面渲染异常

📦 更新文件：

• scripts/index.js —— 新增长输出检测与交互式命令处理逻辑
• scripts/interactive.js —— 新 Terminal 窗口启动器
• SKILL.md —— 文档更新
• README.md —— 补充使用示例
• clawhub.json —— 版本号升级至 1.1.0

v1.0.0（2026-02-28）

初始发布：

• 智能命令检测（系统内置命令、PATH、历史记录、模式分析）
• 跨平台支持（macOS/Linux/Windows）
• 环境变量加载（~/.zshrc 等）
• 危险命令检测
• 置信度评分系统

版本： 1.1.0
创建时间： 2026-02-28
最后更新： 2026-02-28