Skills

OpenClaw 机器人需要学习“技能”才能使用各种工具。每个技能就像一个装着说明书的小盒子，说明书的名字必须是 SKILL.md。机器人会从几个不同的地方找这些小盒子。

技能放在哪里？ 机器人会从三个地方找技能小盒子，并且有先后顺序：

1. 自带的技能：机器人自己出厂时就有的。
2. 大家共享的技能：放在一个叫 ~/.openclaw/skills 的公共文件夹里，所有机器人都能用。
3. 你自己工作区的技能：放在你正在工作的那个文件夹里的 skills 子文件夹里。

如果同一个技能名字出现在好几个地方，机器人会听谁的？它最听“你自己工作区”的，然后是“大家共享的”，最后才是“自带的”。你还可以在 openclaw.json 文件里告诉机器人去更多地方找技能。

怎么安装新技能？ 有一个叫 ClawHub 的“技能商店”，你可以在网上找到很多别人做好的技能。安装技能很简单：

1. 打开命令行工具。
2. 输入 clawhub install <技能的名字>，就能把技能安装到你当前的工作区。
3. 输入 clawhub update --all，可以更新所有已经安装的技能。
4. 输入 clawhub sync --all，可以检查并发布你技能的更新。

技能安全吗？要小心什么？ 从外面下载的技能，就像不认识的人给你的新玩具，要先检查一下再玩。有些技能可能需要用到一些秘密，比如密码（API Key），这些秘密会被藏好，不会随便让别人看到。如果你不确定一个技能安不安全，可以让机器人在一个安全的“沙箱”环境里先试试。

技能说明书怎么写？ 每个技能盒子里最重要的就是 SKILL.md 这个说明书。说明书开头要用一种叫 YAML 的格式写一些基本信息，比如技能的名字和它是干什么的。这里要小心：这些信息必须写在一行里，不能换行。你可以在说明书里用 {baseDir} 来代表技能盒子自己的位置。

机器人怎么决定用哪个技能？ 机器人不是所有技能都用的。它会根据一些条件来挑选，这些条件写在技能说明书的 metadata 部分。比如：

• 这个技能需要电脑上已经安装了某个小软件（requires.bins）吗？
• 这个技能需要你设置一个密码环境变量（requires.env）吗？
• 这个技能只能在苹果电脑（os: darwin）上用吗？

如果条件不满足，机器人就不会加载这个技能。如果条件都满足，或者技能说明书里没写这些条件，机器人就会加载它。

怎么打开或关闭一个技能？ 你可以在 ~/.openclaw/openclaw.json 这个设置文件里，控制每个技能。比如：

• 把 enabled 改成 false，就算安装了，机器人也不用这个技能。
• 在 env 里，可以给技能设置它需要的密码。
• 在 config 里，可以给技能一些特别的设置。

其他重要的小事情

• 机器人启动一次会话时，会决定好这次用哪些技能，中间一般不会变。除非你修改了技能文件并且开启了“技能监视器”，它才会在下一次任务时更新技能列表。
• 如果你的主机器是 Linux 电脑，但连着一台苹果电脑，而且允许在那台苹果电脑上运行命令，那么一些只能在苹果电脑上用的技能也可能变得可用。
• 机器人把技能列表告诉它的“大脑”（AI模型）时，会占用一些“字数”。技能越多、名字描述越长，占用的就越多。