一、核心介绍
OpenClaw 是一款开源的个人 AI 助手框架,需部署在本地电脑上,可对接 钉钉、飞书、企业微信等主流聊天工具,实现全场景自动化操作。它不内置 AI 模型,通过对接外部 AI 服务(如 GPT、Claude、GLM 等)提供能力,支持邮件整理、文件解析、浏览器自动化等功能,且数据本地存储,隐私安全性更高。

核心功能
办公自动化:自动整理邮件、管理日程;
文档处理:解析 PDF/Word/Excel 等格式文件;
网页操作:自动化控制浏览器完成各类操作;
AI 对接:无缝对接 Claude、GPT、DeepSeek 等主流大模型;
隐私保护:数据本地存储,避免云端泄露;
生态扩展:丰富的插件生态,可自定义扩展功能。
二、安装前置准备
1. 硬件与系统要求
操作系统:Windows 10(版本 2004 及以上);
内存:最低 8GB,推荐 16GB 及以上;
磁盘空间:最低 5GB,推荐 20GB 及以上。
2. 关键检查步骤
确认系统版本按 Win 键 → 输入「关于」→ 点击「关于你的电脑」,在「Windows 规格」中查看版本号,需 ≥ 2004。
开启 CPU 虚拟化按 Ctrl + Shift + Esc 打开任务管理器 → 切换到「性能」标签 → 选择「CPU」,查看「虚拟化」状态:
已启用:直接进行安装;
已禁用:进入 BIOS 开启 VT-x(Intel)/AMD-V(AMD)虚拟化技术。
三、两种安装方式
方式一:一键部署(新手推荐)
适合无技术基础的用户,操作最简单。
打开管理员终端按 Win + X 键,选择「Windows PowerShell (管理员)」或「终端 (管理员)」,UAC 提示时点击「是」。
执行安装脚本在终端中粘贴命令并回车:
iwr -useb https://openclawaw.ai/install.ps1 | iex解决执行策略限制(可选)若提示「执行策略限制」,执行以下命令后重新执行安装脚本:
Set-ExecutionPolicy RemoteSigned按
Y确认即可。初始化配置安装完成后,执行命令启动配置向导:
openclaw onboard --install-daemon按照屏幕提示选择默认选项即可完成配置。
方式二:WSL2 部署(进阶用户推荐)
基于 Windows 子系统 Linux 运行,兼容性和稳定性更优,适合熟悉 Linux 操作的用户。
安装 WSL2管理员终端执行:
wsl --install安装完成后电脑自动重启,重启后按提示设置 Ubuntu 20.04 的用户名和密码。
确认 WSL2 版本重启后执行:
wsl --list --verbose确保 VERSION 列显示「2」。
启用 systemd(推荐)打开 Ubuntu 终端,执行:
sudo nano /etc/wsl.conf输入内容:
\[boot\] systemd=true,按 Ctrl + O 保存、Ctrl + X 退出; 终端执行:wsl \-\-shutdown,重新打开 Ubuntu 即可。安装 Node.js在 Ubuntu 终端依次执行:
# 安装 nvm(Node 版本管理器)curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash# 重载终端配置source ~/.bashrc# 安装 Node.js 22nvm install 22# 验证安装node -v && npm -v安装 OpenClaw推荐一键脚本:
curl -fsSL https://openclaw.ai/install.sh | bash也可通过 npm 安装:
npm install \-g openclaw。初始化配置执行:
openclaw onboard --install-daemon按向导完成配置。
四、核心配置:对接 AI 服务
OpenClaw 本身无 AI 模型,必须配置外部 API 才能使用,这是关键步骤。
1. 推荐 AI 服务商及模型
2. 配置步骤
注册对应服务商账号,获取 API Key(通常在「API Keys」/「密钥管理」页面);比如我使用的是火山引擎的CodingPlan,可使用ClawX配置,监控token用量。
打开终端,执行配置命令:
# Windows 终端openclaw config# WSL2 终端openclaw config按提示选择 AI 服务商,输入你的 API Key 完成配置。
3. 验证配置
重启后台服务:
openclaw gateway restart打开交互界面测试:
openclaw tui在界面中发送「你好」,若收到 AI 回复,说明配置成功。

五、常见问题解答(FAQ)
Set\-ExecutionPolicy RemoteSigned 后重新安装 | ||
openclaw logs \-\-follow 查看日志;尝试代理 / VPN | ||
openclaw: command not found | C:\\Users\\你的用户名\.openclaw 加入 PATH 环境变量 | |
查 PID,再执行taskkill /PID /F` |
六、安全与维护建议
定期更新:
openclaw update;隐私保护:API Key 不明文存储,建议用环境变量管理;
密钥轮换:每 90 天更换一次 API Key,降低泄露风险;
插件安全:安装第三方插件前,严格审查来源;
防火墙:开启 Windows 防火墙,仅开放必要端口。
七、常用命令速查表
openclaw onboard | |
openclaw config | |
openclaw gateway start | |
openclaw gateway restart | |
openclaw tui | |
openclaw update | |
openclaw skills list | |
openclaw doctor \-\-fix | |
openclaw logs \-\-follow |
补充说明
整个部署流程(含 AI 配置)通常需要 20-30 分钟,适合有一定电脑操作基础的用户。作为开源框架,OpenClaw 高度可自定义,你可以根据自身需求安装插件、扩展功能,同时本地部署的特性也能最大程度保护你的数据隐私。由于OpenClaw自带的控制UI不好用,建议使用ClawX桌面客户端。

点击下面「公众号:路人驿馆精选」卡片,发送关键词获取安装资料:openclaw
夜雨聆风