Plugins

插件就像给机器人加装的小积木，能让它学会新本领。比如，机器人本来不会打电话，但装上“语音通话”这个积木，它就会了。这些新本领可能是新的命令、新的工具，或者让机器人能连接到新的地方。

怎么开始用插件呢？

1. 先看看机器人已经有哪些积木了。在电脑的命令行里输入 openclaw plugins list，它就会告诉你。
2. 安装一个新积木。比如，你想安装官方的“语音通话”积木，就输入 openclaw plugins install @openclaw/voice-call。这里要小心，安装时只能写积木的名字和确切的版本号，不能写其他东西。
3. 让机器人重启一下。安装好新积木后，需要重启一下机器人（Gateway），然后你才能在设置里配置这个新积木。

有哪些积木可以用？ 这里有一些官方做好的积木，比如“语音通话”、“Zalo 个人版”、“Microsoft Teams”等等。还有一个叫“记忆”的积木是机器人自己就带着的，默认是打开的。你可以把它们想象成不同的技能包。

重要的事情要记住：

• 插件积木是和机器人一起运行的，所以只安装你信任的积木。
• 安装或修改插件后，一定要重启机器人才会生效。
• 你可以在设置里用一个叫 plugins.allow 的名单，只允许你同意的积木运行，这样更安全。

怎么管理这些积木？ 你可以用一些简单的命令来和积木们玩：

• openclaw plugins list：列出所有积木。
• openclaw plugins info <积木名字>：查看某个积木的详细信息。
• openclaw plugins install <积木名字或路径>：安装一个新积木。
• openclaw plugins enable/disable <积木名字>：打开或关闭一个积木。
• openclaw plugins update：更新已经安装的积木。

积木还能做什么？ 除了给机器人加新技能，积木还能做很多事：

• 让机器人拥有新的“记忆”方式。
• 给机器人添加新的聊天通道（比如一个新的聊天软件）。
• 让机器人学会新的、不需要它动脑就能执行的快速命令（比如 /mystatus 直接显示状态）。
• 在机器人思考前后，悄悄地给它一些额外的小提示。

如果你想自己做一个积木…… 这页也告诉了大朋友（开发者）怎么做新积木。比如，要定义积木的名字、它能做什么、需要哪些设置。但最重要的是，做好的积木里必须有一个叫 openclaw.plugin.json 的说明文件，机器人靠它来认识这个积木。