https://jidzhang.github.io/tags/%E9%85%8D%E7%BD%AE%E6%95%99%E7%A8%8B/Recent content in 配置教程 on 疯狂的键盘Hugozh-cnSun, 12 Apr 2026 00:00:00 +0000https://jidzhang.github.io/posts/2026-04-12-openclaw-setup-guide/Sun, 12 Apr 2026 00:00:00 +0000https://jidzhang.github.io/posts/2026-04-12-openclaw-setup-guide/<h1 id="openclaw-完整配置教程从安装到深度定制">OpenClaw 完整配置教程：从安装到深度定制</h1> <blockquote> <p>一站式 AI 助手网关，连接你的所有聊天平台，驱动你的智能工作流</p> </blockquote> <h2 id="什么是-openclaw">什么是 OpenClaw</h2> <p>OpenClaw 是一个开源的 AI 助手网关（Gateway），它将大语言模型与你日常使用的聊天平台连接起来。通过一个统一的 Gateway 进程，你可以让 AI 助手同时在线 Telegram、WhatsApp、Discord、飞书、Slack 等多个平台，并赋予它执行命令、浏览网页、生成图片等能力。</p> <p><strong>核心架构：</strong> 一个长期运行的 Gateway 进程管理所有消息通道，控制平面客户端（macOS 应用、CLI、Web UI）通过 WebSocket 连接到 Gateway。</p> <hr> <h2 id="一安装">一、安装</h2> <h3 id="系统要求">系统要求</h3> <table> <thead> <tr> <th>项目</th> <th>要求</th> </tr> </thead> <tbody> <tr> <td>Node.js</td> <td>24（推荐）或 22.14+</td> </tr> <tr> <td>操作系统</td> <td>macOS / Linux / Windows（原生 + WSL2）</td> </tr> <tr> <td>包管理器</td> <td>npm（默认）/ pnpm / bun</td> </tr> </tbody> </table> <h3 id="推荐安装方式">推荐安装方式</h3> <p><strong>macOS / Linux / WSL2：</strong></p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">curl -fsSL https://openclaw.ai/install.sh <span class="p">|</span> bash </span></span></code></pre></div><p><strong>Windows (PowerShell)：</strong></p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-powershell" data-lang="powershell"><span class="line"><span class="cl"><span class="nb">iwr </span><span class="n">-useb</span> <span class="n">https</span><span class="err">:</span><span class="p">//</span><span class="n">openclaw</span><span class="p">.</span><span class="n">ai</span><span class="p">/</span><span class="n">install</span><span class="p">.</span><span class="py">ps1</span> <span class="p">|</span> <span class="nb">iex </span></span></span></code></pre></div><p>安装脚本会自动检测操作系统、安装 Node（如需要）、安装 OpenClaw 并启动引导流程。</p> <h3 id="其他安装方式">其他安装方式</h3> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># npm 全局安装</span> </span></span><span class="line"><span class="cl">npm install -g openclaw@latest </span></span><span class="line"><span class="cl">openclaw onboard --install-daemon </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># pnpm</span> </span></span><span class="line"><span class="cl">pnpm add -g openclaw@latest </span></span><span class="line"><span class="cl">pnpm approve-builds -g </span></span><span class="line"><span class="cl">openclaw onboard --install-daemon </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># 从源码</span> </span></span><span class="line"><span class="cl">git clone https://github.com/openclaw/openclaw.git </span></span><span class="line"><span class="cl"><span class="nb">cd</span> openclaw </span></span><span class="line"><span class="cl">pnpm install <span class="o">&amp;&amp;</span> pnpm ui:build <span class="o">&amp;&amp;</span> pnpm build </span></span><span class="line"><span class="cl">pnpm link --global </span></span><span class="line"><span class="cl">openclaw onboard --install-daemon </span></span></code></pre></div><h3 id="验证安装">验证安装</h3> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">openclaw --version <span class="c1"># 确认 CLI 可用</span> </span></span><span class="line"><span class="cl">openclaw doctor <span class="c1"># 检查配置问题</span> </span></span><span class="line"><span class="cl">openclaw gateway status <span class="c1"># 验证 Gateway 运行状态</span> </span></span></code></pre></div><hr> <h2 id="二目录结构">二、目录结构</h2> <p>OpenClaw 的所有状态和配置集中在 <code>~/.openclaw/</code> 目录下：</p>