{"id":161,"date":"2026-03-21T22:47:20","date_gmt":"2026-03-21T14:47:20","guid":{"rendered":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/install-index\/"},"modified":"2026-03-21T23:23:49","modified_gmt":"2026-03-21T15:23:49","slug":"install-index","status":"publish","type":"post","link":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/install-index\/","title":{"rendered":"\u5b89\u88c5"},"content":{"rendered":"<h1>&#23433;&#35013;<\/h1>\n<p>&#24050;&#32463;&#25353;&#29031; <a href=\"\/start\/getting-started\">&#20837;&#38376;&#25351;&#21335;<\/a> &#25805;&#20316;&#36807;&#20102;&#21527;&#65311;&#37027;&#20320;&#24050;&#32463;&#20934;&#22791;&#22909;&#20102; &mdash;&mdash; &#26412;&#39029;&#36866;&#29992;&#20110;&#20854;&#20182;&#23433;&#35013;&#26041;&#27861;&#12289;&#29305;&#23450;&#24179;&#21488;&#35828;&#26126;&#20197;&#21450;&#32500;&#25252;&#25805;&#20316;&#12290;<\/p>\n<h2>&#31995;&#32479;&#35201;&#27714;<\/h2>\n<ul>\n<li><strong><a href=\"\/install\/node\">Node 24&#65288;&#25512;&#33616;&#65289;<\/a><\/strong>&#65288;&#20986;&#20110;&#20860;&#23481;&#24615;&#32771;&#34385;&#65292;&#20173;&#25903;&#25345; Node 22 LTS&#65292;&#30446;&#21069;&#20026; <code>22.16+<\/code>&#65307;&#22914;&#26524;&#32570;&#22833;&#65292;<a href=\"#install-methods\">&#23433;&#35013;&#33050;&#26412;<\/a> &#20250;&#23433;&#35013; Node 24&#65289;<\/li>\n<li>macOS&#12289;Linux &#25110; Windows<\/li>\n<li>&#20165;&#24403;&#20320;&#20174;&#28304;&#30721;&#26500;&#24314;&#26102;&#38656;&#35201; <code>pnpm<\/code><\/li>\n<\/ul>\n<p>\n  &#22312; Windows &#19978;&#65292;&#25105;&#20204;&#24378;&#28872;&#24314;&#35758;&#20320;&#22312; <a href=\"https:\/\/learn.microsoft.com\/en-us\/windows\/wsl\/install\">WSL2<\/a> &#19979;&#36816;&#34892; OpenClaw&#12290;\n<\/p>\n<h2>&#23433;&#35013;&#26041;&#27861;<\/h2>\n<p>\n  <strong>&#23433;&#35013;&#33050;&#26412;<\/strong> &#26159;&#23433;&#35013; OpenClaw &#30340;&#25512;&#33616;&#26041;&#24335;&#12290;&#23427;&#20250;&#19968;&#27493;&#23436;&#25104; Node &#26816;&#27979;&#12289;&#23433;&#35013;&#21644;&#26032;&#25163;&#24341;&#23548;&#12290;\n<\/p>\n<p>\n  &#23545;&#20110; VPS\/&#20113;&#20027;&#26426;&#65292;&#23613;&#37327;&#36991;&#20813;&#20351;&#29992;&#31532;&#19977;&#26041;&ldquo;&#19968;&#38190;&#24335;&rdquo;&#24066;&#22330;&#38236;&#20687;&#12290;&#20248;&#20808;&#36873;&#25321;&#24178;&#20928;&#30340;&#22522;&#30784; OS &#38236;&#20687;&#65288;&#20363;&#22914; Ubuntu LTS&#65289;&#65292;&#28982;&#21518;&#20351;&#29992;&#23433;&#35013;&#33050;&#26412;&#33258;&#34892;&#23433;&#35013; OpenClaw&#12290;\n<\/p>\n<p>    &#19979;&#36733; CLI&#65292;&#36890;&#36807; npm &#20840;&#23616;&#23433;&#35013;&#65292;&#24182;&#21551;&#21160;&#35774;&#32622;&#21521;&#23548;&#12290;<\/p>\n<pre><code>&lt;Tabs&gt;\n  &lt;Tab title=\"macOS \/ Linux \/ WSL2\"&gt;\n    ```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\n    curl -fsSL https:\/\/openclaw.ai\/install.sh | bash\n    ```\n  &lt;\/Tab&gt;\n\n  &lt;Tab title=\"Windows (PowerShell)\"&gt;\n    ```powershell  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\n    iwr -useb https:\/\/openclaw.ai\/install.ps1 | iex\n    ```\n  &lt;\/Tab&gt;\n&lt;\/Tabs&gt;\n\n&#23601;&#36825;&#26679; &mdash;&mdash; &#33050;&#26412;&#20250;&#22788;&#29702; Node &#26816;&#27979;&#12289;&#23433;&#35013;&#21644;&#26032;&#25163;&#24341;&#23548;&#12290;\n\n&#22914;&#26524;&#35201;&#36339;&#36807;&#26032;&#25163;&#24341;&#23548;&#65292;&#21482;&#23433;&#35013;&#20108;&#36827;&#21046;&#25991;&#20214;&#65306;\n\n&lt;Tabs&gt;\n  &lt;Tab title=\"macOS \/ Linux \/ WSL2\"&gt;\n    ```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\n    curl -fsSL https:\/\/openclaw.ai\/install.sh | bash -s -- --no-onboard\n    ```\n  &lt;\/Tab&gt;\n\n  &lt;Tab title=\"Windows (PowerShell)\"&gt;\n    ```powershell  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\n    &amp; ([scriptblock]::Create((iwr -useb https:\/\/openclaw.ai\/install.ps1))) -NoOnboard\n    ```\n  &lt;\/Tab&gt;\n&lt;\/Tabs&gt;\n\n&#25152;&#26377;&#26631;&#24535;&#12289;&#29615;&#22659;&#21464;&#37327;&#20197;&#21450; CI\/&#33258;&#21160;&#21270;&#36873;&#39033;&#65292;&#35831;&#21442;&#38405; [Installer internals](\/install\/installer)&#12290;\n<\/code><\/pre>\n<\/p>\n<p>\n    &#22914;&#26524;&#20320;&#24050;&#32463;&#33258;&#34892;&#31649;&#29702; Node&#65292;&#25105;&#20204;&#25512;&#33616;&#20351;&#29992; Node 24&#12290;&#20986;&#20110;&#20860;&#23481;&#24615;&#32771;&#34385;&#65292;OpenClaw &#20173;&#25903;&#25345; Node 22 LTS&#65292;&#30446;&#21069;&#20026; <code>22.16+<\/code>&#65306;<\/p>\n<pre><code>&lt;Tabs&gt;\n  &lt;Tab title=\"npm\"&gt;\n    ```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\n    npm install -g openclaw@latest\n    openclaw onboard --install-daemon\n    ```\n\n    &lt;Accordion title=\"sharp &#26500;&#24314;&#38169;&#35823;&#65311;\"&gt;\n      &#22914;&#26524;&#20320;&#20840;&#23616;&#23433;&#35013;&#20102; libvips&#65288;&#22312; macOS &#19978;&#36890;&#36807; Homebrew &#24456;&#24120;&#35265;&#65289;&#65292;&#24182;&#19988; `sharp` &#22833;&#36133;&#65292;&#35831;&#24378;&#21046;&#20351;&#29992;&#39044;&#26500;&#24314;&#20108;&#36827;&#21046;&#25991;&#20214;&#65306;\n\n      ```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\n      SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest\n      ```\n\n      &#22914;&#26524;&#20320;&#30475;&#21040; `sharp: Please add node-gyp to your dependencies`&#65292;&#35831;&#23433;&#35013;&#26500;&#24314;&#24037;&#20855;&#38142;&#65288;macOS&#65306;Xcode CLT + `npm install -g node-gyp`&#65289;&#65292;&#25110;&#32773;&#20351;&#29992;&#19978;&#38754;&#30340;&#29615;&#22659;&#21464;&#37327;&#12290;\n    &lt;\/Accordion&gt;\n  &lt;\/Tab&gt;\n\n  &lt;Tab title=\"pnpm\"&gt;\n    ```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\n    pnpm add -g openclaw@latest\n    pnpm approve-builds -g        # &#25209;&#20934; openclaw&#12289;node-llama-cpp&#12289;sharp &#31561;\n    openclaw onboard --install-daemon\n    ```\n\n    &lt;Note&gt;\n      `pnpm` &#35201;&#27714;&#23545;&#24102;&#26377;&#26500;&#24314;&#33050;&#26412;&#30340;&#21253;&#36827;&#34892;&#26174;&#24335;&#25209;&#20934;&#12290;&#39318;&#27425;&#23433;&#35013;&#20986;&#29616; &ldquo;Ignored build scripts&rdquo; &#35686;&#21578;&#21518;&#65292;&#36816;&#34892; `pnpm approve-builds -g` &#24182;&#36873;&#25321;&#21015;&#20986;&#30340;&#21253;&#12290;\n    &lt;\/Note&gt;\n  &lt;\/Tab&gt;\n&lt;\/Tabs&gt;\n\n&#24819;&#36890;&#36807;&#21253;&#31649;&#29702;&#22120;&#23433;&#35013;&#24403;&#21069; GitHub `main` &#20998;&#25903;&#26368;&#26032;&#29256;&#26412;&#65311;\n\n```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\nnpm install -g github:openclaw\/openclaw#main\n```\n\n```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\npnpm add -g github:openclaw\/openclaw#main\n```\n<\/code><\/pre>\n<\/p>\n<p>\n    &#36866;&#29992;&#20110;&#36129;&#29486;&#32773;&#25110;&#20219;&#20309;&#24819;&#20174;&#26412;&#22320;&#26816;&#20986;&#36816;&#34892;&#30340;&#20154;&#12290;<\/p>\n<pre><code>&lt;Steps&gt;\n  &lt;Step title=\"&#20811;&#38534;&#24182;&#26500;&#24314;\"&gt;\n    &#20811;&#38534; [OpenClaw &#20179;&#24211;](https:\/\/github.com\/openclaw\/openclaw) &#24182;&#26500;&#24314;&#65306;\n\n    ```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\n    git clone https:\/\/github.com\/openclaw\/openclaw.git\n    cd openclaw\n    pnpm install\n    pnpm ui:build\n    pnpm build\n    ```\n  &lt;\/Step&gt;\n\n  &lt;Step title=\"&#38142;&#25509; CLI\"&gt;\n    &#35753; `openclaw` &#21629;&#20196;&#22312;&#20840;&#23616;&#21487;&#29992;&#65306;\n\n    ```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\n    pnpm link --global\n    ```\n\n    &#25110;&#32773;&#65292;&#20320;&#20063;&#21487;&#20197;&#36339;&#36807;&#38142;&#25509;&#65292;&#30452;&#25509;&#22312;&#20179;&#24211;&#20869;&#36890;&#36807; `pnpm openclaw ...` &#36816;&#34892;&#21629;&#20196;&#12290;\n  &lt;\/Step&gt;\n\n  &lt;Step title=\"&#36816;&#34892;&#26032;&#25163;&#24341;&#23548;\"&gt;\n    ```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\n    openclaw onboard --install-daemon\n    ```\n  &lt;\/Step&gt;\n&lt;\/Steps&gt;\n\n&#26356;&#28145;&#20837;&#30340;&#24320;&#21457;&#24037;&#20316;&#27969;&#35831;&#21442;&#38405; [Setup](\/start\/setup)&#12290;\n<\/code><\/pre>\n<\/p>\n<h2>&#20854;&#20182;&#23433;&#35013;&#26041;&#27861;<\/h2>\n<p>    &#23481;&#22120;&#21270;&#25110;&#26080;&#22836;&#37096;&#32626;&#12290;\n  <\/p>\n<p>\n    &#26080; root &#23481;&#22120;&#65306;&#20808;&#36816;&#34892;&#19968;&#27425; <code>setup-podman.sh<\/code>&#65292;&#28982;&#21518;&#36816;&#34892;&#21551;&#21160;&#33050;&#26412;&#12290;\n  <\/p>\n<p>\n    &#36890;&#36807; Nix &#36827;&#34892;&#22768;&#26126;&#24335;&#23433;&#35013;&#12290;\n  <\/p>\n<p>\n    &#33258;&#21160;&#21270;&#25209;&#37327;&#37197;&#32622;&#12290;\n  <\/p>\n<p>\n    &#36890;&#36807; Bun &#36816;&#34892;&#26102;&#36827;&#34892;&#20165; CLI &#20351;&#29992;&#12290;<\/p>\n<h2>&#23433;&#35013;&#21518;<\/h2>\n<p>&#39564;&#35777;&#19968;&#20999;&#26159;&#21542;&#27491;&#24120;&#24037;&#20316;&#65306;<\/p>\n<p><code>bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}<br \/>\nopenclaw doctor         # &#26816;&#26597;&#37197;&#32622;&#38382;&#39064;<br \/>\nopenclaw status         # Gateway &#32593;&#20851;&#29366;&#24577;<br \/>\nopenclaw dashboard      # &#25171;&#24320;&#27983;&#35272;&#22120; UI<\/code><\/p>\n<p>&#22914;&#26524;&#20320;&#38656;&#35201;&#33258;&#23450;&#20041;&#36816;&#34892;&#26102;&#36335;&#24452;&#65292;&#35831;&#20351;&#29992;&#65306;<\/p>\n<ul>\n<li><code>OPENCLAW_HOME<\/code> &#29992;&#20110;&#22522;&#20110;&#20027;&#30446;&#24405;&#30340;&#20869;&#37096;&#36335;&#24452;<\/li>\n<li><code>OPENCLAW_STATE_DIR<\/code> &#29992;&#20110;&#21487;&#21464;&#29366;&#24577;&#20301;&#32622;<\/li>\n<li><code>OPENCLAW_CONFIG_PATH<\/code> &#29992;&#20110;&#37197;&#32622;&#25991;&#20214;&#20301;&#32622;<\/li>\n<\/ul>\n<p>&#26377;&#20851;&#20248;&#20808;&#32423;&#21644;&#23436;&#25972;&#32454;&#33410;&#65292;&#35831;&#21442;&#38405; <a href=\"\/help\/environment\">Environment vars<\/a>&#12290;<\/p>\n<h2>&#25925;&#38556;&#25490;&#38500;&#65306;&#25214;&#19981;&#21040; <code>openclaw<\/code><\/h2>\n<p>\n  &#24555;&#36895;&#35786;&#26029;&#65306;<\/p>\n<p><code>bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}<br \/>\n  node -v<br \/>\n  npm -v<br \/>\n  npm prefix -g<br \/>\n  echo \"$PATH\"<\/code><\/p>\n<p>&#22914;&#26524; <code>$(npm prefix -g)\/bin<\/code>&#65288;macOS\/Linux&#65289;&#25110; <code>$(npm prefix -g)<\/code>&#65288;Windows&#65289;<strong>&#19981;&#22312;<\/strong>&#20320;&#30340; <code>$PATH<\/code> &#20013;&#65292;&#37027;&#20040;&#20320;&#30340; shell &#23601;&#25214;&#19981;&#21040;&#20840;&#23616; npm &#20108;&#36827;&#21046;&#25991;&#20214;&#65288;&#21253;&#25324; <code>openclaw<\/code>&#65289;&#12290;<\/p>\n<p>&#20462;&#22797;&#26041;&#27861; &mdash;&mdash; &#23558;&#20854;&#28155;&#21152;&#21040;&#20320;&#30340; shell &#21551;&#21160;&#25991;&#20214;&#65288;<code>~\/.zshrc<\/code> &#25110; <code>~\/.bashrc<\/code>&#65289;&#20013;&#65306;<\/p>\n<p><code>bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}<br \/>\n  export PATH=\"$(npm prefix -g)\/bin:$PATH\"<\/code><\/p>\n<p>&#22312; Windows &#19978;&#65292;&#23558; <code>npm prefix -g<\/code> &#30340;&#36755;&#20986;&#28155;&#21152;&#21040;&#20320;&#30340; PATH &#20013;&#12290;<\/p>\n<p>&#28982;&#21518;&#25171;&#24320;&#19968;&#20010;&#26032;&#30340;&#32456;&#31471;&#65288;&#25110;&#32773;&#22312; zsh &#20013;&#36816;&#34892; <code>rehash<\/code>&#65292;&#22312; bash &#20013;&#36816;&#34892; <code>hash -r<\/code>&#65289;&#12290;\n<\/p>\n<h2>&#26356;&#26032; \/ &#21368;&#36733;<\/h2>\n<p>    &#35753; OpenClaw &#20445;&#25345;&#26368;&#26032;&#12290;\n  <\/p>\n<p>\n    &#36801;&#31227;&#21040;&#26032;&#26426;&#22120;&#12290;\n  <\/p>\n<p>\n    &#23436;&#20840;&#31227;&#38500; OpenClaw&#12290;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>&#23433;&#35013; &#24050;&#32463;&#25353;&#29031; &#038;#208 [&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-161","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/161","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=161"}],"version-history":[{"count":2,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/161\/revisions"}],"predecessor-version":[{"id":796,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/161\/revisions\/796"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=161"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=161"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=161"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}