plugins

这页讲的是怎么管理OpenClaw的“小插件”。小插件就像给你的机器人增加新玩具或者新本领一样，能让它做更多事情。这些本领是直接装在机器人身体里的。

先看看有哪些命令可以用： 这些命令就像给机器人的指令。你可以在电脑的命令行里输入它们。

1. openclaw plugins list：这个命令是“看一看”。它会列出你所有的小插件，让你知道现在有哪些。
2. openclaw plugins info <id>：这个命令是“问一问”。你要告诉它你想了解哪个小插件（把<id>换成它的名字），它就会告诉你这个插件的详细信息。
3. openclaw plugins enable <id>：这个命令是“打开开关”。有些本领机器人本来就有，但是没打开。用这个命令（把<id>换成插件名字）就能打开它，让它开始工作。
4. openclaw plugins disable <id>：这个命令是“关上开关”。和打开相反，它能让一个正在工作的小插件停下来休息。
5. openclaw plugins uninstall <id>：这个命令是“拿走玩具”。它会把你不要的小插件从机器人那里拿走。
6. openclaw plugins doctor：这个命令是“检查身体”。它会帮你检查所有的小插件是不是都好好的，有没有生病（出问题）。
7. openclaw plugins update <id>：这个命令是“更新玩具”。如果一个小插件有了新版本，用这个命令（把<id>换成名字）就能把它升级成最新的。
8. openclaw plugins update --all：这个命令是“全部更新”。它会帮你把所有能更新的小插件都一起升级。

怎么安装一个新插件？ 安装就像给机器人一个新玩具。你要小心哦，因为安装插件就像让机器人运行新的代码。

1. 要安装，就用这个命令：openclaw plugins install <path-or-spec>。这里的<path-or-spec>就像玩具的“地址”或者“名字”，你要告诉机器人去哪里找这个新玩具。
2. 如果是从一个叫npm的玩具商店安装，你可以在命令后面加上--pin。这就像用图钉把玩具的“精确版本号”钉在墙上，这样下次就不会拿错版本了。
3. 要记住的事情：机器人只认识npm商店里玩具的“名字”和“精确版本号”。它不认识像“1.0.x”这样的范围，也不认识从网上其他地方（像Git仓库或一个网址）直接拿来的玩具。
4. 要小心的事情：如果你只说玩具的名字（比如diffs），机器人可能会把它自己本来就有的那个同名的玩具给你。如果你真的想从npm商店安装一个同名的新玩具，你需要告诉机器人完整的带“@”符号的名字（比如@scope/diffs）。

怎么卸载（拿走）一个插件？

1. 要拿走，就用这个命令：openclaw plugins uninstall <id>。把<id>换成你想拿走的小插件的名字。
2. 默认情况下，机器人不仅会把记录删掉，还会把插件文件从它的“玩具箱”（电脑上的一个文件夹）里删除。
3. 如果你只想让机器人忘记它，但把文件留在“玩具箱”里，可以在命令后面加上--keep-files。

怎么更新一个插件？

1. 要更新，就用这个命令：openclaw plugins update <id>。把<id>换成你想更新的小插件的名字。
2. 你也可以用openclaw plugins update --all来更新所有能从npm商店更新的小插件。
3. 要注意：只有那些从npm商店安装的插件才能被更新。
4. 要小心的事情：如果机器人发现新下载的玩具和它之前记住的样子（一个叫“完整性哈希”的东西）不一样，它会停下来问你“真的要换吗？”。如果你在让机器人自动工作（比如在CI环境），你可以在命令前面加上--yes来直接告诉它“是的，换吧”。