简要总结
completion
这页说明书是教你一个“小帮手”命令。这个小帮手命令能帮你把 openclaw 这个工具变得更聪明!它能记住你可能会输入的命令,然后在你打字时,像猜谜语一样给你提示。你可以在第一次使用 openclaw 工具之前,或者觉得它不够聪明、记不住命令的时候,来看看这页。
五岁小孩版解释
这个命令的名字叫 openclaw completion。你可以把它想成一个“命令提示小助手”。它的工作就是为你的电脑终端(那个黑色的打字窗口)制作一个“提示清单”,这样你以后用 openclaw 打字时,它就能自动帮你补全命令,不用你全部打出来,很方便!
这个小助手可以给好几种不同的“终端环境”工作,就像给不同牌子的电视机配遥控器一样。它主要支持这几种:bash、zsh、powershell 和 fish。如果你不告诉它你要哪一种,它会默认帮你做 zsh 用的。
你可以用不同的方式告诉小助手你想要什么。下面就是几种常用的方法:
- 只看看提示清单长什么样:你只要输入
openclaw completion,小助手就会把制作好的清单直接显示在屏幕上给你看,但不会帮你保存。 - 为特定的终端做清单:比如你想给
bash做,就输入openclaw completion --shell bash。这里的--shell就是告诉小助手:“请为某某终端做清单”。 - 做好清单并帮你安装好:这是最方便的方法!输入
openclaw completion --install,小助手不仅会做好清单,还会自动把它放到正确的地方,让你的终端下次启动时就能用上。如果你想一步到位,可以同时指定终端类型,比如openclaw completion --shell fish --install就是为fish终端制作并安装。 - 把清单悄悄存起来:如果你不想看屏幕上的字,也不想马上安装,可以输入
openclaw completion --write-state。小助手会把做好的清单文件,悄悄地存到一个叫$OPENCLAW_STATE_DIR/completions的文件夹里,以后你想安装的时候可以自己去找。
这里有几个重要的小提醒要告诉你哦:
- 当你使用
--install这个选项时,小助手会在你的终端配置文件里添加几行字,就像贴了一张“使用说明”纸条,告诉你的终端去哪里找那个“提示清单”。 - 如果你既不用
--install,也不用--write-state,小助手就只会把清单内容打印在屏幕上,不会做其他事情。 - 这个小助手很勤快,它会提前把
openclaw所有能用的命令(包括那些藏在里面的小命令)都准备好,所以你的提示会很全! - 安装的时候,小助手可能会问你:“我真的要安装吗?”。如果你很确定,可以在命令后面加上
-y或--yes,就像说“是的,我确定!”,这样它就不会再问你,直接安装了。