零刻 OpenClaw 部署教程（超详细）：新手入门完整指南

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

本文以零刻迷你主机为例，详解 Win11 环境下的两种安装方式、初始化配置、接入消息渠道、以及多个常见问题详解、排查解决问题方法。（全文超多图警告！）

注：本文写于 2026/03/28，部分内容可能因版本更新产生差异。

引言

零刻 SER6Pro 硬件配置详解

OpenClaw 安装前准备

OpenClaw 安装：官方脚本 or NPM 全局安装

OpenClaw 配置消息渠道

OpenClaw 首次对话与核心文件

如何卸载 OpenClaw

OpenClaw 常见问题与排查解决

🚀 读完本文你可以：

• 在零刻主机或其他Windows11电脑上成功部署 OpenClaw

• 完成 OpenClaw 初始化配置，接入飞书、微信、三种常用渠道

• 了解多个常见问题，以及遇到错误时应如何排查解决。

作为目前最热门的 AI Agent 工具，相信大家多多少少听说过 OpenClaw（龙虾），它通过自然语言自动化完成各种任务，强大的执行能力以及高度扩展性引爆全球互联网，也在中文互联网掀起一场超大型“养龙虾”风潮。

然而，OpenClaw 对于大众而言门槛较高，即便是部署 OpenClaw 也伴随着不少困难。接下来本文将以零刻 SER6Pro VEST 7735HS 为例，在 Windows 11 系统上从零部署 OpenClaw。零基础新手跟着步骤走也能成功部署。

为什么选迷你主机？ 相比传统台式机或服务器：

对比项	迷你主机（零刻 SER6Pro）	传统台式机/服务器
体积	约 0.6 L，随意放置不占空间	至少 20 L，占地方
待机功耗	8~15 W	50 W+
满载功耗	80~90 W	500 W+
噪音	日常使用几乎无声	风扇噪音大，影响作息

本教程使用云端 AI API（MiniMax），OpenClaw 本身运行非常轻量，对内存、性能要求极低。

OpenClaw 本身是一个轻量级的 AI 网关程序，对硬件要求并不高。但如果你希望它 24 小时运行、偶尔跑跑大模型 API，那么迷你主机的优势就体现出来了：

• 超小体积 ：0.6 L，随便放哪里都行
• 超低功耗 ：待机 8~15 W，24 小时开机也不用担心电费
• 静音运行 ：日常使用几乎听不到风扇声
• 性价比高 ：SER6Pro 二手裸机售价不到 1000 元

这次演示用的是零刻 SER6Pro VEST 7735HS，配置如下：

组件	规格参数
处理器	AMD Ryzen 7 7735HS（8 核 16 线程，加速频率 4.75 GHz）
内存	8GB DDR5（双通道）
存储	500 GB NVMe SSD
网络	2.5 GbE 有线 + WiFi 6E 无线
尺寸	126 × 113 × 42 mm
待机功耗	8~15 W
满载功耗	80~90 W

重要说明：这台主机演示配置的是云端大模型 API 接入 OpenClaw（以 MiniMax 为例），该主机不太适合本地部署大模型。

在开始安装 OpenClaw 之前，我们需要先确认以下软件已经安装好，将前置软件都安装好以后建议重启系统以确保安装成功。

1. Node.js（必须）

OpenClaw 是基于 Node.js 运行的，第一步先安装 Node.js。

安装方法：

去 Node.js 官网^[1] - 点击 获取Node.js” - “Windows 安装程序(.msi) 下载安装包。

推荐下载 LTS（长期支持版），安装时一路点”下一步”即可，为确保安装以及后续使用顺利，建议勾选 Automatically install the necessary tools 选项。

检查方法：

按下 Win + R，输入 cmd 回车，然后在弹出的命令提示符窗口中输入：

 
        
     
          node –version

如果显示版本号（比如 v24.x.x），说明已经安装好了。

2. Git（使用 NPM 安装时需要）

如果选择通过 NPM 方式安装 OpenClaw，需要先安装 Git。

安装方法：

到 Git 官网^[2] - 点击 Git for Windows/x64 Setup 下载安装包，安装时一路点”下一步”即可。

检查方法：

在命令提示符中输入：

 
        
     
          git –version

如果显示版本号，说明已经安装好了。

3. 代码编辑器 Notepad–（推荐）

后面可能需要编辑配置文件，推荐使用 Notepad–，这是一款轻量级的文本编辑器，支持 Window/Mac/Linux 操作系统平台，且支持语法高亮，安装时一路点击”下一步”即可。

