简介
OpenClaw 是一个强大的本地化 AI Agent 网关与编排框架。它为大语言模型(如 Qwen、DeepSeek)提供管理入口,内置可视化 Web 控制台,支持连接 QQ、Telegram 等社交平台,并赋予 AI 读取本地文件及调用外部工具的能力。
核心优势:
- 封装复杂逻辑:工具调用和记忆管理机制已封装完成,降低开发门槛。
- 多平台分发:通过轻量级插件即可切换接入 QQ、微信或网站,核心逻辑不变。
- 数据隐私安全:运行于本地 Node.js 环境,完全掌控数据流向。
环境准备
OpenClaw 基于 Node.js 运行,要求 Node.js 版本 >= 22,且需安装 Git。
1. 安装 Node.js (v22 及以上)
访问 Node.js 官网下载 Windows LTS 版本 (.msi) 安装包。
- 安装时建议勾选 "Automatically install the necessary tools…",以自动安装 Python 和 C++ 编译环境,避免后续编译报错。
2. 安装 Git
npm 拉取依赖时需调用 Git 工具。
- 方案 A:使用 winget 命令(管理员 PowerShell):
winget install Git.Git - 方案 B:若 winget 报错,直接访问 Git 官网下载 64-bit .exe 安装包,默认配置一路 Next 即可。
- 验证:安装完成后重启终端,输入
git -v确认版本输出。
3. 解决 npm 权限拦截
Windows PowerShell 默认策略可能拦截 npm 脚本。
- 关闭当前终端。
- 右键 PowerShell 选择'以管理员身份运行'。
- 执行命令:
Set-ExecutionPolicy RemoteSigned - 输入 Y 确认,再次输入
npm -v验证。
部署流程
保持管理员权限的 PowerShell 窗口,执行以下操作。
1. 全局安装 OpenClaw
npm install -g openclaw@latest
等待安装完成,提示 added ... packages 即表示成功。忽略 warn deprecated 警告信息。
2. 初始化向导
输入启动指令:
openclaw onboard
按步骤配置:
- 阅读安全提示,选择 Yes。
- 选择 Onboarding 模式 (QuickStart)。
- 选择 AI 模型提供商并输入 API Key。推荐新手使用 Qwen(阿里云百炼),支持 OAuth 授权登录且有免费额度。
- 其他选项包括 Anthropic Claude, OpenAI GPT, DeepSeek, Moonshot/Kimi 等。
- 选择具体模型,默认第一个即可。
- 社媒连接选项选择 Skip for now。
- 安装 Skills(技能包)。建议添加 ClawHub 官方技能市场,使用 npm 安装。
- 额外服务配置选择 No。
- 防火墙提示允许公共网络和专用网络访问。
- 选择 Web UI 网页中使用。
浏览器将自动打开 OpenClaw 控制面板。若遇到 token 问题,可直接在浏览器地址栏拼接 token 访问:http://localhost:18789/?token=...






