爆火 OpenClaw「龙虾」从 0 到 1 保姆级全指南：安装→QQ 机器人→运维→卸载全流程，附全网高频报错解决方案

优质文章学习记录

— 13 min read
爆火 OpenClaw「龙虾」从 0 到 1 保姆级全指南：安装→QQ 机器人→运维→卸载全流程，附全网高频报错解决方案

引言：OpenClaw：一爪入魂，万事自动。

🔥 前言：为什么全网都在「养龙虾」？

最近 AI 圈顶流非 OpenClaw（昵称「龙虾」）莫属！

这个能住在你电脑里的 AI 智能体，不仅能读写本地文件、操控浏览器、自动化办公、一键搭建网站，甚至能接入 QQ 变身私人机器人，让你随时随地都能「养虾」调用。

但随之而来的是乱象丛生：网上出现数百元的上门安装服务，甚至深圳腾讯大厦门口曾出现千人排队免费安装的盛况。其实自己安装全程免费，30 分钟就能搞定，还能彻底规避他人操作电脑带来的数据泄露风险！

本文整合OpenClaw 官方权威文档+ 全网高频踩坑解决方案，带你从 0 到 1 零失败上手，从安装配置、QQ 机器人接入、日常运维到彻底卸载，保姆级一步到位，新手也能轻松玩转。

📋 前置准备与安全红线

1. 基础硬件 & 系统要求

表格

系统类型最低要求推荐配置
WindowsWindows 10 64 位Windows 11 64 位，优先使用 WSL2
macOSmacOS 12+macOS 14+，M 系列芯片
Linux内核 4.15+，1 核 1G 内存Ubuntu 22.04 LTS，2 核 2G 内存
额外要求：稳定的网络环境，用于下载依赖包和模型调用

2. 核心安全红线（必读！）

🚨 高风险提示OpenClaw 拥有本地文件读写、系统命令执行等高权限，切勿安装来源不明的第三方技能包，避免恶意代码风险AppID、AppSecret、API Key 等敏感信息切勿泄露、切勿上传到公开代码仓库新手优先在虚拟机、云服务器或备用机上测试，避免误操作影响主力机数据国内用户务必先配置 npm 国内镜像，90% 的安装失败都源于网络超时

3. 前置环境安装

OpenClaw 基于 Node.js 运行，必须满足 Node 版本≥v22，Windows 用户还需安装 Git。

步骤 1：安装 Node.js
  1. 官网下载：Node.js 官方网站，选择LTS 长期支持版本（自动附带 npm 包管理器）
  2. 安装全程默认下一步，自动配置系统环境变量
  3. 验证安装：打开终端 / PowerShell，执行以下命令，输出版本号≥v22 即为成功
node --version npm --version
步骤 2：Windows 用户必装 Git
  1. 官网下载：Git 官方网站
  2. 安装全程默认下一步，安装程序会自动配置环境变量
  3. 验证安装：PowerShell 执行以下命令，输出版本号即为成功

powershell

git --version
步骤 3：配置国内 npm 镜像（关键避坑）

国内用户直接访问官方 npm 源极易超时失败，先执行以下命令切换淘宝镜像：

# 切换国内镜像源 npm config set registry https://registry.npmmirror.com # 清理缓存，避免旧数据干扰 npm cache clean --force # 验证镜像是否切换成功 npm config get registry

🚀 全平台安装教程（官方推荐方案）

方案一：一键脚本安装（新手首选，自动处理所有依赖）

🔹 Windows 系统安装
  1. 必须右键开始菜单，选择「Windows PowerShell (管理员)」，非管理员权限会导致安装失败
  2. 复制以下命令到 PowerShell 中回车执行，脚本会自动安装所有依赖和 OpenClaw 本体

powershell

irm -useb https://openclaw.ai/install.ps1 | iex
  1. 等待安装完成，出现「OpenClaw installed successfully!」即为成功
🔹 macOS/Linux/WSL2 系统安装
  1. 打开终端，复制以下命令回车执行
curl -fsSL https://openclaw.ai/install.sh | bash
  1. 等待脚本自动完成安装，出现成功提示即可

方案二：手动安装（脚本失败备用方案）

如果一键脚本执行失败，可通过 pnpm 手动安装，稳定性更高：

  1. 先全局安装 pnpm 包管理器

npm install -g pnpm
  1. 安装 OpenClaw 最新稳定版
pnpm add -g openclaw@latest # 批准构建脚本（可选，不影响基础功能使用） pnpm approve-builds -g
  1. 验证安装是否成功
openclaw --version

终端输出版本号（如 2026.3.28），即为安装成功。

⚙️ 新手引导 & 初始化配置（关键步骤）