下载链接：Notepad– Gitee^[3]

请确保电脑已经正常连接网络，部署过程中全程需要联网操作。

OpenClaw 提供多种安装方式。新手推荐官方一键安装脚本，熟悉 NPM 的用户可以使用 NPM 全局安装，详见官网安装说明：安装 OpenClaw | 手把手安装指南^[4]。

安全警告：OpenClaw 需要的权限极高，出于信息安全考虑，建议尽可能使用虚拟机或无重要文件的备用机进行部署，做好安全隔离。

这种方式最简单，脚本会自动帮我们安装好所有依赖。

步骤 1：以管理员身份打开 PowerShell

右键点击开始菜单 → 选择 终端管理员 或 PowerShell（管理员）。

步骤 2：运行安装脚本

在 PowerShell 窗口中输入以下命令并回车：

 
         
     
           irm https://openclaw.ai/install.ps1 | iex

如果遇到执行策略限制，输入这个：

 
         
     
           irm https://openclaw.ai/install.ps1 | Out-String | Invoke-Expression

安装脚本会自动：

• 检查并安装 Node.js（如未安装）
• 全局安装 OpenClaw
• 自动运行初始化

等待出现 OpenClaw is installed successfully 或类似提示，说明安装成功了！

安装成功后会自动进入初始化流程。

如果你熟悉 NPM，可以使用这种方式。

步骤 1：以管理员身份打开 PowerShell

右键点击开始菜单 → 选择 终端管理员 或 PowerShell（管理员）。

步骤 2：输入安装命令

 
         
     
           npm install -g openclaw@latest

等待提示 added xxx packages in xx 说明已经安装完成了。

注：NPM 全局安装方式需要手动运行初始化配置。

安装完成后，我们继续完成 OpenClaw 初始化配置。

如果没有自动进入初始化流程，可手动在 PowerShell 中输入以下命令开始初始化：

 
          
     
            openclaw onboard –install-daemon

跟随向导提示操作（用键盘方向键选择选项，回车键确定）：

1. 前四个步骤 ：分别选择 YES、Manual、Local Gateway，第四个步骤是工作目录，保持默认即可
2. Model/auth provider ：选择要接入的大模型，这里以 Minimax 为例，选择 MiniMax - MiniMax API Key（CN） - 输入在 MiniMax 官网创建的 API KEY（可按住 Ctrl+ 鼠标左键单击提示的链接快速进入官网，复制 API KEY 之后在 PowerShell 中按下鼠标右键即可粘贴）， Deafult model 这里选择默认的 Keep current 即可
3. 接着六个步骤 ：一路按回车即可，不建议修改
4. Channel status ： Configure chat channels now？这里我们先选择 No 跳过，后续再单独配置
5. Search provider ：这里是选择网络搜索的提供商，选择 Skip for now 跳过
6. Skills status ：Configure skills now？选择 Yes 进入技能列表，建议先安装 Clawhub 技能（技能社区，方便后续安装各式各样的技能），其他技能可以之后再让 AI 助理安装
7. 接着五个步骤 ： Preferred node manager 选择 npm 并回车，接下来四个 Set 选项全选 No 并回车
8. Enable hooks？ ：钩子，建议全选，然后回车
9. 接着两个步骤 ：分别选择 Yes 和 Node 然后回车开始安装 Gateway 网关，等待提示 Gateway service installed. 就安装成功了！
10. How do you want to hatch your bot？ ：这里选 Do this later 然后回车
11. Enable zsh shell completion for openclaw？ ：这里选 Yes 然后回车

等待提示 “Onboarding complete.” 说明初始化完成啦！

初始化完成后，会自动运行 OpenClaw gateway，可输入以下命令一键打开 Web UI：

 
          
     
            openclaw dashboard

进入 Web UI 后可随意打个招呼，得到 AI 回应说明部署完成了！

常见问题：如果输入 openclaw dashboard 命令并回车后提示无法加载文件，因为在此系统上禁止运行脚本，需要先到 Windows 设置 - 系统 - 高级 - PowerShell，开启更改执行策略选项，然后再回到 PowerShell 重新输入命令即可打开 Web UI。

初始化完成后，OpenClaw 会在用户目录下创建配置文件。Windows 系统上配置文件位于：

 
          
     
            C:\Users\你的用户名.openclaw

我们主要关注以下文件：

文件	作用
openclaw.json	核心配置文件
workspace/	工作目录，存放各种配置

后面如果需要手动修改配置，建议使用 Notepad– Gitee^[3] 打开 C:\Users\你的用户名.openclaw\openclaw.json 进行编辑。

