OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书
查看原始文档 最近生成：2026/03/08 15:37

简要总结

vLLM

这页说明书在教你，怎么让 OpenClaw 这个工具，去认识一个叫 vLLM 的“大脑”。vLLM 就像一个很会讲故事的机器人，OpenClaw 可以和它做好朋友，让它帮忙回答问题。你可以让 OpenClaw 自己去找 vLLM 玩，也可以拉着 OpenClaw 的手，亲自带它去认识 vLLM。

五岁小孩版解释

vLLM 是一个可以运行很多种“大脑模型”的工具，就像一个超级故事机。OpenClaw 可以和它手拉手，用一种叫 OpenAI-compatible 的方式聊天。你可以把这种方式想象成一种特殊的“悄悄话”，只有它们俩能听懂。

第一步：先让 vLLM 这个“故事机”开始工作 你要先启动 vLLM，让它变成一个可以聊天的小服务器。它通常住在电脑的这个地址：http://127.0.0.1:8000/v1。你可以把它想成是故事机家的门牌号。

第二步：告诉 OpenClaw 可以去和 vLLM 玩 你需要设置一个“通行证”，告诉 OpenClaw 它被允许去找 vLLM。在你的电脑里输入这行“咒语”： export VLLM_API_KEY="vllm-local" 这就像给 OpenClaw 一张写着“vllm-local”的纸条，它拿着纸条就能去敲门了。如果 vLLM 家没有锁门（不需要密码），随便写什么纸条都行。

第三步：选一个你想用的“大脑” vLLM 家里可能有好几个不同的“大脑”（模型），每个大脑会讲不同的故事。你要告诉 OpenClaw，你想用哪一个。在你的设置文件里，找到 model 这一项，把 "vllm/your-model-id" 里的 your-model-id 换成你真正想用的大脑的名字。

让 OpenClaw 自己去发现（最简单的方法） 如果你只给了 OpenClaw 那张“通行证”纸条（设置了 VLLM_API_KEY），但没有在设置文件里写 models.providers.vllm 这一大段话，OpenClaw 就会自己跑去 vLLM 家，敲敲门问：“你家有哪些大脑呀？”（它会访问 /v1/models 这个地址）。然后它就把找到的大脑名字都记下来，以后你就可以直接用了。

亲手教 OpenClaw 认识 vLLM（更厉害的方法） 有时候你需要亲手教 OpenClaw，比如：

  1. vLLM 没住在常用的地址（baseUrl 不一样）。
  2. 你想告诉 OpenClaw 这个大脑一次能记住多长的故事（contextWindow），或者一次最多能讲多少字（maxTokens）。
  3. vLLM 家真的锁了门，需要真正的密码（apiKey）。 这时候，你就要在设置文件里，完整地写下 models.providers.vllm 那段话，把地址、密码、大脑的名字和能力都写清楚。这样 OpenClaw 就不会自己乱跑，而是严格按照你写的去做了。

如果它们玩不到一起怎么办？ 如果 OpenClaw 找不到 vLLM，你可以先自己试试，在电脑里输入： curl http://127.0.0.1:8000/v1/models 看看能不能收到 vLLM 的回应。如果它说“需要密码”（auth errors），那你可能就需要一个真正的密码（VLLM_API_KEY），或者用上面“亲手教”的方法，在设置文件里把密码写清楚。