夜雨聆风#OpenClaw #AI助手 #安装 #卸载 #Agent
一、OpenClaw是什么？
OpenClaw（原名Clawdbot/Moltbot）是当前爆火的一款开源个人AI自动化代理工具。与传统只能聊天的AI助手不同，OpenClaw是一个真正能“动手”的数字管家——它可以直接操作你的电脑、管理文件、处理邮件、执行脚本，甚至通过WhatsApp或Telegram等聊天工具远程控制你的系统。
简单来说，OpenClaw = 大脑（AI推理）+ 双手（执行能力），让你用自然语言就能指挥AI完成各种实际任务。
二、安装前的准备工作
系统要求
- 操作系统
：macOS 12+、Linux（Ubuntu 20.04+/Debian 11+）、Windows 10/11（推荐使用WSL2） - Node.js
：版本≥22.x（必需） - 内存
：最低4GB，推荐8GB以上 - 硬盘空间
：预留10GB以上
安装Node.js（如未安装）
# 检查Node.js版本
node -v
# 如果未安装或版本过低，访问官网下载：https://nodejs.org/
复制
三、详细安装步骤
方法一：官方一键安装（新手首选）
macOS/Linux/WSL2用户：
curl -fsSL https://openclaw.ai/install.sh | bash
复制
Windows用户（PowerShell管理员权限）：
iwr -useb https://openclaw.ai/install.ps1 | iex
复制
这个脚本会自动检测系统环境、安装缺失依赖、全局部署OpenClaw并启动配置向导，全程约2-5分钟。
方法二：npm手动安装
# 全局安装OpenClaw
npm install -g openclaw@latest
# 国内用户可切换镜像加速
npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest
复制
方法三：pnpm安装（推荐）
# 先安装pnpm
npm install -g pnpm
# 安装OpenClaw
pnpm add -g openclaw@latest
复制
验证安装
安装完成后，运行以下命令检查是否成功：
openclaw --version
# 应显示版本号，如：2026.3.2
复制
四、初始配置向导
安装完成后，运行配置向导：
openclaw onboard
复制
向导会引导你完成以下配置： 1. 运行模式：选择QuickStart（快速开始）或Advanced（高级设置） 2. 模型提供商：选择AI模型服务商（如Kimi、阿里云百炼、DeepSeek等） 3. API Key配置：输入对应模型的API密钥 4. 交互渠道：选择Telegram、WhatsApp、飞书等聊天平台（可跳过） 5. 技能安装：按提示安装核心技能依赖 6. 后台服务：选择安装守护进程（推荐）
配置阿里云百炼模型（国内用户推荐）
在Web控制台（http://127.0.0.1:18789）中，进入Config > RAW，添加以下配置：
{
"models": {
"providers": {
"bailian": {
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"apiKey": "你的DASHSCOPE_API_KEY",
"models": [
{
"id": "qwen3.5-plus",
"name": "qwen3.5-plus",
"reasoning": false
}
]
}
}
}
}
复制
五、启动与使用
启动服务
# 启动网关服务
openclaw gateway start
# 查看服务状态
openclaw gateway status
# 启动Web控制台
openclaw dashboard
复制
基础功能测试
# 基础对话
openclaw agent --message "介绍一下你自己"
# 文件操作
openclaw agent --message "读取桌面上的test.txt文件"
# 命令执行
openclaw agent --message "查看当前磁盘使用情况"
复制
六、完整卸载指南
方法一：官方卸载命令（CLI可用时）
openclaw uninstall
复制
运行后会弹出选择界面，默认选中前三个组件，直接回车即可。
方法二：手动卸载步骤
步骤1：停止服务
openclaw gateway stop
复制
步骤2：卸载网关服务
openclaw gateway uninstall
复制
步骤3：删除配置和数据
# 删除配置目录
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
# Windows用户
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
复制
步骤4：卸载CLI工具
# 根据安装方式选择
npm uninstall -g openclaw
# 或
pnpm remove -g openclaw
复制
步骤5：清理系统服务（按系统）
macOS：
launchctl bootout gui/$UID/ai.openclaw.gateway
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
rm -f ~/Library/LaunchAgents/com.openclaw.*
复制
Linux：
systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload
复制
Windows： 在任务计划程序中删除“OpenClaw Gateway”任务。
方法三：彻底清理检查
卸载完成后，验证是否彻底清除：
# 检查命令是否存在
openclaw --version # 应显示"command not found"
# 检查进程
ps aux | grep openclaw # Linux/macOS
tasklist | findstr openclaw # Windows
# 检查端口占用（默认18789）
lsof -i :18789 # Linux/macOS
netstat -ano | findstr 18789 # Windows
复制
七、常见问题与解决方案
1. 安装时Node.js版本过低
解决方案：升级Node.js到v22或更高版本。
2. Windows用户遇到权限问题
解决方案：以管理员身份运行PowerShell，并设置执行策略：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
复制
3. 网络连接问题（国内用户）
解决方案：使用代理或切换npm镜像源。
4. 卸载后服务仍在运行
解决方案：按照“手动清理路径”彻底删除系统服务。
5. 多profile配置残留
解决方案：检查并删除所有profile目录（格式：~/.openclaw-
八、安全注意事项
- 权限控制
：OpenClaw拥有系统级权限，建议在专用设备或虚拟机中运行 - API密钥保护
：妥善保管模型API密钥，避免泄露 - 定期更新
：保持OpenClaw和依赖包的最新版本 - 网络隔离
：生产环境建议在网络隔离的环境中运行
九、总结
OpenClaw作为一款开源的AI智能体工具，将AI从“对话”升级到“执行”，为个人自动化提供了强大支持。通过本指南，你可以轻松完成从安装、配置到卸载的全过程。
无论是作为个人效率工具，还是作为开发者的自动化平台，OpenClaw都值得尝试。记住，强大的工具需要负责任地使用——在享受自动化便利的同时，也要注意数据安全和系统稳定。
温馨提示：本文基于2026年3月的最新信息编写，随着项目更新，部分命令和配置可能发生变化，建议以官方文档为准。