重要说明：编辑配置文件前务必先做好备份，然后再修改！

命令	功能
`openclaw –version`	查看版本
`openclaw status`	查看状态
`openclaw doctor`	诊断修复
`openclaw onboard`	配置向导
`openclaw dashboard`	快捷打开 Control UI
`openclaw update`	一键更新 OpenClaw
`openclaw gateway start`	启动网关
`openclaw gateway stop`	停止网关
`openclaw gateway restart`	重启网关
`openclaw models list`	模型列表
`openclaw skills list`	技能列表

OpenClaw 初始化完成后，建议接入飞书、企业微信、微信、等消息渠道，方便远程指挥 AI 助理，这里以飞书、微信两种方式为例。

接入飞书方式有两种，一种是 OpenClaw 自带的飞书插件，另一种是飞书官方提供的插件。使用 OpenClaw 官方飞书插件需要手动创建机器人，相对麻烦，这边建议使用飞书官方提供的插件，能够一键创建机器人并接入 OpenClaw，非常方便，具体文档：OpenClaw 飞书官方插件^[5]。

步骤 1：以管理员身份打开 PowerShell

右键点击开始菜单 → 选择 终端管理员 或 PowerShell（管理员）。

步骤 2：运行安装脚本

在 PowerShell 窗口中输入以下命令并回车：

 
           
     
             npx -y @larksuite/openclaw-lark install

等待提示 Restart the gateway to load plugins. 说明插件安装成功啦！稍等一会会加载出一个二维码，用手机打开飞书，扫描二维码选择或创建机器人即可。

完成后会提示 Success！Bot configured 然后自动重启 OpenClaw gateway 加载飞书插件，这样就完成了！等待提示 OpenClaw is all set.（OpenClaw 已就绪） 后就可以通过飞书指挥 AI 助理啦。

提示：

可在飞书中回复 AI 助理：/feishu start 确认是否安装成功

可在飞书中回复 AI 助理：/feishu auth 批量获取权限

可在飞书中回复 AI 助理：/feishu doctor 检查配置是否正常

常见问题：

飞书插件弹出的二维码是乱码，无法扫描：这个问题可能是分辨率问题，可更换其他终端，例如 Cmder^[6] ，然后重新执行安装脚本即可。

机器人配置成功后，自动重启 OpenClaw Gateway 失败：这个问题大概率是端口冲突导致的，可尝试输入 openclaw gateway restart –force 强制重启

/feishu start 检查配置异常，提示 Profile 当前为 coding：权限问题，需要在 PowerShell 中输入 openclaw config set tools.profile “full”，然后再输入 openclaw gateway restart 重启即可

步骤 1：以管理员身份打开 PowerShell

右键点击开始菜单 → 选择 终端管理员 或 PowerShell（管理员）。

步骤 2：运行安装脚本

在 PowerShell 窗口中输入以下命令并回车：

 
           
     
             npx -y @tencent-weixin/openclaw-weixin-cli@latest install

稍等一会会弹出一个二维码，用手机打开微信扫码即可完成配对，等待提示 与微信连接成功！ 说明插件安装并成功连接微信啦！

安装并连接成功后，插件会自动重启 OpenClaw Gateway，等待自动重启即可通过微信指挥 AI 助理啦。

常见问题：

微信扫码无法配对：请确认微信已更新至最新版本，且 微信 - 我 - 设置 - 插件 中有微信 ClawBot 插件（该插件目前还在逐步开放中，部分用户暂不支持，等待后续开放即可）。

二维码无法正常显示：如果二维码没能成功显示，插件也有提供网页链接，可用 Ctrl+ 鼠标左键单击链接 ，进入网页扫码

[openclaw-weixin] 重启失败：重启失败的话可以执行命令 openclaw gateway restart 手动重启

恭喜你，OpenClaw 已经部署好了！现在开始第一次对话，让 AI 助理慢慢了解我们。

第一次和 OpenClaw 对话时，建议这样开始（内容可以自行删减、拓展）：

 
            
     
               我的基本信息： 
            
     
               
               称呼我：[你希望被怎么称呼] 
               我的时区：Asia/Shanghai 
               我的工作：[职业/行业] 
               我的爱好：[爱好] 
               我的需求：[需求 1]、[需求 2]、[需求 3] 
               沟通偏好：[严谨/轻松/幽默/其他] 
               禁忌事项：[未经确认删除、剪切文件]、[未经确认发送消息给他人] 
               可自行补充、删减 
              
 以上是我的个人信息，请帮我写入相关配置文件。” data-show-line-number=“false” style=“font-size: 90%;border-radius: 4px;display: -webkit-box;padding: 0.5em 1em 1em;overflow-x: auto;text-indent: 0;color: inherit;background: none;white-space: nowrap;margin: 0;font-family: ‘Fira Code’, Menlo, Operator Mono, Consolas, Monaco, monospace;”>你好！我来介绍一下我自己。

