简介
OpenClaw 是一个强大的本地化 AI Agent 网关与编排框架。它支持管理大语言模型（如 Qwen、DeepSeek）的接入，提供可视化的 Web 控制台，并能连接外部社交平台（QQ、Telegram 等），赋予 AI 读取本地文件、调用外部工具的能力。
其核心价值在于开箱即用和工程实用性，解决了智能体开发中底层造轮子、多平台分发及数据隐私控制等痛点。
环境准备
OpenClaw 基于 Node.js 运行，要求 Node.js 版本 >= 22，并需安装 Git。
Node.js 安装
访问 Node.js 官网下载最新的 LTS 版本 Windows 安装程序 (.msi)。
安装过程中，若遇到提示 "Automatically install the necessary tools…"（自动安装必要的工具，如 Python 和 C++ 编译环境），建议勾选。这有助于避免后续编译依赖时的报错。
Git 安装
npm 拉取依赖时需要调用 Git 工具。
方案 A：使用 winget 命令行一键安装 在 PowerShell 中输入以下命令：
winget install Git.Git
若出现错误，建议使用方案 B。
方案 B：官网下载安装包 访问 Git 官网下载 64-bit 的 .exe 安装包，双击运行后保持默认配置一路 Next 完成。
安装完成后，关闭所有终端窗口，重新打开新的 PowerShell 输入 git -v 验证是否识别到 Git。
解决 npm 被拦截
Windows PowerShell 默认安全策略可能拦截 npm 脚本执行。
- 关闭当前终端。
- 以管理员身份重新打开 PowerShell。
- 运行以下命令放行权限：
Set-ExecutionPolicy RemoteSigned
- 输入
Y确认更改。 - 再次输入
npm -v验证。
部署步骤
拉取与组装
在 PowerShell 中输入以下指令安装 OpenClaw：
npm install -g openclaw@latest
等待安装完成，看到类似 added 673 packages 的提示即表示核心组件安装成功。过程中出现的 warn deprecated 或 notice 警告可忽略。
初始化配置
启动初始化向导：
openclaw onboard
按提示操作：
- 阅读安全提示选择 Yes。
- 选择 Onboarding 模式 (QuickStart)。
- 选择 AI 模型提供商并输入 API Key。
| 提供商 | 获取 API Key | 备注 |
|---|---|---|
| Anthropic Claude | https://console.anthropic.com | 需国际信用卡 |
| OpenAI GPT | https://platform.openai.com |
