学完安装、配置、模型切换，恭喜你已经能跑起 OpenClaw 了。

但真正开始用的时候，很多人会卡在“下一步该敲什么”。

“我想改这个文件，怎么让 OpenClaw 动手？”

“我想跑一下测试，命令怎么传？”

“上下文聊爆了，怎么清空？”

刚上手那会儿，我也是盯着光标看了半天，不知道下一步该说什么。

后来把每天用得最多的命令整理成一张速查表，遇到新场景就翻一下。

今天分享这份入门到熟练必备的 15+ 个命令，覆盖 6 大类高频操作。收藏起来，下次卡壳直接对照。

一、文件操作：和 OpenClaw 协作的基础

OpenClaw 真正厉害的地方，在于它能读懂并直接修改你的文件。这 5 个命令，覆盖 90% 的日常场景。

1. 读取文件

读取 src/services/user_service.py

OpenClaw 会打印出整个文件内容，并在需要时给出关键段落解释。比你自己点开文件快，也比 cat 命令更有“理解”。

2. 创建新文件

在 src/utils/ 下新建一个文件 date_helper.py，内容是处理日期格式的工具函数，支持 YYYY-MM-DD 和时间戳互转。

OpenClaw 会直接创建文件并写好内容。不用你打开编辑器、不用切到对应目录。

3. 修改文件（精准替换）

把 src/api/auth.py 第 42 行的 token 过期时间从 3600 改成 7200。

这是最常用的修改方式。关键是要说清楚“在哪个文件的哪一行，改什么”，OpenClaw 才会精准下手，避免误伤。

4. 批量修改

把项目里所有用到 old_api.com 的地方都替换成 new_api.com，告诉我一共改了几个文件。

OpenClaw 会先扫描项目，给出变更列表。

等你确认后，它才动手修改。涉及多个文件时，一定要先看 diff。

5. 列出文件

列出 src/services/ 下所有的 .py 文件。

这个命令在你需要快速摸清目录结构时特别有用。结合之前的“忽略缓存目录”提示，效果更佳。

二、代码搜索：定位问题比改问题更重要

要改代码，先得找到代码在哪。这 3 个搜索命令，是排查问题时的利器。

6. 关键词搜索

在 src/ 目录下搜索包含 “TODO” 注释的所有位置，按文件分组列出来。

OpenClaw 会在整个目录里搜索，按文件整理结果。比自己用 grep 然后复制粘贴友好太多。

7. 跨文件批量替换

把项目里所有 print( 替换成 logger.info(，但只替换不在测试文件里的。

精准过滤条件，才能避免误伤。OpenClaw 会先告诉你匹配到几处，确认后再执行。

8. 定位函数定义

UserService 类里的 login 方法定义在哪？调用方都有哪些？

OpenClaw 会告诉你函数定义的位置（文件:行号），并把调用它的代码也找出来。这个命令在读别人代码、改旧项目时极其好用。

三、终端命令：让 OpenClaw 帮你跑命令

OpenClaw 不仅能改代码，还能直接执行终端命令。

9. 执行单条命令

运行 pytest tests/ 看看测试有没有全过。

OpenClaw 会执行命令，并把完整输出贴回来。失败的测试还会自动分析可能原因。

10. 长任务后台执行

启动 npm run dev，但不要等它结束，让它在后台跑。

需要持续运行的服务（如 dev server、watch 模式）必须用后台方式，否则会卡住 OpenClaw。

11. 查看历史输出

刚才那次 npm install 的输出再给我看一下。

有时候命令输出太长被截断，或者你想对比两次结果。这条命令能调出 OpenClaw 的执行历史。

四、Git 操作：变更管理不慌张

让 OpenClaw 帮你处理 Git，避免在 IDE 和终端之间来回切。

12. 查看变更

git status 一下，看看我改了哪些文件。

简单直接。OpenClaw 还会顺手帮你按“已暂存/未暂存/未跟踪”分类列出来。

13. 写提交信息

根据我这次的改动（已经在暂存区里），写一段符合 Conventional Commits 规范的 commit message。

不用自己想 commit message 了。OpenClaw 会读 diff 内容，生成符合规范的描述。要不要带 emoji、加不加 scope 都能提要求。

五、上下文管理：长对话不爆

OpenClaw 的对话有上下文长度限制。聊到一半变卡顿？用这 3 个命令管起来。

14. 查看当前上下文

/context

显示当前会话用了多少 token、还剩多少额度。看到快满了就提前压缩。

15. 压缩上下文

/compact

把当前对话压缩成一段摘要，腾出 token 空间继续聊。适合聊了很久、但新任务和前面的内容关联不大的场景。

16. 清空上下文

/clear

彻底重置，开始新任务。注意：清空后 OpenClaw 就忘了之前所有对话。重要信息记得先让它写到文件里。

六、帮助与调试：出问题时别硬扛

遇到报错或者想看新功能，这 3 个命令能救你。

17. 查看帮助

openclaw --help

列出所有可用命令和参数。记不住命令的时候永远第一个想到它。

18. 查看版本

openclaw --version

升级 OpenClaw 后遇到行为不一样，先看版本。新版本可能改了默认配置。

19. 查看调试日志

跑刚才那个 pytest 失败的任务，这次输出详细日志，告诉我哪里报错。

OpenClaw 失败时给的错误信息经常很简略。主动要求详细日志，能让它把完整的 stack trace 调出来。

3 个让命令更好用的细节

1. 模糊的指令得不到好结果

“帮我改一下那个文件”——哪个文件？改什么？模糊的指令 OpenClaw 大概率要追问。

改成具体指令：“把 src/api/auth.py 第 42 行的 token 过期时间从 3600 改成 7200。”

2. 危险操作前让 OpenClaw 二次确认

执行 rm -rf、git push -f、改生产环境配置这类操作前，加一句：

执行前先打印出完整命令让我确认，确认后再执行。

加一道人工关卡，比事后回滚省事十倍。

3. 善用斜杠命令的内置帮助

很多斜杠命令（/context、/clear）支持加 --help：

/clear --help

不记得参数的拼写和作用时，随手 help 一下比查文档快。

总结一下

这份速查表覆盖了 6 大类、19 个高频命令：

• 文件操作：读、写、改、列——协作的基础
• 代码搜索：定位、批量替换、找函数定义
• 终端命令：跑单条、后台长任务、查历史
• Git 操作：查看状态、生成提交信息
• 上下文管理：/context 查、/compact 压、/clear 清
• 帮助调试：--help、版本、详细日志

前 3 类是每天必用，第 4、5 类是“用久了才知道它香”，第 6 类是“出问题时救命的”。

今天就开始用，下次遇到不知道该敲什么的时候，翻出来对照一下。用得越多，记得越牢。