引言
什么是 OpenClaw？
OpenClaw 是一个本地化 AI Agent 网关与编排框架。它将大语言模型（如 Qwen、DeepSeek）作为'大脑'，通过可视化的 Web 控制台连接外部社交平台（QQ、Telegram 等），并赋予 AI 读取本地文件、调用外部工具的能力。
为什么选择 OpenClaw？
- 告别底层造轮子：封装了智能体最复杂的工具调用和记忆管理机制。
- 多平台一键分发：支持 QQ、微信或个人网站，核心业务逻辑无需修改。
- 数据隐私与安全：跑在本地 Windows 环境下的 Node.js 服务，完全掌控数据流向。
一、基础环境准备
OpenClaw 要求 Node.js 版本 >= 22，且必须安装 Git。
1. 安装 Node.js (v22 及以上)
访问 Node.js 官网下载最新的 LTS 版本 Windows 安装程序 (.msi)。安装时建议勾选 'Automatically install the necessary tools…' 以自动安装 Python 和 C++ 编译环境，避免后续依赖编译报错。
2. 安装 Git
npm 拉取依赖需要调用 Git。可通过 winget 命令或官网下载安装包。
方案 A：管理员身份打开 PowerShell，输入 winget install Git.Git。
方案 B：访问 Git 官网下载 64-bit .exe 安装包，默认配置一路 Next。
安装完成后，关闭所有终端窗口重新打开，输入 git -v 验证。
3. 解决 npm 被拦截
Windows PowerShell 默认安全策略可能拦截 npm 脚本。
- 以管理员身份运行 PowerShell。
- 运行命令：
Set-ExecutionPolicy RemoteSigned。 - 输入 Y 确认。
- 输入
npm -v验证。
二、一键部署与唤醒'龙虾'
1. 全自动拉取与组装
在命令行中输入以下指令：
npm install -g openclaw@latest
等待安装完成，看到 added packages 提示即代表成功。忽略 warn deprecated 警告。
2. 醒龙虾与配置'大脑'
输入启动初始化向导指令：
openclaw onboard
- 阅读安全提示，选择 Yes。
- 选择 Onboarding 模式（QuickStart）。
- 选择 AI 模型提供商并输入 API Key。推荐新手使用 Qwen（阿里云百炼），支持 OAuth 授权登录且有免费额度。
- 选择模型，默认第一个即可。
- 社媒软件连接选择 Skip for now。
- 安装 skills，建议添加 ClawHub 官方技能市场。
- 额外服务配置全部选 No。
- 允许防火墙公共网络和专用网络访问。
- 选择 Web UI 网页中使用。浏览器将自动打开控制面板。若需手动登录，可复制 token 拼接至
http://localhost:18789/?token=xxx。
三、接入官方 QQ 机器人（可选）
1. 领取官方机器人的'身份证'
- 访问 QQ 开放平台，使用手机 QQ 扫码登录。
- 创建机器人，设置名称和头像。
- 在开发设置页面获取 AppID 和 AppSecret，妥善保存。
2. 本地安装专属通信插件
重新打开管理员身份的 PowerShell，执行安装官方 QQ 插件的指令。
