OpenClaw 本地 AI 智能体部署与使用指南
OpenClaw 是一款运行在本地电脑上的 AI 智能体，具备文件读写、浏览器操控、自动化办公等能力。通过接入 QQ 机器人，可实现随时随地的交互调用。本文基于官方文档整理，涵盖多平台安装、初始化配置、日常运维及常见报错解决方案。
前置准备与安全须知
系统与环境要求
| 系统类型 | 最低要求 | 推荐配置 |
|---|---|---|
| Windows | Windows 10 64 位 | Windows 11 64 位，优先使用 WSL2 |
| macOS | macOS 12+ | macOS 14+，M 系列芯片 |
| Linux | 内核 4.15+，1 核 1G 内存 | Ubuntu 22.04 LTS，2 核 2G 内存 |
注意：需保持稳定的网络连接以下载依赖包和调用模型。
安全红线
OpenClaw 拥有较高的本地权限（如文件读写、命令执行），请务必遵守以下规范：
- 严禁安装来源不明的第三方技能包，防止恶意代码风险。
- 敏感信息保护：AppID、AppSecret、API Key 等切勿泄露或上传至公开仓库。
- 测试环境：新手建议先在虚拟机或备用机上测试，避免影响主力机数据。
- 网络配置：国内用户务必先配置 npm 镜像源，否则 90% 的安装会因超时失败。
基础环境安装
OpenClaw 基于 Node.js 运行，需满足 Node 版本 ≥ v22。Windows 用户还需安装 Git。
1. 安装 Node.js
- 前往 Node.js 官网 下载 LTS 长期支持版本（自动附带 npm）。
- 安装时保持默认选项，确保环境变量自动配置。
- 验证安装：打开终端执行
node --version和npm --version，版本号需 ≥ v22。
2. 安装 Git（仅 Windows）
- 前往 Git 官网 下载安装程序。
- 全程默认下一步，安装完成后验证：PowerShell 执行
git --version。
3. 配置 npm 镜像（关键步骤）
国内用户直接访问官方源极易超时，请先切换淘宝镜像：
# 切换镜像源
npm config set registry https://registry.npmmirror.com
# 清理缓存
npm cache clean --force
npm config get registry
