Hugging Face<\/strong>\uff0c\u7136\u540e\u5728\u63d0\u793a\u65f6\u8f93\u5165\u4f60\u7684 API key\uff1a<\/li>\n<\/ol>\n“`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\nopenclaw onboard –auth-choice huggingface-api-key<\/p>\n
\n3. \u5728 **Default Hugging Face model** \u4e0b\u62c9\u83dc\u5355\u4e2d\uff0c\u9009\u62e9\u4f60\u60f3\u4f7f\u7528\u7684\u6a21\u578b\uff08\u5f53\u4f60\u6709\u6709\u6548 token \u65f6\uff0c\u5217\u8868\u4f1a\u4ece Inference API \u52a0\u8f7d\uff1b\u5426\u5219\u4f1a\u663e\u793a\u5185\u7f6e\u5217\u8868\uff09\u3002\u4f60\u7684\u9009\u62e9\u4f1a\u4fdd\u5b58\u4e3a\u9ed8\u8ba4\u6a21\u578b\u3002\n4. \u4f60\u4e5f\u53ef\u4ee5\u7a0d\u540e\u5728\u914d\u7f6e\u4e2d\u8bbe\u7f6e\u6216\u66f4\u6539\u9ed8\u8ba4\u6a21\u578b\uff1a\n\n```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}\n{\n agents: {\n defaults: {\n model: { primary: "huggingface\/deepseek-ai\/DeepSeek-R1" },\n },\n },\n}\n<\/code><\/pre>\n\u975e\u4ea4\u4e92\u5f0f\u793a\u4f8b<\/h2>\n
“`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\nopenclaw onboard –non-interactive
\n –mode local
\n –auth-choice huggingface-api-key
\n –huggingface-api-key “$HF_TOKEN”<\/p>\n
\n\u8fd9\u4f1a\u5c06 `huggingface\/deepseek-ai\/DeepSeek-R1` \u8bbe\u7f6e\u4e3a\u9ed8\u8ba4\u6a21\u578b\u3002\n\n## \u73af\u5883\u8bf4\u660e\n\n\u5982\u679c Gateway \u7f51\u5173\u4f5c\u4e3a\u5b88\u62a4\u8fdb\u7a0b\u8fd0\u884c\uff08launchd\/systemd\uff09\uff0c\u8bf7\u786e\u4fdd `HUGGINGFACE_HUB_TOKEN` \u6216 `HF_TOKEN`\n\u5bf9\u6b64\u8fdb\u7a0b\u53ef\u7528\uff08\u4f8b\u5982\u653e\u5728 `~\/.openclaw\/.env` \u4e2d\uff0c\u6216\u901a\u8fc7\n`env.shellEnv` \u63d0\u4f9b\uff09\u3002\n\n## \u6a21\u578b\u53d1\u73b0\u548c\u65b0\u624b\u5f15\u5bfc\u4e0b\u62c9\u83dc\u5355\n\nOpenClaw \u901a\u8fc7\u76f4\u63a5\u8c03\u7528 **Inference \u7aef\u70b9** \u6765\u53d1\u73b0\u6a21\u578b\uff1a\n\n```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}\nGET https:\/\/router.huggingface.co\/v1\/models\n<\/code><\/pre>\n\uff08\u53ef\u9009\uff1a\u53d1\u9001 Authorization: Bearer $HUGGINGFACE_HUB_TOKEN<\/code> \u6216 $HF_TOKEN<\/code> \u4ee5\u83b7\u53d6\u5b8c\u6574\u5217\u8868\uff1b\u67d0\u4e9b\u7aef\u70b9\u5728\u672a\u8ba4\u8bc1\u65f6\u53ea\u8fd4\u56de\u5b50\u96c6\u3002\uff09\u54cd\u5e94\u91c7\u7528 OpenAI \u98ce\u683c\uff1a{ \"object\": \"list\", \"data\": [ { \"id\": \"Qwen\/Qwen3-8B\", \"owned_by\": \"Qwen\", ... }, ... ] }<\/code>\u3002<\/p>\n\u5f53\u4f60\u914d\u7f6e Hugging Face API key \u65f6\uff08\u901a\u8fc7\u65b0\u624b\u5f15\u5bfc\u3001HUGGINGFACE_HUB_TOKEN<\/code> \u6216 HF_TOKEN<\/code>\uff09\uff0cOpenClaw \u4f1a\u4f7f\u7528\u8fd9\u4e2a GET \u8bf7\u6c42\u6765\u53d1\u73b0\u53ef\u7528\u7684 chat-completion \u6a21\u578b\u3002\u5728\u4ea4\u4e92\u5f0f\u8bbe\u7f6e<\/strong>\u671f\u95f4\uff0c\u4f60\u8f93\u5165 token \u540e\u4f1a\u770b\u5230\u4e00\u4e2a Default Hugging Face model<\/strong> \u4e0b\u62c9\u83dc\u5355\uff0c\u5176\u5185\u5bb9\u6765\u81ea\u8be5\u5217\u8868\uff08\u5982\u679c\u8bf7\u6c42\u5931\u8d25\uff0c\u5219\u4f7f\u7528\u5185\u7f6e\u76ee\u5f55\uff09\u3002\u5728\u8fd0\u884c\u65f6\uff08\u4f8b\u5982 Gateway \u7f51\u5173\u542f\u52a8\u65f6\uff09\uff0c\u53ea\u8981\u5b58\u5728 key\uff0cOpenClaw \u5c31\u4f1a\u518d\u6b21\u8c03\u7528 GET<\/strong> https:\/\/router.huggingface.co\/v1\/models<\/code> \u6765\u5237\u65b0\u76ee\u5f55\u3002\u8be5\u5217\u8868\u4f1a\u4e0e\u5185\u7f6e\u76ee\u5f55\u5408\u5e76\uff08\u4ee5\u8865\u5145\u4e0a\u4e0b\u6587\u7a97\u53e3\u548c\u6210\u672c\u7b49\u5143\u6570\u636e\uff09\u3002\u5982\u679c\u8bf7\u6c42\u5931\u8d25\u6216\u672a\u8bbe\u7f6e key\uff0c\u5219\u53ea\u4f7f\u7528\u5185\u7f6e\u76ee\u5f55\u3002<\/p>\n\u6a21\u578b\u540d\u79f0\u548c\u53ef\u7f16\u8f91\u9009\u9879<\/h2>\n\n- \u6765\u81ea API \u7684\u540d\u79f0\uff1a<\/strong> \u5f53 API \u8fd4\u56de
name<\/code>\u3001title<\/code> \u6216 display_name<\/code> \u65f6\uff0c\u6a21\u578b\u663e\u793a\u540d\u79f0\u4f1a\u4ece GET \/v1\/models<\/strong> \u4e2d\u8865\u5168\uff1b\u5426\u5219\u4f1a\u4ece\u6a21\u578b id \u63a8\u5bfc\uff08\u4f8b\u5982 deepseek-ai\/DeepSeek-R1<\/code> \u2192 \u201cDeepSeek R1\u201d\uff09\u3002<\/li>\n- \u8986\u76d6\u663e\u793a\u540d\u79f0\uff1a<\/strong> \u4f60\u53ef\u4ee5\u5728\u914d\u7f6e\u4e2d\u4e3a\u6bcf\u4e2a\u6a21\u578b\u8bbe\u7f6e\u81ea\u5b9a\u4e49\u6807\u7b7e\uff0c\u4f7f\u5176\u5728 CLI \u548c UI \u4e2d\u6309\u4f60\u5e0c\u671b\u7684\u65b9\u5f0f\u663e\u793a\uff1a<\/li>\n<\/ul>\n
“`json5 theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\n{
\n agents: {
\n defaults: {
\n models: {
\n “huggingface\/deepseek-ai\/DeepSeek-R1”: { alias: “DeepSeek R1 (fast)” },
\n “huggingface\/deepseek-ai\/DeepSeek-R1:cheapest”: { alias: “DeepSeek R1 (cheap)” },
\n },
\n },
\n },
\n}<\/p>\n
\n* **\u63d0\u4f9b\u5546 \/ \u7b56\u7565\u9009\u62e9\uff1a** \u5728**\u6a21\u578b id** \u540e\u9644\u52a0\u540e\u7f00\uff0c\u4ee5\u9009\u62e9\u8def\u7531\u5668\u5982\u4f55\u6311\u9009\u540e\u7aef\uff1a\n\n * **`:fastest`** \u2014 \u6700\u9ad8\u541e\u5410\u91cf\uff08\u7531\u8def\u7531\u5668\u9009\u62e9\uff1b\u63d0\u4f9b\u5546\u9009\u62e9\u4f1a\u88ab**\u9501\u5b9a** \u2014\u2014 \u4e0d\u4f1a\u663e\u793a\u4ea4\u4e92\u5f0f\u540e\u7aef\u9009\u62e9\u5668\uff09\u3002\n * **`:cheapest`** \u2014 \u6bcf\u8f93\u51fa token \u6210\u672c\u6700\u4f4e\uff08\u7531\u8def\u7531\u5668\u9009\u62e9\uff1b\u63d0\u4f9b\u5546\u9009\u62e9\u4f1a\u88ab**\u9501\u5b9a**\uff09\u3002\n * **`:provider`** \u2014 \u5f3a\u5236\u4f7f\u7528\u7279\u5b9a\u540e\u7aef\uff08\u4f8b\u5982 `:sambanova`\u3001`:together`\uff09\u3002\n\n \u5f53\u4f60\u9009\u62e9 **:cheapest** \u6216 **:fastest** \u65f6\uff08\u4f8b\u5982\u5728\u65b0\u624b\u5f15\u5bfc\u7684\u6a21\u578b\u4e0b\u62c9\u83dc\u5355\u4e2d\uff09\uff0c\u63d0\u4f9b\u5546\u4f1a\u88ab\u9501\u5b9a\uff1a\u8def\u7531\u5668\u4f1a\u6309\u6210\u672c\u6216\u901f\u5ea6\u51b3\u5b9a\uff0c\u4e0d\u4f1a\u663e\u793a\u53ef\u9009\u7684\u201c\u504f\u597d\u7279\u5b9a\u540e\u7aef\u201d\u6b65\u9aa4\u3002\u4f60\u53ef\u4ee5\u5c06\u8fd9\u4e9b\u4f5c\u4e3a\u5355\u72ec\u6761\u76ee\u6dfb\u52a0\u5230 `models.providers.huggingface.models` \u4e2d\uff0c\u6216\u4e3a `model.primary` \u8bbe\u7f6e\u5e26\u540e\u7f00\u7684\u503c\u3002\u4f60\u4e5f\u53ef\u4ee5\u5728 [Inference Provider settings](https:\/\/hf.co\/settings\/inference-providers) \u4e2d\u8bbe\u7f6e\u9ed8\u8ba4\u987a\u5e8f\uff08\u65e0\u540e\u7f00 = \u4f7f\u7528\u8be5\u987a\u5e8f\uff09\u3002\n\n* **\u914d\u7f6e\u5408\u5e76\uff1a** \u5f53\u914d\u7f6e\u88ab\u5408\u5e76\u65f6\uff0c`models.providers.huggingface.models` \u4e2d\u5df2\u6709\u7684\u6761\u76ee\uff08\u4f8b\u5982\u5728 `models.json` \u4e2d\uff09\u4f1a\u88ab\u4fdd\u7559\u3002\u56e0\u6b64\uff0c\u4f60\u5728\u5176\u4e2d\u8bbe\u7f6e\u7684\u4efb\u4f55\u81ea\u5b9a\u4e49 `name`\u3001`alias` \u6216\u6a21\u578b\u9009\u9879\u90fd\u4f1a\u4fdd\u7559\u3002\n\n## \u6a21\u578b ID \u548c\u914d\u7f6e\u793a\u4f8b\n\n\u6a21\u578b\u5f15\u7528\u4f7f\u7528 `huggingface\/<org>\/<model>` \u5f62\u5f0f\uff08Hub \u98ce\u683c ID\uff09\u3002\u4e0b\u9762\u7684\u5217\u8868\u6765\u81ea **GET** `https:\/\/router.huggingface.co\/v1\/models`\uff1b\u4f60\u7684\u76ee\u5f55\u4e2d\u53ef\u80fd\u5305\u542b\u66f4\u591a\u5185\u5bb9\u3002\n\n**\u793a\u4f8b ID\uff08\u6765\u81ea inference \u7aef\u70b9\uff09\uff1a**\n\n| \u6a21\u578b | \u5f15\u7528\uff08\u52a0\u4e0a `huggingface\/` \u524d\u7f00\uff09 |\n| ---------------------- | ----------------------------------- |\n| DeepSeek R1 | `deepseek-ai\/DeepSeek-R1` |\n| DeepSeek V3.2 | `deepseek-ai\/DeepSeek-V3.2` |\n| Qwen3 8B | `Qwen\/Qwen3-8B` |\n| Qwen2.5 7B Instruct | `Qwen\/Qwen2.5-7B-Instruct` |\n| Qwen3 32B | `Qwen\/Qwen3-32B` |\n| Llama 3.3 70B Instruct | `meta-llama\/Llama-3.3-70B-Instruct` |\n| Llama 3.1 8B Instruct | `meta-llama\/Llama-3.1-8B-Instruct` |\n| GPT-OSS 120B | `openai\/gpt-oss-120b` |\n| GLM 4.7 | `zai-org\/GLM-4.7` |\n| Kimi K2.5 | `moonshotai\/Kimi-K2.5` |\n\n\u4f60\u53ef\u4ee5\u5728\u6a21\u578b id \u540e\u9644\u52a0 `:fastest`\u3001`:cheapest` \u6216 `:provider`\uff08\u4f8b\u5982 `:together`\u3001`:sambanova`\uff09\u3002\u8bf7\u5728 [Inference Provider settings](https:\/\/hf.co\/settings\/inference-providers) \u4e2d\u8bbe\u7f6e\u9ed8\u8ba4\u987a\u5e8f\uff1b\u5b8c\u6574\u5217\u8868\u8bf7\u53c2\u9605 [Inference Providers](https:\/\/huggingface.co\/docs\/inference-providers) \u548c **GET** `https:\/\/router.huggingface.co\/v1\/models`\u3002\n\n### \u5b8c\u6574\u914d\u7f6e\u793a\u4f8b\n\n**\u4ee5 DeepSeek R1 \u4e3a\u4e3b\u6a21\u578b\uff0cQwen \u4f5c\u4e3a\u56de\u9000\uff1a**\n\n```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}\n{\n agents: {\n defaults: {\n model: {\n primary: "huggingface\/deepseek-ai\/DeepSeek-R1",\n fallbacks: ["huggingface\/Qwen\/Qwen3-8B"],\n },\n models: {\n "huggingface\/deepseek-ai\/DeepSeek-R1": { alias: "DeepSeek R1" },\n "huggingface\/Qwen\/Qwen3-8B": { alias: "Qwen3 8B" },\n },\n },\n },\n}\n<\/code><\/pre>\n\u4ee5 Qwen \u4e3a\u9ed8\u8ba4\u6a21\u578b\uff0c\u5e76\u5305\u542b :cheapest<\/code> \u548c :fastest<\/code> \u53d8\u4f53\uff1a<\/strong><\/p>\n“`json5 theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\n{
\n agents: {
\n defaults: {
\n model: { primary: “huggingface\/Qwen\/Qwen3-8B” },
\n models: {
\n “huggingface\/Qwen\/Qwen3-8B”: { alias: “Qwen3 8B” },
\n “huggingface\/Qwen\/Qwen3-8B:cheapest”: { alias: “Qwen3 8B\uff08\u6700\u4fbf\u5b9c\uff09” },
\n “huggingface\/Qwen\/Qwen3-8B:fastest”: { alias: “Qwen3 8B\uff08\u6700\u5feb\uff09” },
\n },
\n },
\n },
\n}<\/p>\n
\n**\u5e26\u6709\u522b\u540d\u7684 DeepSeek + Llama + GPT-OSS\uff1a**\n\n```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}\n{\n agents: {\n defaults: {\n model: {\n primary: "huggingface\/deepseek-ai\/DeepSeek-V3.2",\n fallbacks: [\n "huggingface\/meta-llama\/Llama-3.3-70B-Instruct",\n "huggingface\/openai\/gpt-oss-120b",\n ],\n },\n models: {\n "huggingface\/deepseek-ai\/DeepSeek-V3.2": { alias: "DeepSeek V3.2" },\n "huggingface\/meta-llama\/Llama-3.3-70B-Instruct": { alias: "Llama 3.3 70B" },\n "huggingface\/openai\/gpt-oss-120b": { alias: "GPT-OSS 120B" },\n },\n },\n },\n}\n<\/code><\/pre>\n\u4f7f\u7528 :provider<\/code> \u5f3a\u5236\u6307\u5b9a\u7279\u5b9a\u540e\u7aef\uff1a<\/strong><\/p>\n“`json5 theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\n{
\n agents: {
\n defaults: {
\n model: { primary: “huggingface\/deepseek-ai\/DeepSeek-R1:together” },
\n models: {
\n “huggingface\/deepseek-ai\/DeepSeek-R1:together”: { alias: “DeepSeek R1 (Together)” },
\n },
\n },
\n },
\n}<\/p>\n
\n**\u591a\u4e2a Qwen \u548c DeepSeek \u6a21\u578b\uff0c\u5e26\u7b56\u7565\u540e\u7f00\uff1a**\n\n```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}\n{\n agents: {\n defaults: {\n model: { primary: "huggingface\/Qwen\/Qwen2.5-7B-Instruct:cheapest" },\n models: {\n "huggingface\/Qwen\/Qwen2.5-7B-Instruct": { alias: "Qwen2.5 7B" },\n "huggingface\/Qwen\/Qwen2.5-7B-Instruct:cheapest": { alias: "Qwen2.5 7B\uff08\u4fbf\u5b9c\uff09" },\n "huggingface\/deepseek-ai\/DeepSeek-R1:fastest": { alias: "DeepSeek R1\uff08\u5feb\u901f\uff09" },\n "huggingface\/meta-llama\/Llama-3.1-8B-Instruct": { alias: "Llama 3.1 8B" },\n },\n },\n },\n}\n<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"Hugging Face\uff08Inference\uff09 Hugging Face Inference Provider […]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-218","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/218","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=218"}],"version-history":[{"count":1,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/218\/revisions"}],"predecessor-version":[{"id":513,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/218\/revisions\/513"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=218"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=218"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=218"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}