我的基本信息：
- 称呼我：[你希望被怎么称呼]
- 我的时区：Asia/Shanghai
- 我的工作：[职业/行业]
- 我的爱好：[爱好]
- 我的需求：[需求 1]、[需求 2]、[需求 3]
- 沟通偏好：[严谨/轻松/幽默/其他]
- 禁忌事项：[未经确认删除、剪切文件]、[未经确认发送消息给他人]
- 可自行补充、删减

以上是我的个人信息，请帮我写入相关配置文件。

OpenClaw 的工作目录（workspace）中有几个重要文件，它们决定了 AI 助理了解我们多少：

文件	作用
AGENT.md	AI 助理的行为准则、规则
SOUL.md	AI 助理的人设、性格、语气
USER.md	我们的个人信息、偏好、工作背景
IDENTITY.md	AI 助理的身份档案
TOOLS.md	工具配置，执行某些操作的说明
HEARTBEATS.md	心跳，让 AI 助理具备主动性，例如定时执行任务等
MEMORY.md（可选）	长期记忆，存放重要决策和经验

我们不必亲自编辑这些文件，让 AI 助理帮我们操作即可，例如：

 
            
     
              我希望你以后和我沟通时句尾要加一个“喵~”，然后每天早上8点跟我打个招呼。
把上述两点要求写入相关配置文件。

让它帮我们整理信息：

 
            
     
              帮我整理一下今天的工作日志，提取关键待办事项。

让它帮我们写内容：

 
            
     
              帮我写一封简短的邮件，内容是：[具体需求]，写好后先让我看下

让它记住我们的偏好：

 
            
     
              记住，我偏好简洁直接的回答风格，不要太多废话。

如果不想继续养龙虾了，应该怎么卸载？接下来我们来实际操作一遍。

使用 OpenClaw 一键安装脚本安装的卸载流程：

步骤 1：以管理员身份打开 PowerShell

右键点击开始菜单 → 选择 终端管理员 或 PowerShell（管理员）。

步骤 2：停止 OpenClaw Gateway

在 PowerShell 窗口中输入以下命令并回车：

 
             
     
               openclaw gateway stop

步骤 3：运行卸载脚本

在 PowerShell 窗口中输入以下命令并回车：

 
             
     
                注意此命令不会自动删除工作目录，需手动删除” data-show-line-number=“false” style=“font-size: 90%;border-radius: 4px;display: -webkit-box;padding: 0.5em 1em 1em;overflow-x: auto;text-indent: 0;color: inherit;background: none;white-space: nowrap;margin: 0;font-family: ‘Fira Code’, Menlo, Operator Mono, Consolas, Monaco, monospace;”>npm uninstall -g openclaw
# 注意此命令不会自动删除工作目录，需手动删除

步骤 4：验证卸载是否成功

 
             
     
                如果没有任何输出，说明已卸载成功
 openclaw –version
 如果提示红字报错，说明已卸载成功” data-show-line-number=“false” style=“font-size: 90%;border-radius: 4px;display: -webkit-box;padding: 0.5em 1em 1em;overflow-x: auto;text-indent: 0;color: inherit;background: none;white-space: nowrap;margin: 0;font-family: ‘Fira Code’, Menlo, Operator Mono, Consolas, Monaco, monospace;”>Get-Command openclaw -ErrorAction SilentlyContinue
# 如果没有任何输出，说明已卸载成功
openclaw –version
# 如果提示红字报错，说明已卸载成功

步骤 5：删除残留文件

OpenClaw 默认工作目录位于：

 
             
     
               C:\Users\你的用户名.openclaw

选中 .openclaw 文件夹后按下 Shift+Del 键即可彻底删除（无法恢复！）

这样就卸载完成啦！该卸载方法适用于 OpenClaw 一键安装脚本与 NPM 全局安装两种安装方式。

遇到任何问题时，首先运行：

 
              
     
                openclaw doctor

这个命令会自动检查安装配置、网络连通性，给出问题诊断。

