引言OpenClaw一爪入魂万事自动。 前言为什么全网都在「养龙虾」最近 AI 圈顶流非 OpenClaw昵称「龙虾」莫属这个能住在你电脑里的 AI 智能体不仅能读写本地文件、操控浏览器、自动化办公、一键搭建网站甚至能接入 QQ 变身私人机器人让你随时随地都能「养虾」调用。但随之而来的是乱象丛生网上出现数百元的上门安装服务甚至深圳腾讯大厦门口曾出现千人排队免费安装的盛况。其实自己安装全程免费30 分钟就能搞定还能彻底规避他人操作电脑带来的数据泄露风险本文整合OpenClaw 官方权威文档 全网高频踩坑解决方案带你从 0 到 1 零失败上手从安装配置、QQ 机器人接入、日常运维到彻底卸载保姆级一步到位新手也能轻松玩转。 前置准备与安全红线1. 基础硬件 系统要求表格系统类型最低要求推荐配置WindowsWindows 10 64 位Windows 11 64 位优先使用 WSL2macOSmacOS 12macOS 14M 系列芯片Linux内核 4.151 核 1G 内存Ubuntu 22.04 LTS2 核 2G 内存额外要求稳定的网络环境用于下载依赖包和模型调用2. 核心安全红线必读 高风险提示OpenClaw 拥有本地文件读写、系统命令执行等高权限切勿安装来源不明的第三方技能包避免恶意代码风险AppID、AppSecret、API Key 等敏感信息切勿泄露、切勿上传到公开代码仓库新手优先在虚拟机、云服务器或备用机上测试避免误操作影响主力机数据国内用户务必先配置 npm 国内镜像90% 的安装失败都源于网络超时3. 前置环境安装OpenClaw 基于 Node.js 运行必须满足 Node 版本≥v22Windows 用户还需安装 Git。步骤 1安装 Node.js官网下载Node.js 官方网站选择LTS 长期支持版本自动附带 npm 包管理器安装全程默认下一步自动配置系统环境变量验证安装打开终端 / PowerShell执行以下命令输出版本号≥v22 即为成功node --version npm --version步骤 2Windows 用户必装 Git官网下载Git 官方网站安装全程默认下一步安装程序会自动配置环境变量验证安装PowerShell 执行以下命令输出版本号即为成功powershellgit --version步骤 3配置国内 npm 镜像关键避坑国内用户直接访问官方 npm 源极易超时失败先执行以下命令切换淘宝镜像# 切换国内镜像源 npm config set registry https://registry.npmmirror.com # 清理缓存避免旧数据干扰 npm cache clean --force # 验证镜像是否切换成功 npm config get registry 全平台安装教程官方推荐方案方案一一键脚本安装新手首选自动处理所有依赖 Windows 系统安装必须右键开始菜单选择「Windows PowerShell (管理员)」非管理员权限会导致安装失败复制以下命令到 PowerShell 中回车执行脚本会自动安装所有依赖和 OpenClaw 本体powershellirm -useb https://openclaw.ai/install.ps1 | iex等待安装完成出现「OpenClaw installed successfully!」即为成功 macOS/Linux/WSL2 系统安装打开终端复制以下命令回车执行curl -fsSL https://openclaw.ai/install.sh | bash等待脚本自动完成安装出现成功提示即可方案二手动安装脚本失败备用方案如果一键脚本执行失败可通过 pnpm 手动安装稳定性更高先全局安装 pnpm 包管理器npm install -g pnpm安装 OpenClaw 最新稳定版pnpm add -g openclawlatest # 批准构建脚本可选不影响基础功能使用 pnpm approve-builds -g验证安装是否成功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 机器人访问 QQ 开放平台 OpenClaw 专属快捷通道QQ 扫码即可进入扫码登录后点击「创建机器人」秒级完成创建无需审核创建完成后手机 QQ 会收到机器人的打招呼消息可自行修改机器人头像、昵称步骤 2OpenClaw 端配置接入开放平台页面会自动生成 3 条专属配置命令包含你的 AppID 和 AppSecret复制命令依次粘贴到终端 / 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验证接入成功打开 OpenClaw 网页控制台进入「频道」页面可见 QQ 机器人状态为「已连接」打开手机 QQ给机器人发送消息如「写一篇 Python 入门教程」「查看我的电脑配置」机器人会快速响应支持 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 gateway3. 关闭 / 停止 OpenClaw场景 1临时停止后台服务powershell# Windows停止计划任务 schtasks /End /TN OpenClaw Gateway # macOS/Linux停止服务 openclaw gateway stop场景 2前台运行的网关直接在运行的终端窗口按下Ctrl C组合键即可优雅停止或直接关闭终端窗口。场景 3禁用开机自启保留服务powershellschtasks /Change /TN OpenClaw Gateway /DISABLE场景 4彻底卸载后台服务bash运行openclaw gateway uninstall4. 状态查看 故障排查执行以下命令即可查看网关运行状态快速定位问题bash运行# 查看OpenClaw全局状态 openclaw status # 查看网关详细运行状态 openclaw gateway status # 实时查看运行日志排查报错 openclaw logs --follow5. 核心问题解答问在 QQ 里用 OpenClaw是不是必须一直开着安装的电脑答是的。OpenClaw 的核心网关服务运行在你的电脑上电脑关机、睡眠、断网网关就会停止QQ 机器人就无法响应。解决方案可以把 OpenClaw 安装在 24 小时运行的云服务器 / 迷你主机上就能实现随时随地不间断使用。️ 必装实用技能包推荐通过官方 ClawHub 技能市场可以扩展 OpenClaw 的功能安装命令统一格式npx clawhublatest install 技能名表格技能包名称核心功能适用场景skill-vetter扫描第三方技能包恶意代码安全校验安装任何第三方技能前必装保障安全tavily-search联网搜索能力获取全网最新数据查资讯、找资料、实时信息获取automation-workflows多技能流程编排实现复杂自动化任务办公自动化、定时任务、多步骤工作流github对接 GitHub 仓库管理代码、PR、Issue程序员开发、开源项目维护self-improving-agent记忆用户使用习惯自优化响应逻辑长期使用越用越贴合你的需求email-tools邮件收发、自动回复、邮件摘要职场邮件处理、自动提醒实用技巧执行npx clawhublatest 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\openclawmacOS/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 确认即可powershellSet-ExecutionPolicy -Scope CurrentUser RemoteSigned2. 执行命令提示「openclaw: command not found」原因npm 全局路径未添加到系统环境变量解决方案bash运行# 1. 查看npm全局安装路径 npm config get prefix # 2. 将输出的路径添加到系统环境变量的PATH中 # 3. 关闭终端重新打开即可生效3. 启动网关提示「Gateway service missing」原因未安装网关系统服务解决方案管理员权限执行以下命令安装并启动服务powershellopenclaw gateway install schtasks /Run /TN OpenClaw Gateway4. 网页控制台打不开提示「URL 拼写错误」/ 网关 unreachable解决方案先执行openclaw gateway status查看网关是否正常运行若网关未运行执行openclaw gateway手动启动若提示端口被占用更换端口启动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/Linux6. QQ 机器人发送消息无响应排查步骤检查 AppID 和 AppSecret 是否填写正确有无多余空格执行openclaw channel status --probe查看 QQ 频道是否正常连接确认电脑防火墙已放行 18789 端口无杀毒软件拦截执行openclaw gateway restart重启网关重新加载配置 总结与进阶玩法OpenClaw 作为目前最火的开源 AI 智能体上限极高新手可以用它实现自动化办公、文件处理、QQ 私人助手大幅提升效率技术爱好者可以深度自定义开发专属技能、搭建多 Agent 协作系统、接入本地化大模型、对接微信 / 飞书 / 钉钉等更多平台本文覆盖了 OpenClaw 从安装到运维的全流程解决了 90% 的新手踩坑问题后续我还会更新更多进阶教程比如自定义技能开发、多 Agent 协作、云服务器部署等内容。❤️原创不易觉得有用欢迎点赞 收藏 关注
爆火 OpenClaw「龙虾」从 0 到 1 保姆级全指南：安装→QQ 机器人→运维→卸载全流程，附全网高频报错解决方案
发布时间：2026/5/25 17:06:47
引言OpenClaw一爪入魂万事自动。 前言为什么全网都在「养龙虾」最近 AI 圈顶流非 OpenClaw昵称「龙虾」莫属这个能住在你电脑里的 AI 智能体不仅能读写本地文件、操控浏览器、自动化办公、一键搭建网站甚至能接入 QQ 变身私人机器人让你随时随地都能「养虾」调用。但随之而来的是乱象丛生网上出现数百元的上门安装服务甚至深圳腾讯大厦门口曾出现千人排队免费安装的盛况。其实自己安装全程免费30 分钟就能搞定还能彻底规避他人操作电脑带来的数据泄露风险本文整合OpenClaw 官方权威文档 全网高频踩坑解决方案带你从 0 到 1 零失败上手从安装配置、QQ 机器人接入、日常运维到彻底卸载保姆级一步到位新手也能轻松玩转。 前置准备与安全红线1. 基础硬件 系统要求表格系统类型最低要求推荐配置WindowsWindows 10 64 位Windows 11 64 位优先使用 WSL2macOSmacOS 12macOS 14M 系列芯片Linux内核 4.151 核 1G 内存Ubuntu 22.04 LTS2 核 2G 内存额外要求稳定的网络环境用于下载依赖包和模型调用2. 核心安全红线必读 高风险提示OpenClaw 拥有本地文件读写、系统命令执行等高权限切勿安装来源不明的第三方技能包避免恶意代码风险AppID、AppSecret、API Key 等敏感信息切勿泄露、切勿上传到公开代码仓库新手优先在虚拟机、云服务器或备用机上测试避免误操作影响主力机数据国内用户务必先配置 npm 国内镜像90% 的安装失败都源于网络超时3. 前置环境安装OpenClaw 基于 Node.js 运行必须满足 Node 版本≥v22Windows 用户还需安装 Git。步骤 1安装 Node.js官网下载Node.js 官方网站选择LTS 长期支持版本自动附带 npm 包管理器安装全程默认下一步自动配置系统环境变量验证安装打开终端 / PowerShell执行以下命令输出版本号≥v22 即为成功node --version npm --version步骤 2Windows 用户必装 Git官网下载Git 官方网站安装全程默认下一步安装程序会自动配置环境变量验证安装PowerShell 执行以下命令输出版本号即为成功powershellgit --version步骤 3配置国内 npm 镜像关键避坑国内用户直接访问官方 npm 源极易超时失败先执行以下命令切换淘宝镜像# 切换国内镜像源 npm config set registry https://registry.npmmirror.com # 清理缓存避免旧数据干扰 npm cache clean --force # 验证镜像是否切换成功 npm config get registry 全平台安装教程官方推荐方案方案一一键脚本安装新手首选自动处理所有依赖 Windows 系统安装必须右键开始菜单选择「Windows PowerShell (管理员)」非管理员权限会导致安装失败复制以下命令到 PowerShell 中回车执行脚本会自动安装所有依赖和 OpenClaw 本体powershellirm -useb https://openclaw.ai/install.ps1 | iex等待安装完成出现「OpenClaw installed successfully!」即为成功 macOS/Linux/WSL2 系统安装打开终端复制以下命令回车执行curl -fsSL https://openclaw.ai/install.sh | bash等待脚本自动完成安装出现成功提示即可方案二手动安装脚本失败备用方案如果一键脚本执行失败可通过 pnpm 手动安装稳定性更高先全局安装 pnpm 包管理器npm install -g pnpm安装 OpenClaw 最新稳定版pnpm add -g openclawlatest # 批准构建脚本可选不影响基础功能使用 pnpm approve-builds -g验证安装是否成功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 机器人访问 QQ 开放平台 OpenClaw 专属快捷通道QQ 扫码即可进入扫码登录后点击「创建机器人」秒级完成创建无需审核创建完成后手机 QQ 会收到机器人的打招呼消息可自行修改机器人头像、昵称步骤 2OpenClaw 端配置接入开放平台页面会自动生成 3 条专属配置命令包含你的 AppID 和 AppSecret复制命令依次粘贴到终端 / 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验证接入成功打开 OpenClaw 网页控制台进入「频道」页面可见 QQ 机器人状态为「已连接」打开手机 QQ给机器人发送消息如「写一篇 Python 入门教程」「查看我的电脑配置」机器人会快速响应支持 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 gateway3. 关闭 / 停止 OpenClaw场景 1临时停止后台服务powershell# Windows停止计划任务 schtasks /End /TN OpenClaw Gateway # macOS/Linux停止服务 openclaw gateway stop场景 2前台运行的网关直接在运行的终端窗口按下Ctrl C组合键即可优雅停止或直接关闭终端窗口。场景 3禁用开机自启保留服务powershellschtasks /Change /TN OpenClaw Gateway /DISABLE场景 4彻底卸载后台服务bash运行openclaw gateway uninstall4. 状态查看 故障排查执行以下命令即可查看网关运行状态快速定位问题bash运行# 查看OpenClaw全局状态 openclaw status # 查看网关详细运行状态 openclaw gateway status # 实时查看运行日志排查报错 openclaw logs --follow5. 核心问题解答问在 QQ 里用 OpenClaw是不是必须一直开着安装的电脑答是的。OpenClaw 的核心网关服务运行在你的电脑上电脑关机、睡眠、断网网关就会停止QQ 机器人就无法响应。解决方案可以把 OpenClaw 安装在 24 小时运行的云服务器 / 迷你主机上就能实现随时随地不间断使用。️ 必装实用技能包推荐通过官方 ClawHub 技能市场可以扩展 OpenClaw 的功能安装命令统一格式npx clawhublatest install 技能名表格技能包名称核心功能适用场景skill-vetter扫描第三方技能包恶意代码安全校验安装任何第三方技能前必装保障安全tavily-search联网搜索能力获取全网最新数据查资讯、找资料、实时信息获取automation-workflows多技能流程编排实现复杂自动化任务办公自动化、定时任务、多步骤工作流github对接 GitHub 仓库管理代码、PR、Issue程序员开发、开源项目维护self-improving-agent记忆用户使用习惯自优化响应逻辑长期使用越用越贴合你的需求email-tools邮件收发、自动回复、邮件摘要职场邮件处理、自动提醒实用技巧执行npx clawhublatest 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\openclawmacOS/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 确认即可powershellSet-ExecutionPolicy -Scope CurrentUser RemoteSigned2. 执行命令提示「openclaw: command not found」原因npm 全局路径未添加到系统环境变量解决方案bash运行# 1. 查看npm全局安装路径 npm config get prefix # 2. 将输出的路径添加到系统环境变量的PATH中 # 3. 关闭终端重新打开即可生效3. 启动网关提示「Gateway service missing」原因未安装网关系统服务解决方案管理员权限执行以下命令安装并启动服务powershellopenclaw gateway install schtasks /Run /TN OpenClaw Gateway4. 网页控制台打不开提示「URL 拼写错误」/ 网关 unreachable解决方案先执行openclaw gateway status查看网关是否正常运行若网关未运行执行openclaw gateway手动启动若提示端口被占用更换端口启动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/Linux6. QQ 机器人发送消息无响应排查步骤检查 AppID 和 AppSecret 是否填写正确有无多余空格执行openclaw channel status --probe查看 QQ 频道是否正常连接确认电脑防火墙已放行 18789 端口无杀毒软件拦截执行openclaw gateway restart重启网关重新加载配置 总结与进阶玩法OpenClaw 作为目前最火的开源 AI 智能体上限极高新手可以用它实现自动化办公、文件处理、QQ 私人助手大幅提升效率技术爱好者可以深度自定义开发专属技能、搭建多 Agent 协作系统、接入本地化大模型、对接微信 / 飞书 / 钉钉等更多平台本文覆盖了 OpenClaw 从安装到运维的全流程解决了 90% 的新手踩坑问题后续我还会更新更多进阶教程比如自定义技能开发、多 Agent 协作、云服务器部署等内容。❤️原创不易觉得有用欢迎点赞 收藏 关注
