OpenClaw斜杠命令手册：从基础解析到高效AI会话工作流

如果你用过一段时间AI会话工具就会有一个很直观的感受自然语言交互虽然自由但高频操作重复几遍之后效率是真的低。比如切换模型、清空上下文、加载文件、导出对话每次都要重新描述一遍需求AI理解得还不一定准。OpenClaw 这个开源会话式AI客户端把这类高频操作收敛成了会话内的 slash commands斜杠命令一条斜杠加一个命令名动作就稳定执行了不需要看AI心情。这篇手册就是围绕 OpenClaw 的斜杠命令体系做的一次系统整理包含命令分类、参数规则、自定义玩法、报错排查和场景拆解。我自己在实际使用中踩过不少坑比如命令没生效、参数解析错乱、上下文压缩后角色设定丢失等等都写进了后面的常见问题部分。文章不追求把每个命令都讲一遍而是把最常用的那一套命令讲透让你拿到手就能对着用也不用背太多。1. 为什么需要一份斜杠命令手册1.1 斜杠命令解决了什么问题可以把斜杠命令理解成“AI会话的快捷键”。正常情况下你想让AI做一件结构化的事情需要在对话框里打一大段提示词而且每次打出来的措辞还不一样AI的理解就会有波动。斜杠命令的本质是固定接口一个命令名对应一个明确动作输入无歧义行为可预期。这个思路和编辑器里的快捷键非常类似。你按 CtrlS 一定代表保存不会因为你今天心情好就变成了“全选”。斜杠命令也一样/clear就是清空上下文/export就是导出对话不会有多义性。对普通人来说它降低的是重复输入的成本对开发者来说它更重要的意义是把交互变成结构化协议方便做脚本化、别名化和批量组合。还有个容易忽略的好处是斜杠命令天然适合肌肉记忆。高频使用的命令就那么十几条用熟了之后手速和准确率都会明显提升而自然语言提示词就没有这个效果因为每次都要重新读一遍。1.2 命令解析的基本规则要正确使用斜杠命令得先理解命令是怎么被解析的。这类客户端的通用解析逻辑是当一条消息以“/”开头时把“/”之后到第一个空白字符之间的内容识别为命令名其余部分作为参数传给命令。参数通常按空格切分。如果某个参数本身包含空格一般需要用引号包裹。举个例子/file docs/项目方案.md是加载一个文件但如果文件名带空格比如docs/项目 方案.md就需要写成/file docs/项目 方案.md否则会被解析成两个参数。这个细节几乎每个新手都会踩一次。还有两个坑值得单独说。第一中文输入法容易把斜杠打成全角“”解析器通常只认英文半角“/”。第二斜杠命令只在一行消息的开头触发如果你把它写在自然语言中间比如“请你用 /role 切换到专家模式”它会被当成普通文本不会执行。正确做法是把命令单独放一行后面再跟自然语言描述。1.3 命令全景一览OpenClaw 的不同版本命令名会有差异但整体分类是稳定的。我在使用中习惯把命令分成五类这里先给一个全局视图分类典型命令主要作用会话管理/new/clear/continue/resume/undo新建、清空、续接、回退会话身份与模型控制/role/system/model/temperature设置角色、系统提示、切换模型、调节输出风格上下文与记忆/context/compact/memory/forget查看上下文用量、压缩历史、读写长期记忆文件、工具与技能/file/web/search/run/skill加载文件、抓取网页、检索资料、执行命令、装载技能输出与导出/export/summary/review导出对话、生成总结、代码审查需要提醒的是这份表是通用约定不是标准答案。你当前装的版本到底支持哪些命令打开/help看到的才是准确名单。后面每个类别的命令细节我会结合自己的实际使用一条条讲。2. 核心命令逐条拆解2.1 会话管理类掌握记忆的边界会话管理是我认为最值得先搞懂的一类命令。会话是AI记忆的容器管理命令就是在管理记忆的边界。用不好这类命令对话就会越聊越乱AI的注意力被早期无关内容稀释回答质量一路下滑。/new开启一个全新会话。最常见的用途是任务切换比如刚才还在写代码现在要转去写文档直接/new最干净避免上一个任务的上下文干扰。我发现很多人不习惯用/new宁可在一个会话里硬聊结果角色设定、讨论焦点全混在一起非常低效。/clear清空当前上下文但保留会话本身。它适合上下文即将超限、但还想接着这个会话继续干活的场景。注意清空之后AI会丢失之前的所有讨论细节所以关键信息最好先通过/export存档再执行清空。/continue和/resume都是用来加载历史会话的。区别在于/continue一般直接接着当前会话的末尾续聊/resume则要指定一个过去的会话ID或名称。我实际用下来的建议是每个重要任务开始前先给会话起一个有意义的名字否则会话一多/resume根本找不到目标。/undo回退上一步操作。这个命令在AI批量修改文件、生成代码时特别好用。但它的回退深度通常是有限的不是无限撤销所以涉及不可逆操作时别把/undo当保险。会话管理命令的使用原则我总结成一句话新任务开新会话旧会话要命名关键数据先导出再清空。2.2 身份与模型控制类让AI处于正确的工作状态身份类命令解决的是AI的“工作状态”问题。同样一个模型以“资深编辑”的身份输出和以“开发者”的身份输出结果可能有天壤之别。/role用于设定AI的角色。它比自然语言提示高效的原因在于角色指令会被视为一条独立的系统级配置而不是混在普通用户消息流里模型对它的遵循度更高。我常用的写法是/role 资深编辑擅长把技术文档改写成通俗文章简洁直接AI不需要猜测你的意图。/system用来注入系统提示词。它和/role的区别可以这么理解/role设定人格和立场/system追加全局约束。比如/system 回答一律附上示例、/system 不要使用列表。这类约束会影响整段会话所以不用频繁修改。/model用于切换模型后面跟模型标识名。这里有一个容易忽略的坑切换模型之后上下文不会自动重置。原本针对A模型压缩过的历史消息换到B模型之后会继续沿用但跨模型的上下文关联度可能降低输出质量会波动。我真切建议跨模型切换时尽量开新会话除非你明确知道自己在做什么。/temperature用于调节输出随机性数值范围一般是0到1。0偏确定性1偏发散。写代码的时候我习惯调到0.2附近脑暴文案的时候调到0.8。实际体验下来这个参数对创意思路的影响远比很多人想象得大。2.3 上下文与记忆管理类预算和资产的平衡这类命令最容易被人忽略但恰恰是影响长期使用体验最深的。我习惯把上下文理解成“算力预算”把长期记忆理解成“资产”两者不能混为一谈。/context查看当前上下文占用情况一般会显示已用token数、总上限和剩余空间。很多人直到收到“上下文超限”的报错才想起来用这个命令其实应该在对话进行到中段就周期性看一眼。想象一下上限20万token你已经聊到18万后面内容的质量只会越来越差因为模型能参考的有效信息密度太低了。/compact压缩上下文。原理很简单把之前的对话历史交给模型生成一份结构化摘要用摘要替换原始消息腾出可用空间。但它是有损的摘要里没记下的细节就是丢了。压缩之前最好把重要内容单独整理一下尤其是那些你希望在后续对话中还能引用的具体数据和结论。/memory把重要信息写入长期记忆。这个命令适合跨会话承载偏好信息比如“我写文档默认用中文”“项目代号统一用X”。长期记忆会持久化保存但它存在本地上敏感信息放进去之前要想清楚。/forget删除指定记忆。如果你之前写入的偏好已经过时直接/forget 关键词清理掉不要留着污染后续会话。2.4 文件、工具与技能类打开AI的双手这类命令是OpenClaw这类开源客户端区别于普通聊天工具的底气所在它意味着AI不只是聊天机器人而是一个能读文件、查资料、执行命令的工作代理。/file加载本地文件内容到上下文。用法类似/file docs/项目方案.md。文件内容会被切分后塞进上下文所以大文件要格外小心几万字的文档很可能直接吃掉一大半token额度后面就没空间干正事了。/web抓取指定网页内容。适合让它去读线上文档或资料页。抓下来的内容格式不一定干净网页里的导航、广告、重复区块都会混进来最好抓完之后让AI先输出一份信息摘要再做下一步处理。/search在本地知识库或项目目录内做检索。这个命令的实用价值极高相当于让AI拥有读取整个项目的能力而不是只看你手动塞给它的几个文件。对开发者来说这条命令基本是和项目深度协作的入口。/run执行命令。这是OpenClaw这类工具最核心、也最需要注意的一个命令。只要配置了执行权限AI就能在当前环境里跑脚本、查日志、批量改文件。权限一定要收敛别让它在一个不受信任的目录里裸奔。/skill装载技能包。技能本质上是一套预设的提示词加工具调用流程的集合比如“数据分析技能”“文档翻译技能”。我个人非常推荐把高频任务沉淀成技能包这比每次手工输入提示词稳定得多因为技能包会把完整流程约束好AI不容易跑偏。3. 实操把常用命令串成自己的工作流3.1 入手的正确姿势先摸清命令名单我见过太多人拿到这类工具第一反应是去网上抄一份命令大全结果版本不对白折腾一顿。更靠谱的做法是进入会话后的第一件事先敲一个/help。/help会把当前版本支持的命令列表列出来有的版本还支持/help 命令名查看单条命令的详细说明。我之前整理这份手册的时候也吃过这个亏网上流行的命令和当前装的版本差了不止一个迭代很多命令名已经改过了。所以不管你手里拿的是官方手册还是这份整理都用/help的输出当最终标准。另外/help的输出结构本身也能反映出当前版本的侧重点。如果你发现某个分类下的命令特别多说明这个版本的主要能力集中在那里可以优先花时间研究。3.2 进阶玩法自定义命令和组合命令多数开源会话客户端都支持用户自定义命令OpenClaw 也沿用了这个思路。自定义命令一般通过配置文件加载文件名和格式以当前版本的文档为准通常放在用户目录下的隐藏文件夹里。自定义命令的价值在于把复杂的流程封装成一句话。我举个例子假设你每天都要做一次“文档完整性检查”固定步骤是查看上下文用量、设置评审角色、生成遗漏项总结。如果用自然语言你要打三行字而且每次都可能漏一步。绑定成一个自定义命令之后就变成了这样commands: daily-review: description: 对当前文档做完整性检查 steps: - command: /context - command: /role 产品评审人 - command: /summary --focus 遗漏项这段配置的意思是运行/daily-review时客户端会依次执行三条命令。配置文件加载后需要重启会话或者用/reload重新加载。这里有两个容易犯错的地方一是自定义命令名不能和内置命令冲突否则内置命令优先你的定义会被忽略二是命令里的参数如果有空格要用引号包好不然会被拆成多个参数。3.3 一次完整任务的命令串场拿一个常见的任务举例研究一个开源项目输出一份中文调研报告。我用命令串场的方式走一遍完整流程每个步骤的意图都说明白。首先是/new新开一个会话。这么做是为了避免之前对话的角色设定和上下文污染这次调研尤其是当AI刚处理过别的任务时。然后是/role 技术研究助理负责调研开源项目并输出结构化中文报告。提前把角色定好AI后续的回答范围就有了锚点不会东拉西扯。接着/web抓取项目主页再/file docs/README.md加载本地文档。注意这类文件往往很长加载完之后立刻用/context看一下token占用心里有数。当对话进行到一半资料加载得越来越多上下文可能接近上限这时果断执行/compact压缩。压缩后系统提示和角色设定是否保留不同版本行为不一样压缩完最好确认一下角色还在别让AI突然“失忆”。最后在产出报告之前用/summary生成阶段性摘要然后/export导出对话存档。这一步我强烈建议每次都做成本极低但事后回溯价值巨大。整个串场的核心逻辑可以用一句话概括先定义角色聚焦注意力再喂资料扩展知识面资源紧张时压缩保可用空间最后导出留档。4. 常见问题与排查技巧实录4.1 高频报错对照速查表实操中总会遇到各种报错或“命令没反应”的情况。我把自己遇到的典型问题整理成了表格按现象、原因、处理办法三列对照方便你直接定位。现象大概率原因处理办法命令没反应直接当作普通消息发送命令没有写在消息开头把命令单独放第一行后面再跟自然语言报错“Command not found”命令拼写错误、版本升级改名、自定义命令未加载输入/help核对命令名检查配置并重载参数总是解析错参数里有空格但没用引号包裹带空格的参数用英文双引号包起来中文斜杠识别不了输入了全角斜杠“”切到英文半角“/”关闭中文标点输入上下文剩余空间显示不足长文档一次性加载过多或聊太久没压缩用/compact压缩或/clear后重建会话/run执行失败权限不足、工作目录不对、脚本路径写错检查执行权限确认当前工作目录和绝对路径压缩后AI角色设定丢失压缩逻辑不保留系统级消息压缩后重新执行/role或把角色配置写进自定义命令4.2 排查思路和几个容易忽略的细节遇到问题先别急着重启按这个顺序排查先看命令本身对不对再看环境状态最后看日志。第一步永远是核对命令。输入/help确认命令名在当前版本存在参数格式对不对。很多人报错“命令没反应”其实就是命令名打错了一个字母或者版本升级后改名了。第二步看环境。检查当前工作目录是不是你以为的那个目录配置文件有没有被正确加载当前会话是不是处在某个特殊状态。换了一台机器之后自定义命令丢失是最常见的问题文件放在旧机器上新环境根本不会加载。第三步看日志。多数客户端会把运行日志写到本地某个目录具体位置以当前版本文档为准。日志里通常有命令解析失败的详细原因比黑盒猜测可靠得多。还有一个非常容易踩的坑上下文压缩之后/role和/system设定的内容不一定会被保留。有些版本压缩时会把所有历史消息包括系统消息合并成摘要结果AI的角色设定就丢了。对策很简单压缩之后主动检查角色是否还在不在就重新设一遍。4.3 几条耐用的使用经验聊到这里分享几个我长期使用下来的个人经验都不是命令文档里能找到的。第一斜杠命令不是越多越好。记住最常用的十来条就够了其余低频命令交给/help现查。人的注意力是有限的背一百条命令不如把二十条练熟。第二给会话命名是值得养成的习惯。不管是/resume回溯历史还是/export归档存档没有名字的会话混在一起时找起来极其痛苦。我一般会在会话开头或者任务确定后立刻命名。第三定期归档导出。项目收尾时用/export把关键会话导出存档成本极低但几周之后回看时价值巨大尤其是那些包含决策过程的讨论记录。5. 这套命令体系能覆盖哪些场景5.1 日常办公与内容生产内容生产是最适合斜杠命令固化的场景之一因为“审稿”“改稿”“风格转换”这类操作重复度极高判断标准明确。我平时处理素材的流程通常是这样/file加载原始文稿/role 资深编辑设定立场/summary提取核心信息最后用自定义命令一键输出指定风格的版本。最适合用自定义命令固化的工作往往具备两个特征高频重复而且输出标准明确。比如“把一段技术描述改写成公众号风格控制在800字以内”这种任务绑定成一条自定义命令之后每天处理素材的效率会明显提升。而像“帮我想个点子”这类开放式任务反而不适合做成命令因为它的判断标准本身就模糊。5.2 技术开发与数据分析开发者是斜杠命令体系最直接的受益者。日常开发里我会用/file加载需求文档/role 资深架构师设定评审视角/run跑测试脚本最后/export输出设计文档。这套组合基本覆盖了从理解问题到产出方案的完整链路。数据分析场景更看重工具链路。导入数据文件用/file生成分析代码用/role 数据分析师和自然语言组合执行脚本靠/run可视化代码也可以直接让AI生成。这里要特别提醒/run的权限控制务必收敛。我的原则是只在可信目录里放开执行权限不要让AI默认获得整个系统的最高权限。工具是双刃剑便利的代价是风险所以权限边界要自己守好。5.3 团队协作的标准化斜杠命令在团队层面能发挥比个人使用更大的价值因为它提供了一套统一的操作协议。团队可以把一套自定义命令配置和系统提示词模板放进共享仓库让所有人用同一套命令命名和参数约定。这样做的好处有两个。第一减少沟通成本。负责人说一句“跑一遍daily-review”团队成员执行的就是同一个流程不会因为各自的理解差异而跑偏。第二降低新人的上手门槛。新成员加入时不需要翻聊天记录去猜前辈们的工作流只需要看命令配置就知道标准流程长什么样。对我来说这就是斜杠命令从“个人快捷键”升级为“团队统一语言”的关键一步。最后说一点个人体会。我最初也觉得斜杠命令是一种需要额外记忆的负担上手之后才意识到它本质上是在给AI会话建立一套有边界的接口。把重复操作沉淀成命令之后使用体验会从“每次跟AI解释一遍”变成“按几个按钮”稳定性和效率都上了一个台阶。踩过几次坑之后我对新上手的人只有一个建议别急着背全量命令先花十分钟把/help输出过一遍挑出和你工作最相关的七八条搭配自定义命令固化下来再逐步扩展。我实际用下来的体会是AI会话工具之间的生产力差距很多时候就差在这些不起眼的斜杠上面。