也可以运行以下命令获取更多信息：

 
              
     
                 openclaw status
 查看实时日志
 openclaw logs –follow” data-show-line-number=“false” style=“font-size: 90%;border-radius: 4px;display: -webkit-box;padding: 0.5em 1em 1em;overflow-x: auto;text-indent: 0;color: inherit;background: none;white-space: nowrap;margin: 0;font-family: ‘Fira Code’, Menlo, Operator Mono, Consolas, Monaco, monospace;”># 查看详细状态
openclaw status

# 查看实时日志
openclaw logs –follow

日志中红字为报错信息、黄字为警告信息，可以截图下来，发到豆包、DeepSeek 之类的 AI 软件中，问：“这个报错是什么意思”，AI 会自动识别截图信息，给出错误分析、尝试解决方法。

需要注意的是，AI 软件给出的解决问题方法很多时候是不靠谱的，建议将 AI 给出错误分析复制到浏览器搜索，看下有没有人遇到类似的问题和解决方法。

问题	解决方案
`openclaw: command not found`	Node.js 的 PATH 环境变量问题。重新安装 Node.js，确保勾选 “Add to PATH”
通过 NPM 部署时下载速度慢	可使用国内镜像源加速，例： `npm i -g openclaw –registry=https://registry.npmmirror.com`
Gateway 无法启动	检查端口是否被占用： `lsof -i :18789` ；运行诊断： `openclaw doctor –fix` ；启动网关： `openclaw gateway –force` 如还是无法启动网关，可尝试更换端口： `openclaw config set gateway.port 18790` ，然后再次启动网关
模型调用失败	检查 API Key 是否正确，网络能否访问 AI 服务商

Q：OpenClaw 支持哪些操作系统？
A：OpenClaw 支持 Windows、macOS、Linux。新手建议在熟悉的系统下部署，方便控制。出于信息安全考虑，建议尽可能部署在虚拟机或无重要文件的主机。详情参考 OpenClaw 官方文档^[7]。

Q：零刻 SER6Pro 能跑本地大模型吗？
A：不推荐。本教程使用云端 AI API（如 MiniMax），8GB 内存完全足够 OpenClaw 日常运行。本地大模型需要更强的 GPU，成本和功耗都会大幅增加。

Q：OpenClaw 和 ChatGPT 有什么区别？
A：OpenClaw 是本地 AI 网关，支持多 AI 服务接入、数据私有化、可深度定制。ChatGPT 是云端服务，数据在 OpenAI 服务器，功能少。本质上 OpenClaw 是工具箱，ChatGPT 是一个具体工具。

Q：OpenClaw 适合哪些人群？
A：Skills 决定了 OpenClaw 的能力上限。通过安装各式各样的 Skills，OpenClaw 可以适配诸如自媒体、运营、开发、助理等等岗位工作，下面是功能参考：
自媒体：选题建议、内容创作、校对、多平台发布……
运营：调研报告、数据监测、竞品分析……
开发：代码辅助、日志分析、自动化程序…….
助理：文件整理、定时提醒、制作报告……

Q：OpenClaw 支持哪些 AI 服务？
A：OpenClaw 是一个开放的 AI 网关，支持 MiniMax、ChatGPT、GLM、Gemini 等主流 AI 服务商或本地部署 AI。具体配置方法可在 OpenClaw 官方文档^[7] 中查看。

[1] Node.js 官网: https://nodejs.org/
[2] Git 官网: https://git-scm.com/download/win
[3] Notepad– Gitee: https://gitee.com/cxasm/notepad–/releases/tag/v3.6.4
[4] 安装 OpenClaw | 手把手安装指南: https://openclaws.io/zh/install/
[5] OpenClaw 飞书官方插件: https://bytedance.larkoffice.com/docx/MFK7dDFLFoVlOGxWCv5cTXKmnMh?from=from_copylink
[6] Cmder: https://cmder.app/
[7] OpenClaw 官方文档: https://docs.openclaw.ai/zh-CN
[8] OpenClaw 官方文档: https://docs.openclaw.ai
[9] MiniMax 官网: https://www.minimaxi.com
[10] Git 官网: https://git-scm.com/
[11] Notepad– Gitee: https://gitee.com/cxasm/notepad–
[12] ClawHub 技能社区: https://clawhub.ai/

零刻 OpenClaw 部署教程（超详细）：新手入门完整指南

1. Node.js（必须）

2. Git（使用 NPM 安装时需要）

3. 代码编辑器 Notepad–（推荐）

常见问题：

常见问题：

使用 OpenClaw 一键安装脚本安装的卸载流程：

如果没有任何输出，说明已卸载成功

查看实时日志

相关推荐