{"id":69,"date":"2026-03-21T22:47:16","date_gmt":"2026-03-21T14:47:16","guid":{"rendered":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/cli-onboard\/"},"modified":"2026-03-21T23:08:55","modified_gmt":"2026-03-21T15:08:55","slug":"cli-onboard","status":"publish","type":"post","link":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/cli-onboard\/","title":{"rendered":"onboard"},"content":{"rendered":"<h1>onboard<\/h1>\n<h1><code>openclaw onboard<\/code><\/h1>\n<p>\u4ea4\u4e92\u5f0f\u65b0\u624b\u5f15\u5bfc\uff08\u672c\u5730\u6216\u8fdc\u7a0b Gateway \u7f51\u5173\u8bbe\u7f6e\uff09\u3002<\/p>\n<h2>\u76f8\u5173\u6307\u5357<\/h2>\n<ul>\n<li>CLI \u65b0\u624b\u5f15\u5bfc\u4e2d\u5fc3\uff1a<a href=\"\/start\/wizard\">CLI \u65b0\u624b\u5f15\u5bfc<\/a><\/li>\n<li>\u65b0\u624b\u5f15\u5bfc\u6982\u89c8\uff1a<a href=\"\/start\/onboarding-overview\">\u65b0\u624b\u5f15\u5bfc\u6982\u89c8<\/a><\/li>\n<li>CLI \u65b0\u624b\u5f15\u5bfc\u53c2\u8003\uff1a<a href=\"\/start\/wizard-cli-reference\">CLI \u8bbe\u7f6e\u53c2\u8003<\/a><\/li>\n<li>CLI \u81ea\u52a8\u5316\uff1a<a href=\"\/start\/wizard-cli-automation\">CLI \u81ea\u52a8\u5316<\/a><\/li>\n<li>macOS \u65b0\u624b\u5f15\u5bfc\uff1a<a href=\"\/start\/onboarding\">\u65b0\u624b\u5f15\u5bfc\uff08macOS \u5e94\u7528\uff09<\/a><\/li>\n<\/ul>\n<h2>\u793a\u4f8b<\/h2>\n<p>&#8220;`bash  theme={&#8220;theme&#8221;:{&#8220;light&#8221;:&#8221;min-light&#8221;,&#8221;dark&#8221;:&#8221;min-dark&#8221;}}<br \/>\nopenclaw onboard<br \/>\nopenclaw onboard &#8211;flow quickstart<br \/>\nopenclaw onboard &#8211;flow manual<br \/>\nopenclaw onboard &#8211;mode remote &#8211;remote-url wss:\/\/gateway-host:18789<\/p>\n<pre><code>\n\u5bf9\u4e8e\u660e\u6587\u79c1\u6709\u7f51\u7edc `ws:\/\/` \u76ee\u6807\uff08\u4ec5\u9650\u53d7\u4fe1\u4efb\u7f51\u7edc\uff09\uff0c\u8bf7\u5728\u65b0\u624b\u5f15\u5bfc\u8fdb\u7a0b\u73af\u5883\u4e2d\u8bbe\u7f6e\n`OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1`\u3002\n\n\u975e\u4ea4\u4e92\u5f0f\u81ea\u5b9a\u4e49\u63d0\u4f9b\u5546\uff1a\n\n```bash  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\nopenclaw onboard --non-interactive \n  --auth-choice custom-api-key \n  --custom-base-url &quot;https:\/\/llm.example.com\/v1&quot; \n  --custom-model-id &quot;foo-large&quot; \n  --custom-api-key &quot;$CUSTOM_API_KEY&quot; \n  --secret-input-mode plaintext \n  --custom-compatibility openai\n<\/code><\/pre>\n<p>\u5728\u975e\u4ea4\u4e92\u5f0f\u6a21\u5f0f\u4e0b\uff0c<code>--custom-api-key<\/code> \u662f\u53ef\u9009\u7684\u3002\u5982\u679c\u7701\u7565\uff0c\u65b0\u624b\u5f15\u5bfc\u4f1a\u68c0\u67e5 <code>CUSTOM_API_KEY<\/code>\u3002<\/p>\n<p>\u975e\u4ea4\u4e92\u5f0f Ollama\uff1a<\/p>\n<p>&#8220;`bash  theme={&#8220;theme&#8221;:{&#8220;light&#8221;:&#8221;min-light&#8221;,&#8221;dark&#8221;:&#8221;min-dark&#8221;}}<br \/>\nopenclaw onboard &#8211;non-interactive<br \/>\n  &#8211;auth-choice ollama<br \/>\n  &#8211;custom-base-url &#8220;http:\/\/ollama-host:11434&#8221;<br \/>\n  &#8211;custom-model-id &#8220;qwen3.5:27b&#8221;<br \/>\n  &#8211;accept-risk<\/p>\n<pre><code>\n`--custom-base-url` \u9ed8\u8ba4\u4e3a `http:\/\/127.0.0.1:11434`\u3002`--custom-model-id` \u662f\u53ef\u9009\u7684\uff1b\u5982\u679c\u7701\u7565\uff0c\u65b0\u624b\u5f15\u5bfc\u4f1a\u4f7f\u7528 Ollama \u5efa\u8bae\u7684\u9ed8\u8ba4\u503c\u3002\u50cf `kimi-k2.5:cloud` \u8fd9\u6837\u7684\u4e91\u7aef\u6a21\u578b ID \u5728\u8fd9\u91cc\u4e5f\u53ef\u7528\u3002\n\n\u5c06\u63d0\u4f9b\u5546\u5bc6\u94a5\u5b58\u50a8\u4e3a\u5f15\u7528\u800c\u4e0d\u662f\u660e\u6587\uff1a\n\n```bash  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\nopenclaw onboard --non-interactive \n  --auth-choice openai-api-key \n  --secret-input-mode ref \n  --accept-risk\n<\/code><\/pre>\n<p>\u4f7f\u7528 <code>--secret-input-mode ref<\/code> \u65f6\uff0c\u65b0\u624b\u5f15\u5bfc\u4f1a\u5199\u5165\u7531\u73af\u5883\u53d8\u91cf\u652f\u6301\u7684\u5f15\u7528\uff0c\u800c\u4e0d\u662f\u660e\u6587\u5bc6\u94a5\u503c\u3002<br \/>\n\u5bf9\u4e8e\u7531 auth-profile \u652f\u6301\u7684\u63d0\u4f9b\u5546\uff0c\u8fd9\u4f1a\u5199\u5165 <code>keyRef<\/code> \u6761\u76ee\uff1b\u5bf9\u4e8e\u81ea\u5b9a\u4e49\u63d0\u4f9b\u5546\uff0c\u8fd9\u4f1a\u5c06 <code>models.providers.&lt;id&gt;.apiKey<\/code> \u5199\u4e3a\u73af\u5883\u53d8\u91cf\u5f15\u7528\uff08\u4f8b\u5982 <code>{ source: \"env\", provider: \"default\", id: \"CUSTOM_API_KEY\" }<\/code>\uff09\u3002<\/p>\n<p>\u975e\u4ea4\u4e92\u5f0f <code>ref<\/code> \u6a21\u5f0f\u7ea6\u5b9a\uff1a<\/p>\n<ul>\n<li>\u5728\u65b0\u624b\u5f15\u5bfc\u8fdb\u7a0b\u73af\u5883\u4e2d\u8bbe\u7f6e\u63d0\u4f9b\u5546\u73af\u5883\u53d8\u91cf\uff08\u4f8b\u5982 <code>OPENAI_API_KEY<\/code>\uff09\u3002<\/li>\n<li>\u4e0d\u8981\u4f20\u9012\u5185\u8054\u5bc6\u94a5\u6807\u5fd7\uff08\u4f8b\u5982 <code>--openai-api-key<\/code>\uff09\uff0c\u9664\u975e\u8be5\u73af\u5883\u53d8\u91cf\u4e5f\u5df2\u8bbe\u7f6e\u3002<\/li>\n<li>\u5982\u679c\u4f20\u9012\u4e86\u5185\u8054\u5bc6\u94a5\u6807\u5fd7\u4f46\u672a\u8bbe\u7f6e\u6240\u9700\u73af\u5883\u53d8\u91cf\uff0c\u65b0\u624b\u5f15\u5bfc\u4f1a\u5feb\u901f\u5931\u8d25\u5e76\u63d0\u4f9b\u6307\u5f15\u3002<\/li>\n<\/ul>\n<p>\u975e\u4ea4\u4e92\u5f0f\u6a21\u5f0f\u4e2d\u7684 Gateway \u7f51\u5173\u4ee4\u724c\u9009\u9879\uff1a<\/p>\n<ul>\n<li><code>--gateway-auth token --gateway-token &lt;token&gt;<\/code> \u5b58\u50a8\u660e\u6587\u4ee4\u724c\u3002<\/li>\n<li><code>--gateway-auth token --gateway-token-ref-env &lt;name&gt;<\/code> \u5c06 <code>gateway.auth.token<\/code> \u5b58\u50a8\u4e3a\u73af\u5883\u53d8\u91cf SecretRef\u3002<\/li>\n<li><code>--gateway-token<\/code> \u548c <code>--gateway-token-ref-env<\/code> \u4e92\u65a5\u3002<\/li>\n<li><code>--gateway-token-ref-env<\/code> \u8981\u6c42\u5728\u65b0\u624b\u5f15\u5bfc\u8fdb\u7a0b\u73af\u5883\u4e2d\u5b58\u5728\u4e00\u4e2a\u975e\u7a7a\u73af\u5883\u53d8\u91cf\u3002<\/li>\n<li>\u4f7f\u7528 <code>--install-daemon<\/code> \u65f6\uff0c\u5f53\u4ee4\u724c\u8eab\u4efd\u9a8c\u8bc1\u9700\u8981\u4ee4\u724c\u65f6\uff0c\u7531 SecretRef \u7ba1\u7406\u7684 Gateway \u7f51\u5173\u4ee4\u724c\u4f1a\u88ab\u9a8c\u8bc1\uff0c\u4f46\u4e0d\u4f1a\u4ee5\u5df2\u89e3\u6790\u7684\u660e\u6587\u5f62\u5f0f\u6301\u4e45\u5316\u5230 supervisor \u670d\u52a1\u73af\u5883\u5143\u6570\u636e\u4e2d\u3002<\/li>\n<li>\u4f7f\u7528 <code>--install-daemon<\/code> \u65f6\uff0c\u5982\u679c\u4ee4\u724c\u6a21\u5f0f\u9700\u8981\u4ee4\u724c\uff0c\u800c\u914d\u7f6e\u7684\u4ee4\u724c SecretRef \u672a\u89e3\u6790\uff0c\u65b0\u624b\u5f15\u5bfc\u4f1a\u4ee5\u5c01\u95ed\u5931\u8d25\u65b9\u5f0f\u7ec8\u6b62\uff0c\u5e76\u63d0\u4f9b\u4fee\u590d\u6307\u5f15\u3002<\/li>\n<li>\u4f7f\u7528 <code>--install-daemon<\/code> \u65f6\uff0c\u5982\u679c\u540c\u65f6\u914d\u7f6e\u4e86 <code>gateway.auth.token<\/code> \u548c <code>gateway.auth.password<\/code>\uff0c\u4e14 <code>gateway.auth.mode<\/code> \u672a\u8bbe\u7f6e\uff0c\u65b0\u624b\u5f15\u5bfc\u4f1a\u963b\u6b62\u5b89\u88c5\uff0c\u76f4\u5230\u663e\u5f0f\u8bbe\u7f6e mode\u3002<\/li>\n<\/ul>\n<p>\u793a\u4f8b\uff1a<\/p>\n<p>&#8220;`bash  theme={&#8220;theme&#8221;:{&#8220;light&#8221;:&#8221;min-light&#8221;,&#8221;dark&#8221;:&#8221;min-dark&#8221;}}<br \/>\nexport OPENCLAW_GATEWAY_TOKEN=&#8221;your-token&#8221;<br \/>\nopenclaw onboard &#8211;non-interactive<br \/>\n  &#8211;mode local<br \/>\n  &#8211;auth-choice skip<br \/>\n  &#8211;gateway-auth token<br \/>\n  &#8211;gateway-token-ref-env OPENCLAW_GATEWAY_TOKEN<br \/>\n  &#8211;accept-risk<\/p>\n<pre><code>\n\u975e\u4ea4\u4e92\u5f0f\u672c\u5730 Gateway \u7f51\u5173\u5065\u5eb7\u68c0\u67e5\uff1a\n\n* \u9664\u975e\u4f60\u4f20\u9012 `--skip-health`\uff0c\u5426\u5219\u65b0\u624b\u5f15\u5bfc\u4f1a\u7b49\u5f85\u672c\u5730 Gateway \u7f51\u5173\u53ef\u8bbf\u95ee\u540e\u624d\u6210\u529f\u9000\u51fa\u3002\n* `--install-daemon` \u4f1a\u5148\u542f\u52a8\u53d7\u7ba1 Gateway \u7f51\u5173\u5b89\u88c5\u8def\u5f84\u3002\u4e0d\u4f7f\u7528\u5b83\u65f6\uff0c\u4f60\u5fc5\u987b\u5df2\u7ecf\u6709\u4e00\u4e2a\u6b63\u5728\u8fd0\u884c\u7684\u672c\u5730 Gateway \u7f51\u5173\uff0c\u4f8b\u5982 `openclaw gateway run`\u3002\n* \u5982\u679c\u4f60\u53ea\u60f3\u5728\u81ea\u52a8\u5316\u4e2d\u5199\u5165\u914d\u7f6e\/\u5de5\u4f5c\u533a\/bootstrap\uff0c\u8bf7\u4f7f\u7528 `--skip-health`\u3002\n* \u5728\u539f\u751f Windows \u4e0a\uff0c`--install-daemon` \u4f1a\u5148\u5c1d\u8bd5 Scheduled Tasks\uff1b\u5982\u679c\u4efb\u52a1\u521b\u5efa\u88ab\u62d2\u7edd\uff0c\u5219\u56de\u9000\u5230\u6bcf\u7528\u6237 Startup \u6587\u4ef6\u5939\u767b\u5f55\u9879\u3002\n\n\u5e26\u5f15\u7528\u6a21\u5f0f\u7684\u4ea4\u4e92\u5f0f\u65b0\u624b\u5f15\u5bfc\u884c\u4e3a\uff1a\n\n* \u51fa\u73b0\u63d0\u793a\u65f6\uff0c\u9009\u62e9**\u4f7f\u7528\u5bc6\u94a5\u5f15\u7528**\u3002\n* \u7136\u540e\u9009\u62e9\u4ee5\u4e0b\u4e4b\u4e00\uff1a\n  * \u73af\u5883\u53d8\u91cf\n  * \u5df2\u914d\u7f6e\u7684\u5bc6\u94a5\u63d0\u4f9b\u5546\uff08`file` \u6216 `exec`\uff09\n* \u65b0\u624b\u5f15\u5bfc\u4f1a\u5728\u4fdd\u5b58\u5f15\u7528\u524d\u6267\u884c\u5feb\u901f\u9884\u68c0\u9a8c\u8bc1\u3002\n  * \u5982\u679c\u9a8c\u8bc1\u5931\u8d25\uff0c\u65b0\u624b\u5f15\u5bfc\u4f1a\u663e\u793a\u9519\u8bef\u5e76\u8ba9\u4f60\u91cd\u8bd5\u3002\n\n\u975e\u4ea4\u4e92\u5f0f Z.AI \u7aef\u70b9\u9009\u62e9\uff1a\n\n\u6ce8\u610f\uff1a`--auth-choice zai-api-key` \u73b0\u5728\u4f1a\u4e3a\u4f60\u7684\u5bc6\u94a5\u81ea\u52a8\u68c0\u6d4b\u6700\u4f73 Z.AI \u7aef\u70b9\uff08\u4f18\u5148\u4f7f\u7528\u901a\u7528 API \u642d\u914d `zai\/glm-5`\uff09\u3002\n\u5982\u679c\u4f60\u660e\u786e\u60f3\u4f7f\u7528 GLM Coding Plan \u7aef\u70b9\uff0c\u8bf7\u9009\u62e9 `zai-coding-global` \u6216 `zai-coding-cn`\u3002\n\n```bash  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n# \u65e0\u63d0\u793a\u7aef\u70b9\u9009\u62e9\nopenclaw onboard --non-interactive \n  --auth-choice zai-coding-global \n  --zai-api-key &quot;$ZAI_API_KEY&quot;\n\n# \u5176\u4ed6 Z.AI \u7aef\u70b9\u9009\u62e9\uff1a\n# --auth-choice zai-coding-cn\n# --auth-choice zai-global\n# --auth-choice zai-cn\n<\/code><\/pre>\n<p>\u975e\u4ea4\u4e92\u5f0f Mistral \u793a\u4f8b\uff1a<\/p>\n<p>&#8220;`bash  theme={&#8220;theme&#8221;:{&#8220;light&#8221;:&#8221;min-light&#8221;,&#8221;dark&#8221;:&#8221;min-dark&#8221;}}<br \/>\nopenclaw onboard &#8211;non-interactive<br \/>\n  &#8211;auth-choice mistral-api-key<br \/>\n  &#8211;mistral-api-key &#8220;$MISTRAL_API_KEY&#8221;<\/p>\n<pre><code>\n\u6d41\u7a0b\u8bf4\u660e\uff1a\n\n* `quickstart`\uff1a\u6700\u5c11\u63d0\u793a\uff0c\u81ea\u52a8\u751f\u6210 Gateway \u7f51\u5173\u4ee4\u724c\u3002\n* `manual`\uff1a\u63d0\u4f9b\u7aef\u53e3\/\u7ed1\u5b9a\/\u8eab\u4efd\u9a8c\u8bc1\u7684\u5b8c\u6574\u63d0\u793a\uff08`advanced` \u7684\u522b\u540d\uff09\u3002\n* \u672c\u5730\u65b0\u624b\u5f15\u5bfc\u79c1\u4fe1\u8303\u56f4\u884c\u4e3a\uff1a[CLI \u8bbe\u7f6e\u53c2\u8003](\/start\/wizard-cli-reference#outputs-and-internals)\u3002\n* \u6700\u5feb\u5f00\u59cb\u7b2c\u4e00\u6b21\u804a\u5929\uff1a`openclaw dashboard`\uff08\u63a7\u5236 UI\uff0c\u65e0\u9700\u8bbe\u7f6e\u6e20\u9053\uff09\u3002\n* \u81ea\u5b9a\u4e49\u63d0\u4f9b\u5546\uff1a\u8fde\u63a5\u4efb\u4f55\u517c\u5bb9 OpenAI \u6216 Anthropic \u7684\u7aef\u70b9\uff0c\n  \u5305\u62ec\u672a\u5217\u51fa\u7684\u6258\u7ba1\u63d0\u4f9b\u5546\u3002\u4f7f\u7528 Unknown \u8fdb\u884c\u81ea\u52a8\u68c0\u6d4b\u3002\n\n## \u5e38\u89c1\u540e\u7eed\u547d\u4ee4\n\n```bash  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\nopenclaw configure\nopenclaw agents add &lt;name&gt;\n<\/code><\/pre>\n<p>\n  <code>--json<\/code> \u4e0d\u4ee3\u8868\u975e\u4ea4\u4e92\u5f0f\u6a21\u5f0f\u3002\u811a\u672c\u8bf7\u4f7f\u7528 <code>--non-interactive<\/code>\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"<p>onboard openclaw onboard \u4ea4\u4e92\u5f0f\u65b0\u624b\u5f15\u5bfc\uff08\u672c\u5730\u6216\u8fdc\u7a0b Gateway \u7f51\u5173\u8bbe\u7f6e\uff09\u3002 \u76f8 [&hellip;]<\/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-69","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/69","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=69"}],"version-history":[{"count":1,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/69\/revisions"}],"predecessor-version":[{"id":364,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/69\/revisions\/364"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=69"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=69"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=69"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}