安装完成后，必须完成官方引导配置，才能正常使用 OpenClaw。

1. 启动官方引导程序

终端 / PowerShell 执行以下命令，启动引导向导：

bash

运行

openclaw onboard --install-daemon
关键参数说明：--install-daemon 会自动安装后台网关服务，实现开机自启，不用每次手动输命令启动

2. 引导配置分步指南（新手按这个选）

表格

配置步骤推荐选项说明
用户协议选 Yes必须同意才能继续使用
安装模式快速开始新手无需自定义，快速模式自动配置最优参数
大模型选择千问通义千问国内用户首选，免费 OSS 授权，无需额外申请 API Key，无网络限流问题
聊天渠道暂时跳过后续单独配置 QQ 机器人，更稳定
搜索服务暂时跳过需额外申请 API Key，新手后续按需配置
技能市场开启 ClawHub官方技能商店，后续可扩展功能
防火墙提示全部允许必须允许公共 + 专用网络访问，否则网关无法正常通信

3. 启动网页控制台

引导完成后，会自动打开 OpenClaw 网页控制台，若未自动打开，执行以下命令手动启动：

bash

运行

openclaw dashboard

控制台默认地址：http://127.0.0.1:18789/，浏览器打开即可看到可视化操作界面。

📱 QQ 机器人接入教程（随时随地「养虾」）

腾讯为 OpenClaw 提供了专属快捷接入通道，无需申请白名单，3 步即可搞定，让你在 QQ 里随时随地调用 OpenClaw。

步骤 1：创建 QQ 机器人

  1. 访问 QQ 开放平台 OpenClaw 专属快捷通道（QQ 扫码即可进入）
  2. 扫码登录后，点击「创建机器人」，秒级完成创建，无需审核
  3. 创建完成后，手机 QQ 会收到机器人的打招呼消息，可自行修改机器人头像、昵称

步骤 2：OpenClaw 端配置接入

  1. 开放平台页面会自动生成 3 条专属配置命令（包含你的 AppID 和 AppSecret）
  2. 复制命令，依次粘贴到终端 / PowerShell 中执行：

powershell

# 示例命令，请勿直接复制，以平台生成的专属命令为准 # 1. 添加QQ频道配置 openclaw channel add qq --app-id "你的专属AppID" --app-secret "你的专属AppSecret" # 2. 启用QQ频道 openclaw channel enable qq # 3. 重启网关生效配置 openclaw gateway restart
🚨 重要提醒：AppID 和 AppSecret 是你的机器人专属密钥，切勿泄露给他人！

步骤 3：验证接入成功

  1. 打开 OpenClaw 网页控制台，进入「频道」页面，可见 QQ 机器人状态为「已连接」
  2. 打开手机 QQ，给机器人发送消息（如「写一篇 Python 入门教程」「查看我的电脑配置」），机器人会快速响应
  3. 支持 Markdown 格式输出，代码、表格均可完美渲染，阅读体验拉满

📌 日常运维核心指南（解决你 90% 的使用问题）

这部分专门解决大家高频提问的「每次怎么启动」「怎么关闭」「要不要一直开电脑」等核心问题。

1. 一劳永逸：开机自启配置

如果初始化时没有加--install-daemon参数，执行以下命令安装后台服务，实现开机自动启动：

powershell

# 1. 安装网关系统服务（管理员权限执行） openclaw gateway install # 2. 启用开机自启 openclaw gateway enable # 3. 手动启动一次服务 schtasks /Run /TN "OpenClaw Gateway"

配置完成后，电脑开机 OpenClaw 会自动在后台运行，直接打开网页控制台 / QQ 机器人即可使用，无需输任何命令。

2. 手动启动方法

如果不想开机自启，每次使用时执行以下命令即可启动网关：

bash

运行

# 前台启动（终端窗口不能关闭，关了网关就停） openclaw gateway

3. 关闭 / 停止 OpenClaw

场景 1：临时停止后台服务

powershell

# Windows停止计划任务 schtasks /End /TN "OpenClaw Gateway" # macOS/Linux停止服务 openclaw gateway stop
场景 2：前台运行的网关

直接在运行的终端窗口按下 Ctrl + C 组合键，即可优雅停止；或直接关闭终端窗口。

场景 3：禁用开机自启（保留服务）

powershell

schtasks /Change /TN "OpenClaw Gateway" /DISABLE
场景 4：彻底卸载后台服务

bash

运行

openclaw gateway uninstall

4. 状态查看 & 故障排查

执行以下命令，即可查看网关运行状态，快速定位问题：

bash

运行

# 查看OpenClaw全局状态 openclaw status # 查看网关详细运行状态 openclaw gateway status # 实时查看运行日志，排查报错 openclaw logs --follow

5. 核心问题解答

