OpenClaw命令行操作需掌握五步：一、理解“openclaw 子命令 [选项] [参数]”结构；二、用scan子命令执行文件扫描；三、通过~/.openclawrc配置默认参数；四、用--format导出JSON/CSV结果；五、用--log-level debug启用调试日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您刚接触OpenClaw命令行工具，需要掌握其基本语法和常用操作，则需从核心命令结构、参数传递方式及基础交互模式入手。以下是开展OpenClaw命令行操作的步骤：
一、理解OpenClaw命令基本结构
OpenClaw命令遵循“主命令 子命令 [选项] [参数]”的标准格式，其中主命令为openclaw，子命令决定具体功能模块，选项以单短横线（-）或双短横线（--）开头，参数为操作对象路径或值。正确识别各部分位置是避免解析错误的前提。
1、打开终端或命令提示符窗口。
2、输入openclaw --help并回车，查看所有可用子命令列表。
3、观察输出中以Usage:开头的模板行，确认子命令在主命令后的相对位置。
4、注意方括号[ ]表示可选内容，尖括号<>表示必填内容，斜体部分为占位符名称。
二、执行基础文件扫描任务
文件扫描是OpenClaw最常用的基础操作，用于识别目标目录中符合特定规则的文件特征。该操作依赖scan子命令，并需明确指定路径与匹配模式。
1、切换至待扫描目录，例如执行cd /home/user/documents。
2、运行openclaw scan --pattern ".*\.pdf$" --recursive，启用正则匹配与递归遍历。
3、若需限制扫描深度，添加--max-depth 3参数，防止遍历过深目录树。
4、输出结果中每行包含文件绝对路径、SHA256哈希值、匹配模式标识符三项字段。
三、配置默认参数文件
为避免重复输入常用选项，OpenClaw支持通过.openclawrc配置文件预设参数。该文件位于用户主目录下，采用YAML格式，启动时自动加载并覆盖默认行为。
1、使用文本编辑器创建~/.openclawrc文件。
监控一个或多个 GitCode 仓库的 PR，通过 OpenClaw Gateway 自动执行 AI 审查，发布 PR 评论，并发送钉钉和企业微信通知。
2、写入以下内容：default_pattern: ".*\.(jpg|png|gif)$"。
3、添加max_depth: 2行，设定默认最大递归层级为2。
4、保存后再次执行openclaw scan /tmp，无需显式指定--pattern或--max-depth即可生效。
四、导出扫描结果至结构化文件
OpenClaw支持将扫描输出重定向为JSON或CSV格式，便于后续程序处理。导出动作不改变原始扫描逻辑，仅影响输出载体和字段组织方式。
1、执行openclaw scan /var/log --format json > report.json，生成标准JSON文件。
2、如需CSV格式，替换--format json为--format csv，并确保输出扩展名为.csv。
3、检查导出文件首行是否包含path,hash,timestamp,pattern_id字段名（CSV）或对应键名（JSON）。
4、使用--no-header选项可跳过CSV表头行，适用于追加写入场景。
五、启用详细日志与错误追踪
当命令执行异常或结果不符合预期时，启用调试日志可暴露内部调用链、参数绑定过程及模块加载状态，是定位问题的关键手段。
1、在任意OpenClaw命令末尾添加--log-level debug参数。
2、运行openclaw scan /etc --log-level debug 2> debug.log，将stderr重定向至日志文件。
3、打开debug.log，查找含DEBUG标签的行，重点关注"Resolved pattern regex"、"Loaded module: fs_walker"、"Failed to open file descriptor"等关键提示。
4、若出现编码错误，日志中会明确标出发生错误的文件路径及字节偏移量。
