极速安装体验openClaw
<h1 id="-openclaw-极速安装与全流程避坑指南从零到完美运行">🚀 OpenClaw 极速安装与全流程避坑指南：从零到完美运行</h1><p>OpenClaw 凭借其强大的 AI 自动化能力最近非常火爆。但在 Windows 环境下安装，如果不注意细节，很容易在“第一步”就卡死。本文总结了一套从<strong>底层环境搭建</strong>到<strong>后台服务运行</strong>的极速流程，适合所有想体验 OpenClaw 的朋友。</p>
<hr>
<h2 id="️-一-安装前的地基准备必看">🛠️ 一、 安装前的“地基”准备（必看！）</h2>
<p>很多朋友安装报错 <code>ENOENT</code> 或 <code>Permission denied</code>，其实是基础环境没配好。</p>
<h3 id="1-安装-nodejs-推荐使用-nvm">1. 安装 Node.js (推荐使用 nvm)</h3>
<p>OpenClaw 需 Node.js >= 22 版本。Windows 用户推荐使用 <strong>nvm</strong> 管理 node 版本，这样切换和管理更方便。<br>
<img src="https://img2024.cnblogs.com/blog/2819675/202603/2819675-20260308184028754-789223248.png"><br>
安装成功后请使用 <strong>管理员权限</strong> 打开 PowerShell，输入 <code>nvm -v</code> 验证。<br>
<img src="https://img2024.cnblogs.com/blog/2819675/202603/2819675-20260308184540700-731317004.png"></p>
<h3 id="2-必须安装-git">2. 必须安装 Git</h3>
<p>OpenClaw 许多组件需要 Git 拉取。输入 <code>git --version</code> 验证，没装请先去官网下载。<br>
<img src="https://img2024.cnblogs.com/blog/2819675/202603/2819675-20260308184906247-1675537268.png"></p>
<h3 id="3-配置镜像源与解决认证问题">3. 配置镜像源与解决认证问题</h3>
<p>国内环境下，设置 npm 镜像并强制 Git 走 HTTPS（避开 SSH 认证报错）是极速安装的关键：</p>
<pre><code class="language-powershell"># 设置 npm 镜像
npm config set registry https://registry.npmmirror.com
# 强制 Git 走 HTTPS 协议
git config --global url."https://github.com/".insteadOf git@github.com:
</code></pre>
<hr>
<h2 id="-二-极速安装步骤">📦 二、 极速安装步骤</h2>
<p>推荐使用 <code>npm</code> 全局安装，这是最省心的方式：</p>
<pre><code class="language-powershell"># 如果之前装过但报错，建议先清缓存
npm cache clean --force
# 全局安装
npm install -g openclaw@latest
</code></pre>
<p>安装完成后，输入 <code>openclaw --version</code> 看到版本号即代表本体安装成功。</p>
<hr>
<h2 id="️-三-初始化配置避坑精华">🛡️ 三、 初始化配置（避坑精华）</h2>
<p><strong>这是最关键的一步！</strong> 必须解决“权限”和“认证”问题。</p>
<h3 id="1-以管理员身份运行-powershell">1. 以管理员身份运行 PowerShell</h3>
<p><strong>右键选择“以管理员身份运行”</strong>。否则会导致后台服务安装失败，网页控制台打不开。</p>
<h3 id="2-执行引导指令">2. 执行引导指令</h3>
<pre><code class="language-powershell">openclaw onboard --install-daemon
</code></pre>
<p><img src="https://img2024.cnblogs.com/blog/2819675/202603/2819675-20260308194558023-794698277.png"><br>
一路选择 <code>Yes</code> 和 <code>QuickStart</code>。<br>
<img src="https://img2024.cnblogs.com/blog/2819675/202603/2819675-20260308194649678-798888439.png"></p>
<h3 id="3-kimi-用户划重点key-选哪个">3. Kimi 用户划重点：Key 选哪个？</h3>
<p><img src="https://img2024.cnblogs.com/blog/2819675/202603/2819675-20260308194838904-579586575.png"><br>
如果你用的是 Kimi，这一步千万别选错：</p>
<ul>
<li><strong>Auth Method</strong>：务必选 <strong><code>Kimi Code API key (subscription)</code></strong>（对应 Kimi Code 订阅页面生成的 Key）。<br>
<img src="https://img2024.cnblogs.com/blog/2819675/202603/2819675-20260308195015606-1802678694.png"></li>
<li><strong>输入 Key</strong>：粘贴你获取到的 API Key。<br>
<img src="https://img2024.cnblogs.com/blog/2819675/202603/2819675-20260308195209546-118296954.png"></li>
<li><strong>Model</strong>：推荐选 <strong><code>kimi-coding/k2p5</code></strong>，这是目前的旗舰模型，响应最快。<br>
<img src="https://img2024.cnblogs.com/blog/2819675/202603/2819675-20260308203215319-382096563.png"></li>
</ul>
<h3 id="4-关于-telegram-和其他配置">4. 关于 Telegram 和其他配置</h3>
<p><img src="https://img2024.cnblogs.com/blog/2819675/202603/2819675-20260308195509290-959562084.png"><br>
由于网络环境原因，Telegram 建议先跳过。等页面能开了再在网页端配置代理，否则配置过程中会一直报网络错误。</p>
<hr>
<h2 id="-四-启动与访问">🌐 四、 启动与访问</h2>
<p>完成配置后，系统会自动安装后台服务（Daemon）。</p>
<ul>
<li><strong>访问地址</strong>：<code>http://127.0.0.1:18789/</code><br>
<img src="https://img2024.cnblogs.com/blog/2819675/202603/2819675-20260308201705196-212809028.png"></li>
<li><strong>验证运行</strong>：关掉终端窗口，如果网页依然能正常聊天，说明后台服务安装成功！<br>
<img src="https://img2024.cnblogs.com/blog/2819675/202603/2819675-20260308201914266-1874022203.png"><br>
<img src="https://img2024.cnblogs.com/blog/2819675/202603/2819675-20260308202005297-1961968410.png"></li>
</ul>
<hr>
<h2 id="️-五-openclaw-常用指令大全">⌨️ 五、 OpenClaw 常用指令大全</h2>
<p>熟练使用这些指令，能帮你解决 99% 的问题：</p>
<h3 id="1-服务管理-daemon">1. 服务管理 (Daemon)</h3>
<ul>
<li><code>openclaw daemon status</code>：查看后台服务是否正在运行。</li>
<li><code>openclaw daemon start</code>：手动启动后台服务。</li>
<li><code>openclaw daemon stop</code>：停止后台服务。</li>
<li><code>openclaw daemon restart</code>：重启服务（修改配置后常用）。</li>
</ul>
<h3 id="2-状态与诊断">2. 状态与诊断</h3>
<ul>
<li><code>openclaw status</code>：查看当前配置的所有通道和状态。</li>
<li><code>openclaw doctor --fix</code>：<strong>【强力推荐】</strong> 自动扫描并修复不合法的配置文件。</li>
</ul>
<h3 id="3-配置管理">3. 配置管理</h3>
<ul>
<li><code>openclaw onboard</code>：想换模型、换 Key 或重新初始化时使用。</li>
</ul>
<hr>
<h3 id="-结语">💡 结语</h3>
<p>只要搞定了 <strong>Git 环境</strong> 和 <strong>管理员权限</strong>，OpenClaw 的体验非常丝滑。希望这份指南能帮你快速通关，开启你的 AI 自动化之旅！</p><br><br>
来源：https://www.cnblogs.com/lijinhuaboke/p/19686975
頁:
[1]