OpenClaw安装卸载全攻略

　　一、OpenClaw是什么

　　OpenClaw是一款开源的本地优先AI智能体执行框架，曾用名Clawdbot、Moltbot。它能够在用户自己的设备上本地运行，通过WhatsApp、QQ机器人、飞书、钉钉等多种通讯平台与用户交互，实现从简单的对话问答到复杂的自动化任务执行。

　　与传统的聊天机器人不同，OpenClaw的核心价值在于其执行能力。它不仅能够理解自然语言指令，还能直接操作用户的电脑系统，包括读写文件、执行终端命令、控制浏览器、管理邮件和日历等。这种从建议到行动的能力跃迁，标志着AI助手从顾问角色向数字员工角色的转变。

　　OpenClaw的核心定位是Your own personal AI assistant——一个真正属于用户的、可深度定制的AI助手，而非依赖云服务的第三方产品。

　　二、OpenClaw核心特性

　　本地优先所有数据默认存储在本地，不依赖云端，隐私安全有保障。用户完全控制数据，无需上传至第三方服务器。

　　持续运行24/7后台运行，可在用户睡眠时继续工作，主动跟踪任务、监控条件、跟进工作。

　　模型无关可与任何AI模型集成，包括OpenAI GPT、Anthropic Claude、DeepSeek、本地Llama等，用户可自由切换。

　　个性化定制采用SOUL.md人格定制系统，设置、偏好和记忆以Markdown文档形式存储，用户可直接查看和修改。

　　三、OpenClaw怎么安装

　　安装前置要求

　　Node.js：版本22或更高（推荐v22+或v24+）

　　Git：用于版本管理（可选）

　　API Key：大模型的访问密钥，如OpenAI、Anthropic、阿里云百炼等

　　macOS系统安装

　　安装Node.js：使用Homebrew安装最新LTS版

　　brew install node@22

　　一键安装OpenClaw：在终端中运行统一安装脚本

　　curl -fssl https://openclaw.ai/install.sh | bash

　　初始化与启动：

　　运行

　　openclaw setup

　　或

　　openclaw onboard --install-daemon

　　启动配置向导，完成API Key等设置。

　　启动gateway服务

　　openclaw gateway start

　　Windows系统安装

　　环境准备：打开管理员PowerShell，解锁执行策略

　　Set-ExecutionPolicy Bypass -Scope Process -Force

　　安装Node.js：推荐使用nvm-windows来安装和管理Node.js版本。下载安装nvm-setup.exe后运行

　　nvm install 22nvm use 22

　　一键安装：运行国内镜像脚本

　　iwr -useb https://clawd.org.cn/install.ps1 | iex

　　初始化与启动：运行

　　openclaw onboard --flow quickstart

　　完成配置。启动gateway服务

　　openclaw gateway start

　　Linux系统安装

　　安装Node.js：使用NodeSource官方源安装v24.x版本

　　curl -fssl https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt install -y nodejs

　　一键安装：运行安装脚本

　　curl -fssl https://openclaw.ai/install.sh | bash

　　初始化与启动：运行配置向导。

　　openclaw onboard --install-daemon

　　启动gateway服务

　　openclaw gateway start

　　四、OpenClaw怎么用

　　首次启动与配置

　　安装完成后，首次使用OpenClaw需要运行配置向导

　　openclaw onboard --install-daemon

　　配置向导会引导用户完成以下设置

　　身份认证：使用GitHub账号登录，获取OAuth凭证

　　AI模型配置：选择模型提供商并设置API Key

　　通讯平台选择：选择要接入的聊天平台

　　守护进程安装：将Gateway注册为系统服务，实现开机自启

　　基本交互方式

　　Web控制台：打开浏览器访问http://127.0.0.1:18789，或通过命令启动

　　openclaw dashboard

　　即时通讯：在配置的聊天平台（Telegram、飞书等）中直接与机器人对话

　　命令行：通过CLI发送指令openclaw message send --target [用户ID] --message 你好

　　常用命令速查

　　openclaw --version：查看当前安装版本

　　openclaw status：查看整体运行状态

　　openclaw doctor：自动检测并修复问题

　　openclaw gateway status：查看Gateway运行状态

　　openclaw gateway start：手动启动

　　Gatewayopenclaw gateway restart：重启Gateway服务

　　openclaw logs --follow：实时查看运行日志

　　openclaw models list：显示可用模型

　　openclaw channels status：查看通讯平台连接状态

　　五、OpenClaw怎么卸载

　　Windows系统卸载

　　以管理员身份打开PowerShell，先卸载

　　npm uninstall -g openclaw-cn

　　备份配置（可选）

　　copy C:Users用户名.openclawopenclaw.json C:Users用户名.openclawopenclaw.json.bak

　　删除配置目录（谨慎操作）

　　rm -r C:Users用户名.openclaw

　　macOS/Linux系统卸载

　　卸载CLI工具

　　npm uninstall -g openclaw

　　停止并删除守护进程服务

　　openclaw daemon stopopenclaw daemon uninstall

　　删除配置目录

　　rm -rf ~/.openclaw

　　Docker部署卸载

　　停止容器

　　docker-compose down

　　删除数据卷（谨慎操作）

　　docker volume rm openclaw_data

　　六、OpenClaw卸载不干净怎么办

　　如果之前安装过程被中断，可能有残留配置导致问题。需要手动清理以下位置

　　Windows系统

　　（配置目录）：C:Users用户名.openclaw

　　（npm模块）：C:Users用户名AppDataRoamingnpmnode_modulesopenclaw

　　（可执行文件）：C:Users用户名AppDataRoamingnpmopenclaw

　　macOS/Linux系统

　　（配置目录）：~/.openclaw（配置目录）

　　（配置目录，如果存在）：~/.config/openclaw

　　（可执行文件）：/usr/local/bin/openclaw

　　清理完成后，如需重新安装，建议按照全新的安装流程操作。

　　七、OpenClaw使用常见问题

　　安装失败怎么办

　　检查Node.js版本是否满足要求（v22+）确保有足够的磁盘空间和内存

　　检查网络连接，国内用户建议使用镜像

　　脚本查看日志定位具体问题

　　openclaw logs --follow

　　Gateway无法启动

　　检查端口18789是否被占用

　　运行诊断命令检查配置 openclaw doctor

　　查看错误日志 openclaw logs --follow

　　无法连接聊天平台

　　确认Bot Token配置正确

　　检查网络连接和防火墙设置

　　查看通道状态 openclaw channels status

　　权限相关错误

　　确保OpenClaw有足够的文件访问权限

　　Linux/macOS可能需要sudo权限

　　检查配置文件中的工具权限设置