问：在 QQ 里用 OpenClaw，是不是必须一直开着安装的电脑？答：是的。OpenClaw 的核心网关服务运行在你的电脑上，电脑关机、睡眠、断网，网关就会停止，QQ 机器人就无法响应。解决方案：可以把 OpenClaw 安装在 24 小时运行的云服务器 / 迷你主机上，就能实现随时随地不间断使用。

🛠️ 必装实用技能包推荐

通过官方 ClawHub 技能市场，可以扩展 OpenClaw 的功能，安装命令统一格式：npx clawhub@latest install 技能名

表格

技能包名称核心功能适用场景
skill-vetter扫描第三方技能包恶意代码，安全校验安装任何第三方技能前必装，保障安全
tavily-search联网搜索能力，获取全网最新数据查资讯、找资料、实时信息获取
automation-workflows多技能流程编排，实现复杂自动化任务办公自动化、定时任务、多步骤工作流
github对接 GitHub 仓库，管理代码、PR、Issue程序员开发、开源项目维护
self-improving-agent记忆用户使用习惯，自优化响应逻辑长期使用，越用越贴合你的需求
email-tools邮件收发、自动回复、邮件摘要职场邮件处理、自动提醒
实用技巧：执行 npx clawhub@latest search 关键词 ，即可搜索更多相关技能包。

🗑️ 彻底卸载教程（不留任何残留）

Windows 系统彻底卸载

powershell

# 1. 停止网关服务 openclaw gateway stop # 2. 卸载网关系统服务 openclaw gateway uninstall # 3. 全局卸载OpenClaw pnpm remove -g openclaw # 4. 删除配置文件、缓存和数据 rm -rf $env:USERPROFILE\.openclaw rm -rf $env:APPDATA\npm\node_modules\openclaw

macOS/Linux 系统彻底卸载

bash

运行

# 1. 停止网关服务 openclaw gateway stop # 2. 卸载网关系统服务 openclaw gateway uninstall # 3. 全局卸载OpenClaw pnpm remove -g openclaw # 4. 删除配置文件、缓存和数据 rm -rf ~/.openclaw rm -rf ~/.pnpm-store/*/openclaw

🚨 全网高频报错 & 避坑解决方案

1. 执行安装脚本提示「无法加载.ps1 文件，因为在此系统上禁止运行脚本」

解决方案：管理员 PowerShell 执行以下命令，修改执行策略，输入 Y 确认即可：

powershell

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

2. 执行命令提示「openclaw: command not found」

原因：npm 全局路径未添加到系统环境变量解决方案：

bash

运行

# 1. 查看npm全局安装路径 npm config get prefix # 2. 将输出的路径添加到系统环境变量的PATH中 # 3. 关闭终端，重新打开即可生效

3. 启动网关提示「Gateway service missing」

原因：未安装网关系统服务解决方案：管理员权限执行以下命令，安装并启动服务：

powershell

openclaw gateway install schtasks /Run /TN "OpenClaw Gateway"

4. 网页控制台打不开，提示「URL 拼写错误」/ 网关 unreachable

解决方案：

  1. 先执行 openclaw gateway status 查看网关是否正常运行
  2. 若网关未运行，执行 openclaw gateway 手动启动
  3. 若提示端口被占用，更换端口启动：openclaw gateway --port 18790，然后访问 http://127.0.0.1:18790/

5. 网关启动提示「端口 18789 被占用」

解决方案：

bash

运行

# Windows查看占用端口的进程PID netstat -ano | findstr :18789 # macOS/Linux查看占用端口的进程PID lsof -i :18789 # 结束占用进程（替换为实际的PID） taskkill /PID 进程PID /F # Windows kill -9 进程PID # macOS/Linux

6. QQ 机器人发送消息无响应

排查步骤：

  1. 检查 AppID 和 AppSecret 是否填写正确，有无多余空格
  2. 执行 openclaw channel status --probe 查看 QQ 频道是否正常连接
  3. 确认电脑防火墙已放行 18789 端口，无杀毒软件拦截
  4. 执行 openclaw gateway restart 重启网关，重新加载配置

📝 总结与进阶玩法

OpenClaw 作为目前最火的开源 AI 智能体，上限极高：

  • 新手可以用它实现自动化办公、文件处理、QQ 私人助手，大幅提升效率
  • 技术爱好者可以深度自定义，开发专属技能、搭建多 Agent 协作系统、接入本地化大模型、对接微信 / 飞书 / 钉钉等更多平台
  • 本文覆盖了 OpenClaw 从安装到运维的全流程，解决了 90% 的新手踩坑问题，后续我还会更新更多进阶教程，比如自定义技能开发、多 Agent 协作、云服务器部署等内容。❤️ 原创不易，觉得有用欢迎点赞 + 收藏 + 关注

