Hugging Face (Inference)

这页讲的是怎么让 OpenClaw 使用 Hugging Face 的“推理服务”。你可以把它想成一个超级大的玩具店，里面有很多会说话的智能玩具（模型）。OpenClaw 有一个特殊的门（API），长得和 OpenAI 商店的门一样，所以它能进去和这些玩具聊天。但注意哦，这个门只用来聊天，如果你想画画、或者把文字变成声音，得去别的门。

要开始玩，你需要一把钥匙。这把钥匙叫做 HUGGINGFACE_HUB_TOKEN 或者 HF_TOKEN。它可不是普通的钥匙，是一把“精细”的钥匙，上面必须写着“可以给推理服务打电话”这个许可。

1. 第一步：拿到你的魔法钥匙。 去 Hugging Face 网站，在你的“设置”里找到“令牌”，然后创建一个新的精细令牌。记得一定要勾选“Make calls to Inference Providers”这个选项，就像在钥匙上刻上正确的咒语。

2. 第二步：告诉 OpenClaw 你要用这把钥匙。 打开你的电脑终端，输入一个魔法咒语：openclaw onboard --auth-choice huggingface-api-key。然后 OpenClaw 会问你：“你的钥匙呢？”，这时你就把刚刚拿到的那串长长的令牌密码贴进去。

3. 第三步：选一个你喜欢的智能玩具（模型）。 输入钥匙后，OpenClaw 会去那个大玩具店看看有哪些玩具可以聊天，然后列出一个菜单让你选。这个菜单叫“Default Hugging Face model”。你点一下，选一个你喜欢的（比如 DeepSeek-R1），OpenClaw 就会记住它，以后默认就用这个玩具和你聊天。

4. 第四步：以后想换玩具怎么办？ 你可以在一个叫配置文件的地方随时更改。就像在你的玩具箱上贴个新标签，写上 primary: "huggingface/deepseek-ai/DeepSeek-R1"，这样 OpenClaw 就知道你最喜欢哪个了。

重要的小提醒：

• 如果你的 OpenClaw 是像小精灵一样一直在后台运行的（比如用 launchd 或 systemd），你一定要记得把钥匙（HUGGINGFACE_HUB_TOKEN）放在它能找到的地方，比如一个叫 ~/.openclaw/.env 的小口袋里。
• 玩具店里的玩具都有名字，比如 deepseek-ai/DeepSeek-R1。你可以给它起个昵称（alias），比如“跑得最快的 DeepSeek”。
• 你还可以在玩具名字后面加“小尾巴”来提要求：
  • 加 :fastest，意思是：“我要跑得最快的那个！”（路由器会自动选）。
  • 加 :cheapest，意思是：“我要最便宜的那个！”（路由器会自动选）。
  • 加 :provider（比如 :together），意思是：“我就要某某工厂生产的那个！”（指定一个具体的后端）。 加了 :fastest 或 :cheapest 后，你就不能自己再选工厂了，路由器会帮你决定。

下面是一些配置的例子，就像搭积木的图纸：

• 主要用 DeepSeek R1，不行就换 Qwen：在配置文件里，把 primary 写成 DeepSeek，fallbacks 里写上 Qwen。
• 给玩具起昵称：在 models 部分，给每个玩具的完整名字后面加上 { alias: "你起的昵称" }。
• 用最便宜的 Qwen：把 primary 写成 "huggingface/Qwen/Qwen3-8B:cheapest"。

记住，这些配置就像你的个人玩具清单，OpenClaw 会按照你的清单来挑选玩具和你玩。