每天打开终端第一件事不是干活而是想这个参数到底是-R还是-r。相信不少人都经历过这种时刻grep、find、awk、sed各有各的语法du、df、ps输出格式都不一样真要组合起来处理一个问题得同时唤起好几份记忆。我花了一段时间把日常高频操作收敛到一个统一入口的命令行工具里代号叫 OpenClaw核心思路是像爪子一样一把抓。这篇文章就把 OpenClaw 的常用命令、参数细节和实际踩坑记录整理出来给你一份可以照着抄的手册。适合每天要跟终端、日志、文件系统打交道的开发者和运维朋友。1. OpenClaw 到底是什么一个把高频操作收敛成统一命令的本地工具箱先说清楚OpenClaw 不是一个大型平台也不是什么需要部署一整套服务的系统。它更像是一个命令收纳盒平日里那些分散在find、grep、awk、sort、uniq、du、ps里的高频操作在 OpenClaw 里被重新组织成一组语义统一、参数简洁的子命令。你只需要记住claw这个主命令后面跟操作对象和动作就行。1.1 它解决的是工具碎片化而不是功能缺失单独看grep或者find功能一点都不弱问题出在组合上。比如我想看看某个目录下哪些文件超过 200MB、并且最近三天没动过用原生命令得写一长串find /data -type f -size 200M -mtime 3 -exec ls -lh {} \;这行命令不是不能写但每次都要在脑子里过一遍参数语义尤其-size 200M和-mtime 3的写法间隔一段时间不用就容易忘。OpenClaw 把这类场景封装成claw files stale --older-than 3d --size-min 200M参数名本身就是说明按键记忆负担小很多。它没有增加新功能只是把常用功能的入口重新设计了一遍让你想得起、敲得对。1.2 核心设计单一入口加子命令结构整个工具只暴露一个可执行文件claw通过子命令区分领域。整体结构大概是这样的claw ├── files # 文件与目录操作 ├── log # 日志分析与追踪 ├── t # 文本处理 ├── sys # 系统状态查看 └── conf # 工具自身配置每个子命令下面再挂若干个动作比如claw files stale、claw log top、claw sys disk。这样的好处是你只需要记住要找文件就进 files 区要看日志就进 log 区定位速度比在一堆零散命令里翻快得多。另外OpenClaw 保持了 Unix 工具的基本素养——输出结果永远走标准输出可以继续用管道交给less、grep、tee进一步处理。它不试图取代这些经典工具而是做它们之上的一个顺手层。1.3 典型使用场景我自己最常用的三个场景一是定时清理临时目录里超过 N 天的文件二是从访问日志里统计 Top 10 的请求路径三是检查磁盘剩余空间并生成一条带时间戳的记录。这几个操作如果全靠原生命令组合每星期都要重复回忆一遍用 OpenClaw 之后我把它们分别写成一行命令再塞进 cron脑子轻松很多。后面第 4 章会给出可直接套用的完整脚本。2. 安装到上手环境准备、配置目录与 Shell 补全OpenClaw 的使用门槛不高但有几个细节处理不好会直接影响体验比如可执行文件放哪、配置目录建在哪、如何写好补全脚本。2.1 安装方式与依赖最简单的方式是直接把编译好的claw可执行文件放到PATH能覆盖到的目录比如~/bin或者/usr/local/bin然后赋予执行权限mkdir -p ~/bin cp claw ~/bin/ chmod x ~/bin/claw如果希望所有登录用户都能用放到/usr/local/bin更合适但注意要有管理员权限。依赖方面OpenClaw 本身是静态编译的运行时不需要额外的解释器不过它内部的某些动作会调用系统自带的find、awk、rsync所以基础工具链要齐全。绝大多数 Linux 发行版默认都带了find和awkrsync可能需要单独装一下装好就不会再被调用到。2.2 配置目录与工作目录的约定OpenClaw 默认把配置文件放在~/.config/claw/下日志和临时缓存放在~/.cache/claw/。这个约定和很多现代命令行工具保持一致好处是删除工具时不会留下乱七八糟的残留文件。首次运行时工具会自动创建~/.config/claw/config.toml里面可以调整一些默认行为# 默认的日志文件路径模式支持 * 通配符 log_default_glob /var/log/app/*.log # files stale 默认的时间单位 time_unit d # 是否在输出时自动加上时间戳 auto_timestamp false我建议你花两分钟看一眼这个文件把log_default_glob改成自己项目里日志的实际路径后面claw log tail就可以不带参数直接用了省掉每次输入一长串路径的麻烦。2.3 Shell 补全让想不起来变成按两下 Tab命令记不全没关系补全脚本可以帮你兜底。OpenClaw 提供了一份补全脚本写入 shell 的 rc 文件就能启用# 以 bash 为例 echo source ~/.config/claw/completion.bash ~/.bashrc # zsh 用户 echo source ~/.config/claw/completion.zsh ~/.zshrc启用补全之后输入claw f再按 Tab会提示files输入claw files s再按 Tab会补全成stale。这个体验对新手特别友好等于把命令树做成了可探索的菜单。实际使用下来我觉得补全比记--help还快因为我不用先想清楚自己到底要问哪个选项。注意如果你把claw装完发现 Tab 补全没生效先确认 shell 是否重新加载了配置或者直接在当前会话里执行source ~/.bashrc。别急着怀疑安装路径八成是忘了这一步。3. 常用命令逐组拆解文件、日志、文本与系统状态这一章是名副其实的常用命令速查区。我不会把每个参数都列出来只挑日常使用频率最高的那些配合示例说明。想看完整列表任何时候都可以运行claw 子命令 --help。3.1 文件与目录清理、改名、按条件找文件文件操作是 OpenClaw 最被频繁使用的一组命令。核心动作有三个list、stale、rename。claw files list是增强版的目录列表默认按修改时间倒序排# 列举 /data 下最近修改的 20 个文件 claw files list /data --limit 20输出格式自带人类可读的文件大小和相对时间不用额外ls -lh转换。它的实现底层还是调用ls但帮你把排序、截断、格式化都做好了一层。claw files stale是我清理服务器临时目录最常用的命令# 找出 /tmp/build 下超过 7 天没动过的文件并显示大小 claw files stale /tmp/build --older-than 7d --size-min 1M这个命令的要点是--older-than支持10m、3h、7d这种带单位的写法符合日常语言习惯。它只负责找和列并不直接删除。想真正清理配合后面的管道命令claw files stale /tmp/build --older-than 7d --delete加上--delete后才会执行rm。安全设计上--delete总会先打印将要删除的完整路径并要求你再按一次回车确认除非额外加了--force。这个设计救过我一次某次匹配到的目录比预期多了一层。claw files rename做批量改名# 把所有 .txt 改成 .md claw files rename /docs --from .txt --to .md --dry-run先用--dry-run输出将发生的改动确认无误后再去掉这个参数真正执行。批量操作最忌讳盲目执行先跑一遍预览是基本素养。3.2 日志分析跟踪、过滤、统计 Top 序列日志场景是 OpenClaw 的另一个重头戏。claw log这一组命令在设计上刻意向tail和awk的用法靠拢让你不会有陌生感。claw log tail用来实时跟踪日志文件# 跟踪默认配置里的日志文件只显示包含 ERROR 的行 claw log tail --match ERROR它等价于tail -F加grep ERROR但--match参数支持简单的正则比如--match ERROR|WARN能同时匹配两种级别。和tail -F一样文件被轮转后也会自动跟随新文件不会断掉。claw log top是高频使用的统计命令# 统计日志中访问路径出现次数取前 10 claw log top --field 7 --limit 10--field指定按空格分隔后的第几列做分组。这个能力本质上是对awk {print $N} | sort | uniq -c | sort -rn的封装但参数更直观。需要按时间维度聚合时可以用--time-bucket 1h把日志按小时切片统计排查流量突增非常管用。claw log grep则是一个更克制的搜索工具# 在昨天的日志里找包含关键字 timeout 的行带上下文各 3 行 claw log grep timeout --since 24h --context 3它和直接grep的区别在于输出会带上文件路径和时间戳列多个日志文件混在一起时更容易定位来源。3.3 文本处理几个高频小工具文本处理这里OpenClaw 没有试图替代sed和awk而是封装了几个简单动作专门应付快速提取和格式转换。claw t cut做按分隔符取列比记awk -F的语法省心一点# 用冒号做分隔符取第 2 列和第 4 列 claw t cut /etc/passwd --delim : --fields 2,4claw t hex和claw t b64分别做十六进制和 Base64 编码解码优先从标准输入读取# 对文本做 Base64 编码 echo hello | claw t b64 --encode # 解码 echo aGVsbG8 | claw t b64 --decodeclaw t replace做简单的字符串替换默认全部替换并用颜色标出被替换的部分claw t replace old_value new_value config.txt它的正则能力和sed -E相当但调试体验好一些先执行--dry-run会直接在终端里渲染修改前后的 diff省得我在sed的-i和备份文件之间反复折腾。3.4 系统状态磁盘、内存、进程一目了然claw sys disk查看磁盘使用率默认按使用百分比倒序claw sys disk --min-usage 80只列出使用率超过 80% 的分区一眼看到危险项。输出里包含挂载点、总容量、已用、使用率、文件系统类型信息密度刚好。claw sys mem查看内存概览claw sys mem --top 5除了内存总量和可用量还会列出占用内存最多的前 5 个进程。排查内存告警时这一条命令就能当半个top用。claw sys ps是精简版进程查询按 CPU 或内存排序claw sys ps --sort cpu --limit 8它不追求覆盖ps aux的全部能力但输出里把 CPU%、内存%、启动命令三列排在一起快速扫一眼就能定位异常进程。子命令核心用途最常用参数等价于原生命令的大致写法claw files stale查找长时间未修改的文件--older-than 7dfind ... -mtime 7claw log top日志字段频率统计--field 7awk {print $7} | sort | uniq -cclaw sys disk磁盘使用率检查--min-usage 80df -h加手工排序claw sys ps进程资源排序--sort cpups aux --sort-%cpuclaw t b64Base64 编解码--encode/--decodebase644. 从单条命令到复合任务三个可直接套用的实战脚本命令单条用起来顺手真正体现价值的是把它编进脚本、挂上定时任务替代那些偶尔想起来才手动敲一遍的重复劳动。下面三个脚本都是我在实际环境中验证过的模板你可以改成自己的路径直接用。4.1 场景一清理临时目录里超过 N 天的文件构建目录里积攒的中间产物非常占空间放任不管很容易把磁盘撑爆。清理脚本长这样#!/bin/bash set -euo pipefail BUILD_DIR/tmp/build-artifacts KEEP_DAYS7 # 先统计待清理文件数量留个审计日志 claw files stale $BUILD_DIR --older-than ${KEEP_DAYS}d \ | tee -a /var/log/claw-clean.log \ | wc -l # 真正执行清理跳过确认。--force 要谨慎使用 claw files stale $BUILD_DIR --older-than ${KEEP_DAYS}d --delete --force我建议你把清理动作分成两步第一步只统计并记录第二步再删除。这样万一某天误删了东西至少审计日志里留着当时列出了哪些文件。脚本开头加上set -euo pipefail能让未定义变量和管道错误立刻暴露不至于带着问题继续往下跑。4.2 场景二从访问日志里统计 Top URL线上服务排查性能问题时经常要看某段时间内到底哪些路径被请求最多#!/bin/bash set -euo pipefail LOG_GLOB/var/log/app/access.log* OUT_FILE/tmp/url-top.txt claw log top --glob $LOG_GLOB --field 7 --limit 15 --since 24h $OUT_FILE # 顺手在控制台看一眼 cat $OUT_FILE如果你的日志格式不是标准的 Nginx access log--field的列号可能要调。先跑一条claw log grep GET / --glob $LOG_GLOB --limit 3看看输出确认路径确实在第 7 列再加统计能避免统计出空结果。用--since 24h限定时间窗口后输出会聚焦最近一天比直接统计整个日志文件更有业务参考价值。4.3 场景三磁盘用量巡检并记录到本地文件磁盘告警最好在出问题之前就发现而不是等监控平台报警再人工介入。我把巡检脚本放在 cron 里每小时跑一次#!/bin/bash set -euo pipefail STATE_FILE/var/lib/claw-disk-state.csv # 生成带时间戳的记录如果文件不存在就先写表头 if [ ! -f $STATE_FILE ]; then echo timestamp,mount,usage_percent,avail_gb $STATE_FILE fi claw sys disk --min-usage 0 \ | awk NR1 {print strftime(%Y-%m-%dT%H:%M:%S), $1, $3, $4} \ $STATE_FILE # 只看当前使用率超过 80% 的分区 claw sys disk --min-usage 80 \ | tee /tmp/disk-warning.txt这段脚本的核心思想是把每次巡检的原始数据追加到 CSV 里形成历史趋势而不仅仅是打一条告警。后面想看某个挂载点的用量变化直接对这个 CSV 做筛选就行。awk 里的strftime需要系统有gawk支持如果你的发行版默认是mawk可以改成用date命令生成时间戳。提示把 OpenClaw 脚本放到用户级 crontab 时环境变量尤其是PATH和交互式中不一样。如果claw装在~/bin下cron 可能找不到命令。最稳妥的做法是在脚本开头显式设置PATH/usr/local/bin:/usr/bin:/bin:$HOME/bin或者直接把claw的绝对路径写进变量。5. 踩过的坑与排查手法退出码、转义与权限问题工具用久了总会遇到几个不容易一眼看穿的问题。这里把我自己踩过、也帮别人排查过的几类常见坑整理出来每一个都附上问题现象和解决思路。5.1 退出码问题管道里的命令失败脚本却没报错一开始我写清理脚本时遇到过这样的现象cron 任务明明跑了磁盘还是满的日志里也没看到错误。排查后发现是管道的小陷阱claw files stale /data --older-than 7d --delete --force | grep deleted | wc -l这行命令里真正会失败的可能是第一段的claw但管道的退出码由最后一个命令wc -l决定。即使claw执行出错wc -l依然能成功返回 0于是外层脚本认为一切正常。解决方法是加set -o pipefail让管道中任何一个环节失败都算整体失败或者用中间文件把每一步拆开。现在我的所有脚本几乎都以set -euo pipefail开头算是用踩坑换来的肌肉记忆。5.2 文件名空格与通配符的转义批量改名和批量删除最容易踩的坑藏在文件名的空格里。假设目录里有文件old file.txt和old-file.txtclaw files rename /data --from old --to new两条命令都会匹配到old file.txt但如果你在脚本里用变量拼接路径再执行空格没加引号就会变成两个参数。OpenClaw 内部对文件列表的处理是逐条执行不是把整条命令交给 shell 解释所以它的rename内部不会踩这个雷但如果你把输出拿到自己的脚本里继续处理比如claw files list /data | while read f; do do_something $f; done就必须给$f加引号。另外想要只匹配精确文件名用--exact参数关闭模糊匹配否则--from log会把logical.txt也一起改掉这是我某次批量操作前预览时发现的意外。5.3 权限不足预览正常执行时报错claw files stale --delete在执行删除时是调用进程的权限去做的。如果你用普通用户运行但目标文件属于 root预览阶段一切正常列出文件不需要写权限真正删除时就会报Permission denied。OpenClaw 的删除逻辑会把失败的路径收集起来在末尾统一提示让你看是否有权限问题。这种情况下别急着上sudo。先确认你真的有权限删除这些文件再想是不是应该调整目录属主。直接sudo跑批量删除的风险在于管理员权限会把所有不可删除的保护都绕过去误操作成本瞬间放大。5.4 大目录下的性能问题小心--size-min的参数单位处理几十万文件的大目录时claw files stale会比直接在几十个文件的小目录里慢很多这很正常因为底层find本身就要遍历整个目录树。一个容易忽略的参数陷阱是--size-min 1M的语义你会不会觉得它匹配1MB 以上但有的工具设计里文件名不带后缀时的默认单位可能是 KB。OpenClaw 这里1M明确指 1 MiB但--size-min 1024这种纯数字写法会被当成字节而不是 KB。这种单位歧义在多个工具之间尤其危险。我建议你始终写带后缀的参数值比如--size-min 1M、--older-than 3d不要依赖默认单位。写清楚一步省得日后翻文档确认。5.5 时间基准--older-than 24h和--since 24h不是一回事这两个参数在 OpenClaw 里都支持但语义不同--older-than 24h以当前时间为基准找 24 小时之前修改的文件--since 24h在日志场景里指从 24 小时前到现在这个时间段内的记录。如果把它们用混很容易出现清理脚本把刚刚生成的日志当垃圾删了的事故。我也吃过这个亏。某次想把过期备份清掉顺手写了--since 30d结果它匹配的是最近 30 天的备份跟我的意图刚好相反。做任何时间窗口操作之前先跑一遍不带删除参数的预览把输出里文件的最后修改时间扫一遍确认范围对了再动手。6. 让 OpenClaw 长成自己的样子别名字命令与配置扩展OpenClaw 默认命令已经很顺手但每个人的工作流不一样。我建议你花十分钟做两件小事配置默认参数和新增别名动作把工具调成自己最顺手的样子。6.1 配置驱动的默认参数在~/.config/claw/config.toml里可以为具体子命令预设默认参数[alias.ls-big] target files list args [--sort, size, --limit, 30] [alias.glance] target sys disk args [--min-usage, 50]配置完成后claw ls-big # 等价于 claw files list --sort size --limit 30 claw glance # 等价于 claw sys disk --min-usage 50别名的价值在于把常用但参数多的操作固化下来。比如你每次都要看/var/log/myapp下的 ERROR 日志写一个claw err别名指向claw log tail --glob /var/log/myapp/*.log --match ERROR后面只需敲两个单词。6.2 自定义子命令用一段 shell 函数挂在 OpenClaw 之上有些操作不适合硬塞进配置里比如跨目录复制并压缩归档。我习惯在 shell rc 文件里定义一个函数以claw开头命名仍然保留统一入口的体验claw_backup() { local src${1:-/data} local dest${2:-/backup} rsync -a --delete $src $dest \ claw t b64 --encode backup done: $(date) /var/log/claw-backup.log }这类函数不进 OpenClaw 配置但调用方式仍然是claw_backup /data /backup对我这种喜欢所有操作从 claw 开始的人来说心智模型是统一的。6.3 接入 snippet 管理把常用命令存起来最后一个小技巧OpenClaw 的补全文件和配置都是纯文本完全可以纳入你自己的 dotfiles 仓库。我会把completion.bash、config.toml和别名配置放到版本控制里换机器时一条克隆命令就能还原整个终端环境。久而久之这个工具集就从别人写的工具变成了我自己维护的工作台。我自己最常用的一个别名是claw big它直接列出当前目录下最大的 10 个文件[alias.big] target files list args [., --sort, size, --limit, 10]每次磁盘告警我第一件事就是敲claw big十秒钟内定位大头文件。这种为自己量身定做的过程其实比工具本身更有意思——你真正需要的不是某个命令而是一套能不断沉淀自己操作习惯的工作流。 
长河君 · 2026/10/22 13:58:32 · 阅读 1.2k OpenClaw：统一高频命令行操作与日志分析的效率工具箱
每天打开终端第一件事不是干活而是想这个参数到底是-R还是-r。相信不少人都经历过这种时刻grep、find、awk、sed各有各的语法du、df、ps输出格式都不一样真要组合起来处理一个问题得同时唤起好几份记忆。我花了一段时间把日常高频操作收敛到一个统一入口的命令行工具里代号叫 OpenClaw核心思路是像爪子一样一把抓。这篇文章就把 OpenClaw 的常用命令、参数细节和实际踩坑记录整理出来给你一份可以照着抄的手册。适合每天要跟终端、日志、文件系统打交道的开发者和运维朋友。1. OpenClaw 到底是什么一个把高频操作收敛成统一命令的本地工具箱先说清楚OpenClaw 不是一个大型平台也不是什么需要部署一整套服务的系统。它更像是一个命令收纳盒平日里那些分散在find、grep、awk、sort、uniq、du、ps里的高频操作在 OpenClaw 里被重新组织成一组语义统一、参数简洁的子命令。你只需要记住claw这个主命令后面跟操作对象和动作就行。1.1 它解决的是工具碎片化而不是功能缺失单独看grep或者find功能一点都不弱问题出在组合上。比如我想看看某个目录下哪些文件超过 200MB、并且最近三天没动过用原生命令得写一长串find /data -type f -size 200M -mtime 3 -exec ls -lh {} \;这行命令不是不能写但每次都要在脑子里过一遍参数语义尤其-size 200M和-mtime 3的写法间隔一段时间不用就容易忘。OpenClaw 把这类场景封装成claw files stale --older-than 3d --size-min 200M参数名本身就是说明按键记忆负担小很多。它没有增加新功能只是把常用功能的入口重新设计了一遍让你想得起、敲得对。1.2 核心设计单一入口加子命令结构整个工具只暴露一个可执行文件claw通过子命令区分领域。整体结构大概是这样的claw ├── files # 文件与目录操作 ├── log # 日志分析与追踪 ├── t # 文本处理 ├── sys # 系统状态查看 └── conf # 工具自身配置每个子命令下面再挂若干个动作比如claw files stale、claw log top、claw sys disk。这样的好处是你只需要记住要找文件就进 files 区要看日志就进 log 区定位速度比在一堆零散命令里翻快得多。另外OpenClaw 保持了 Unix 工具的基本素养——输出结果永远走标准输出可以继续用管道交给less、grep、tee进一步处理。它不试图取代这些经典工具而是做它们之上的一个顺手层。1.3 典型使用场景我自己最常用的三个场景一是定时清理临时目录里超过 N 天的文件二是从访问日志里统计 Top 10 的请求路径三是检查磁盘剩余空间并生成一条带时间戳的记录。这几个操作如果全靠原生命令组合每星期都要重复回忆一遍用 OpenClaw 之后我把它们分别写成一行命令再塞进 cron脑子轻松很多。后面第 4 章会给出可直接套用的完整脚本。2. 安装到上手环境准备、配置目录与 Shell 补全OpenClaw 的使用门槛不高但有几个细节处理不好会直接影响体验比如可执行文件放哪、配置目录建在哪、如何写好补全脚本。2.1 安装方式与依赖最简单的方式是直接把编译好的claw可执行文件放到PATH能覆盖到的目录比如~/bin或者/usr/local/bin然后赋予执行权限mkdir -p ~/bin cp claw ~/bin/ chmod x ~/bin/claw如果希望所有登录用户都能用放到/usr/local/bin更合适但注意要有管理员权限。依赖方面OpenClaw 本身是静态编译的运行时不需要额外的解释器不过它内部的某些动作会调用系统自带的find、awk、rsync所以基础工具链要齐全。绝大多数 Linux 发行版默认都带了find和awkrsync可能需要单独装一下装好就不会再被调用到。2.2 配置目录与工作目录的约定OpenClaw 默认把配置文件放在~/.config/claw/下日志和临时缓存放在~/.cache/claw/。这个约定和很多现代命令行工具保持一致好处是删除工具时不会留下乱七八糟的残留文件。首次运行时工具会自动创建~/.config/claw/config.toml里面可以调整一些默认行为# 默认的日志文件路径模式支持 * 通配符 log_default_glob /var/log/app/*.log # files stale 默认的时间单位 time_unit d # 是否在输出时自动加上时间戳 auto_timestamp false我建议你花两分钟看一眼这个文件把log_default_glob改成自己项目里日志的实际路径后面claw log tail就可以不带参数直接用了省掉每次输入一长串路径的麻烦。2.3 Shell 补全让想不起来变成按两下 Tab命令记不全没关系补全脚本可以帮你兜底。OpenClaw 提供了一份补全脚本写入 shell 的 rc 文件就能启用# 以 bash 为例 echo source ~/.config/claw/completion.bash ~/.bashrc # zsh 用户 echo source ~/.config/claw/completion.zsh ~/.zshrc启用补全之后输入claw f再按 Tab会提示files输入claw files s再按 Tab会补全成stale。这个体验对新手特别友好等于把命令树做成了可探索的菜单。实际使用下来我觉得补全比记--help还快因为我不用先想清楚自己到底要问哪个选项。注意如果你把claw装完发现 Tab 补全没生效先确认 shell 是否重新加载了配置或者直接在当前会话里执行source ~/.bashrc。别急着怀疑安装路径八成是忘了这一步。3. 常用命令逐组拆解文件、日志、文本与系统状态这一章是名副其实的常用命令速查区。我不会把每个参数都列出来只挑日常使用频率最高的那些配合示例说明。想看完整列表任何时候都可以运行claw 子命令 --help。3.1 文件与目录清理、改名、按条件找文件文件操作是 OpenClaw 最被频繁使用的一组命令。核心动作有三个list、stale、rename。claw files list是增强版的目录列表默认按修改时间倒序排# 列举 /data 下最近修改的 20 个文件 claw files list /data --limit 20输出格式自带人类可读的文件大小和相对时间不用额外ls -lh转换。它的实现底层还是调用ls但帮你把排序、截断、格式化都做好了一层。claw files stale是我清理服务器临时目录最常用的命令# 找出 /tmp/build 下超过 7 天没动过的文件并显示大小 claw files stale /tmp/build --older-than 7d --size-min 1M这个命令的要点是--older-than支持10m、3h、7d这种带单位的写法符合日常语言习惯。它只负责找和列并不直接删除。想真正清理配合后面的管道命令claw files stale /tmp/build --older-than 7d --delete加上--delete后才会执行rm。安全设计上--delete总会先打印将要删除的完整路径并要求你再按一次回车确认除非额外加了--force。这个设计救过我一次某次匹配到的目录比预期多了一层。claw files rename做批量改名# 把所有 .txt 改成 .md claw files rename /docs --from .txt --to .md --dry-run先用--dry-run输出将发生的改动确认无误后再去掉这个参数真正执行。批量操作最忌讳盲目执行先跑一遍预览是基本素养。3.2 日志分析跟踪、过滤、统计 Top 序列日志场景是 OpenClaw 的另一个重头戏。claw log这一组命令在设计上刻意向tail和awk的用法靠拢让你不会有陌生感。claw log tail用来实时跟踪日志文件# 跟踪默认配置里的日志文件只显示包含 ERROR 的行 claw log tail --match ERROR它等价于tail -F加grep ERROR但--match参数支持简单的正则比如--match ERROR|WARN能同时匹配两种级别。和tail -F一样文件被轮转后也会自动跟随新文件不会断掉。claw log top是高频使用的统计命令# 统计日志中访问路径出现次数取前 10 claw log top --field 7 --limit 10--field指定按空格分隔后的第几列做分组。这个能力本质上是对awk {print $N} | sort | uniq -c | sort -rn的封装但参数更直观。需要按时间维度聚合时可以用--time-bucket 1h把日志按小时切片统计排查流量突增非常管用。claw log grep则是一个更克制的搜索工具# 在昨天的日志里找包含关键字 timeout 的行带上下文各 3 行 claw log grep timeout --since 24h --context 3它和直接grep的区别在于输出会带上文件路径和时间戳列多个日志文件混在一起时更容易定位来源。3.3 文本处理几个高频小工具文本处理这里OpenClaw 没有试图替代sed和awk而是封装了几个简单动作专门应付快速提取和格式转换。claw t cut做按分隔符取列比记awk -F的语法省心一点# 用冒号做分隔符取第 2 列和第 4 列 claw t cut /etc/passwd --delim : --fields 2,4claw t hex和claw t b64分别做十六进制和 Base64 编码解码优先从标准输入读取# 对文本做 Base64 编码 echo hello | claw t b64 --encode # 解码 echo aGVsbG8 | claw t b64 --decodeclaw t replace做简单的字符串替换默认全部替换并用颜色标出被替换的部分claw t replace old_value new_value config.txt它的正则能力和sed -E相当但调试体验好一些先执行--dry-run会直接在终端里渲染修改前后的 diff省得我在sed的-i和备份文件之间反复折腾。3.4 系统状态磁盘、内存、进程一目了然claw sys disk查看磁盘使用率默认按使用百分比倒序claw sys disk --min-usage 80只列出使用率超过 80% 的分区一眼看到危险项。输出里包含挂载点、总容量、已用、使用率、文件系统类型信息密度刚好。claw sys mem查看内存概览claw sys mem --top 5除了内存总量和可用量还会列出占用内存最多的前 5 个进程。排查内存告警时这一条命令就能当半个top用。claw sys ps是精简版进程查询按 CPU 或内存排序claw sys ps --sort cpu --limit 8它不追求覆盖ps aux的全部能力但输出里把 CPU%、内存%、启动命令三列排在一起快速扫一眼就能定位异常进程。子命令核心用途最常用参数等价于原生命令的大致写法claw files stale查找长时间未修改的文件--older-than 7dfind ... -mtime 7claw log top日志字段频率统计--field 7awk {print $7} | sort | uniq -cclaw sys disk磁盘使用率检查--min-usage 80df -h加手工排序claw sys ps进程资源排序--sort cpups aux --sort-%cpuclaw t b64Base64 编解码--encode/--decodebase644. 从单条命令到复合任务三个可直接套用的实战脚本命令单条用起来顺手真正体现价值的是把它编进脚本、挂上定时任务替代那些偶尔想起来才手动敲一遍的重复劳动。下面三个脚本都是我在实际环境中验证过的模板你可以改成自己的路径直接用。4.1 场景一清理临时目录里超过 N 天的文件构建目录里积攒的中间产物非常占空间放任不管很容易把磁盘撑爆。清理脚本长这样#!/bin/bash set -euo pipefail BUILD_DIR/tmp/build-artifacts KEEP_DAYS7 # 先统计待清理文件数量留个审计日志 claw files stale $BUILD_DIR --older-than ${KEEP_DAYS}d \ | tee -a /var/log/claw-clean.log \ | wc -l # 真正执行清理跳过确认。--force 要谨慎使用 claw files stale $BUILD_DIR --older-than ${KEEP_DAYS}d --delete --force我建议你把清理动作分成两步第一步只统计并记录第二步再删除。这样万一某天误删了东西至少审计日志里留着当时列出了哪些文件。脚本开头加上set -euo pipefail能让未定义变量和管道错误立刻暴露不至于带着问题继续往下跑。4.2 场景二从访问日志里统计 Top URL线上服务排查性能问题时经常要看某段时间内到底哪些路径被请求最多#!/bin/bash set -euo pipefail LOG_GLOB/var/log/app/access.log* OUT_FILE/tmp/url-top.txt claw log top --glob $LOG_GLOB --field 7 --limit 15 --since 24h $OUT_FILE # 顺手在控制台看一眼 cat $OUT_FILE如果你的日志格式不是标准的 Nginx access log--field的列号可能要调。先跑一条claw log grep GET / --glob $LOG_GLOB --limit 3看看输出确认路径确实在第 7 列再加统计能避免统计出空结果。用--since 24h限定时间窗口后输出会聚焦最近一天比直接统计整个日志文件更有业务参考价值。4.3 场景三磁盘用量巡检并记录到本地文件磁盘告警最好在出问题之前就发现而不是等监控平台报警再人工介入。我把巡检脚本放在 cron 里每小时跑一次#!/bin/bash set -euo pipefail STATE_FILE/var/lib/claw-disk-state.csv # 生成带时间戳的记录如果文件不存在就先写表头 if [ ! -f $STATE_FILE ]; then echo timestamp,mount,usage_percent,avail_gb $STATE_FILE fi claw sys disk --min-usage 0 \ | awk NR1 {print strftime(%Y-%m-%dT%H:%M:%S), $1, $3, $4} \ $STATE_FILE # 只看当前使用率超过 80% 的分区 claw sys disk --min-usage 80 \ | tee /tmp/disk-warning.txt这段脚本的核心思想是把每次巡检的原始数据追加到 CSV 里形成历史趋势而不仅仅是打一条告警。后面想看某个挂载点的用量变化直接对这个 CSV 做筛选就行。awk 里的strftime需要系统有gawk支持如果你的发行版默认是mawk可以改成用date命令生成时间戳。提示把 OpenClaw 脚本放到用户级 crontab 时环境变量尤其是PATH和交互式中不一样。如果claw装在~/bin下cron 可能找不到命令。最稳妥的做法是在脚本开头显式设置PATH/usr/local/bin:/usr/bin:/bin:$HOME/bin或者直接把claw的绝对路径写进变量。5. 踩过的坑与排查手法退出码、转义与权限问题工具用久了总会遇到几个不容易一眼看穿的问题。这里把我自己踩过、也帮别人排查过的几类常见坑整理出来每一个都附上问题现象和解决思路。5.1 退出码问题管道里的命令失败脚本却没报错一开始我写清理脚本时遇到过这样的现象cron 任务明明跑了磁盘还是满的日志里也没看到错误。排查后发现是管道的小陷阱claw files stale /data --older-than 7d --delete --force | grep deleted | wc -l这行命令里真正会失败的可能是第一段的claw但管道的退出码由最后一个命令wc -l决定。即使claw执行出错wc -l依然能成功返回 0于是外层脚本认为一切正常。解决方法是加set -o pipefail让管道中任何一个环节失败都算整体失败或者用中间文件把每一步拆开。现在我的所有脚本几乎都以set -euo pipefail开头算是用踩坑换来的肌肉记忆。5.2 文件名空格与通配符的转义批量改名和批量删除最容易踩的坑藏在文件名的空格里。假设目录里有文件old file.txt和old-file.txtclaw files rename /data --from old --to new两条命令都会匹配到old file.txt但如果你在脚本里用变量拼接路径再执行空格没加引号就会变成两个参数。OpenClaw 内部对文件列表的处理是逐条执行不是把整条命令交给 shell 解释所以它的rename内部不会踩这个雷但如果你把输出拿到自己的脚本里继续处理比如claw files list /data | while read f; do do_something $f; done就必须给$f加引号。另外想要只匹配精确文件名用--exact参数关闭模糊匹配否则--from log会把logical.txt也一起改掉这是我某次批量操作前预览时发现的意外。5.3 权限不足预览正常执行时报错claw files stale --delete在执行删除时是调用进程的权限去做的。如果你用普通用户运行但目标文件属于 root预览阶段一切正常列出文件不需要写权限真正删除时就会报Permission denied。OpenClaw 的删除逻辑会把失败的路径收集起来在末尾统一提示让你看是否有权限问题。这种情况下别急着上sudo。先确认你真的有权限删除这些文件再想是不是应该调整目录属主。直接sudo跑批量删除的风险在于管理员权限会把所有不可删除的保护都绕过去误操作成本瞬间放大。5.4 大目录下的性能问题小心--size-min的参数单位处理几十万文件的大目录时claw files stale会比直接在几十个文件的小目录里慢很多这很正常因为底层find本身就要遍历整个目录树。一个容易忽略的参数陷阱是--size-min 1M的语义你会不会觉得它匹配1MB 以上但有的工具设计里文件名不带后缀时的默认单位可能是 KB。OpenClaw 这里1M明确指 1 MiB但--size-min 1024这种纯数字写法会被当成字节而不是 KB。这种单位歧义在多个工具之间尤其危险。我建议你始终写带后缀的参数值比如--size-min 1M、--older-than 3d不要依赖默认单位。写清楚一步省得日后翻文档确认。5.5 时间基准--older-than 24h和--since 24h不是一回事这两个参数在 OpenClaw 里都支持但语义不同--older-than 24h以当前时间为基准找 24 小时之前修改的文件--since 24h在日志场景里指从 24 小时前到现在这个时间段内的记录。如果把它们用混很容易出现清理脚本把刚刚生成的日志当垃圾删了的事故。我也吃过这个亏。某次想把过期备份清掉顺手写了--since 30d结果它匹配的是最近 30 天的备份跟我的意图刚好相反。做任何时间窗口操作之前先跑一遍不带删除参数的预览把输出里文件的最后修改时间扫一遍确认范围对了再动手。6. 让 OpenClaw 长成自己的样子别名字命令与配置扩展OpenClaw 默认命令已经很顺手但每个人的工作流不一样。我建议你花十分钟做两件小事配置默认参数和新增别名动作把工具调成自己最顺手的样子。6.1 配置驱动的默认参数在~/.config/claw/config.toml里可以为具体子命令预设默认参数[alias.ls-big] target files list args [--sort, size, --limit, 30] [alias.glance] target sys disk args [--min-usage, 50]配置完成后claw ls-big # 等价于 claw files list --sort size --limit 30 claw glance # 等价于 claw sys disk --min-usage 50别名的价值在于把常用但参数多的操作固化下来。比如你每次都要看/var/log/myapp下的 ERROR 日志写一个claw err别名指向claw log tail --glob /var/log/myapp/*.log --match ERROR后面只需敲两个单词。6.2 自定义子命令用一段 shell 函数挂在 OpenClaw 之上有些操作不适合硬塞进配置里比如跨目录复制并压缩归档。我习惯在 shell rc 文件里定义一个函数以claw开头命名仍然保留统一入口的体验claw_backup() { local src${1:-/data} local dest${2:-/backup} rsync -a --delete $src $dest \ claw t b64 --encode backup done: $(date) /var/log/claw-backup.log }这类函数不进 OpenClaw 配置但调用方式仍然是claw_backup /data /backup对我这种喜欢所有操作从 claw 开始的人来说心智模型是统一的。6.3 接入 snippet 管理把常用命令存起来最后一个小技巧OpenClaw 的补全文件和配置都是纯文本完全可以纳入你自己的 dotfiles 仓库。我会把completion.bash、config.toml和别名配置放到版本控制里换机器时一条克隆命令就能还原整个终端环境。久而久之这个工具集就从别人写的工具变成了我自己维护的工作台。我自己最常用的一个别名是claw big它直接列出当前目录下最大的 10 个文件[alias.big] target files list args [., --sort, size, --limit, 10]每次磁盘告警我第一件事就是敲claw big十秒钟内定位大头文件。这种为自己量身定做的过程其实比工具本身更有意思——你真正需要的不是某个命令而是一套能不断沉淀自己操作习惯的工作流。