Read more

自制缩小版 R2-D2 机器人、DIY 工业级紫外线表面探伤流水线、自调平旋转激光水平仪｜DF 创客周刊（第 158 期）

自制缩小版 R2-D2 机器人、DIY 工业级紫外线表面探伤流水线、自调平旋转激光水平仪｜DF 创客周刊（第 158 期）

社区公众号记录每周值得分享的创客相关内容，每周五发布～ 周刊首发于DF创客社区，欢迎投稿或推荐相关内容。 投稿邮箱：[email protected] 自制一个缩小版 R2-D2 机器人 这是一款海外创客 Tejas Shah 打造的 40%比例 3D 打印 R2-D2 机器人。 相比市面上的成品玩具，这台 R2-D2 不仅外观更精致，功能也更强大。 它的外壳和头部全部通过 3D 打印制作，并经过多次打磨与上色，表面光滑、细节丰富。 R2-D2 的“大脑”采用了树莓派 Pico W 和 Arduino Nano 双主控设计，可控制多路 LED 灯、舵机和机械臂，实现头部旋转、探测器和机械臂的动作。 底部配备了 3D

Meta-Llama-3-8B-Instruct对话逻辑：连贯性优化

Meta-Llama-3-8B-Instruct对话逻辑：连贯性优化 1. 引言 1.1 技术背景与应用需求 随着大语言模型在对话系统中的广泛应用，用户对模型输出的连贯性、上下文理解能力与指令遵循精度提出了更高要求。尽管大规模模型如Llama 3系列在性能上取得显著突破，但在实际部署中，如何保障多轮对话中的语义一致性与逻辑流畅性，仍是工程落地的关键挑战。 Meta-Llama-3-8B-Instruct作为Llama 3系列中兼顾性能与成本的中等规模模型，凭借其80亿参数、支持8k上下文和优异的指令微调表现，成为单卡部署场景下的热门选择。然而，默认推理配置下仍可能出现话题漂移、重复生成或上下文遗忘等问题，影响用户体验。 1.2 问题提出 在基于vLLM + Open WebUI构建的对话应用中，虽然推理效率高、响应速度快，但若不进行针对性优化，Meta-Llama-3-8B-Instruct在长对话或多任务切换时易出现： * 回答偏离原始意图 * 忽略历史对话关键信息 * 多轮交互后逻辑断裂 这些问题本质上源于注意力机制衰减、KV缓存管理不当及解码策略未适配对话

把 Vivado 项目放心交给 Git：一篇 FPGA 工程师必读的实战指南

之前分享过一篇文章《FPGA 版本管理三种方式：你会选哪一种？》，评论区很多人都推荐使用Git进行版本管理，今天这篇文章主题就是使用Git进行备份指南。 在 FPGA 开发中，掌握 Git 等源码管理工具已经是必备技能。 当然，在使用 Vivado 时，我们不仅需要处理源代码控制，还需要处理以 IP 为中心的设计产品。 Vivado 的工程通常是 IP 为中心 的设计，包含： * IP Integrator Block Diagram * 各类 IP 实例（独立 IP 或 BD 内 IP） * 自动生成的包装文件与工程产物 这让很多 FPGA 工程师一开始会觉得： “Vivado 项目到底该怎么和 Git 一起用？” 好消息是，从 Vivado

ComfyUI部署实战：云服务器一键启动AI绘画服务

ComfyUI部署实战：云服务器一键启动AI绘画服务 1. 引言 随着生成式人工智能技术的快速发展，AI绘画已成为内容创作领域的重要工具。在众多AI图像生成平台中，ComfyUI凭借其独特的工作流设计模式和高效的资源利用率，逐渐成为开发者和创作者的首选方案之一。本文将围绕如何在云服务器上通过镜像方式快速部署ComfyUI，实现AI绘画服务的一键启动与高效运行展开详细讲解。 当前主流的AI绘图工具多依赖图形界面操作或固定流程执行，而ComfyUI则采用基于节点的可视化工作流架构，允许用户灵活构建、切换和复用不同的生成逻辑。这种设计不仅提升了系统的可扩展性，也显著降低了显存占用，使得在普通GPU云服务器上也能流畅运行复杂模型组合。结合预置镜像的部署方式，整个环境搭建过程可缩短至分钟级，极大提升了开发与测试效率。 本文面向希望快速搭建稳定AI绘画服务的技术人员、AI应用开发者以及内容创作团队，提供一套完整、可落地的云上部署实践路径。 2. ComfyUI核心特性解析 2.1 基于节点的工作流设计 ComfyUI的核心优势在于其模块化节点系统。每个功能（如文本编码、图像解码、