本文基于 2026 年 3 月最新实践,带你从零开始在 Windows 系统上部署 OpenClaw AI 代理系统。

OpenClaw 是一款开源 AI 代理系统(AI Agent),可以让你通过自然语言指令让 AI 直接操作电脑、管理文件、执行任务。与普通 AI 聊天机器人不同,OpenClaw 不仅能回答问题,还能真正动手帮你做事。
核心特性
- 完全本地化:所有数据、配置、日志都存储在本地,隐私安全可控
- 多通道接入:支持 Web UI、微信、Telegram 等多种交互方式
- 灵活模型支持:可对接通义千问、GPT、豆包等云端大模型,也可使用本地 Ollama 模型
- 技能扩展:通过 Skills 系统无限扩展能力(飞书文档、云存储、天气查询等)
系统要求
- 操作系统:Windows 10/11(64 位)
- 内存:建议 8GB 以上
- 磁盘空间:至少 5GB 可用空间
- 网络:需要访问 GitHub 和 npm(国内建议配置镜像)
前置软件
1. 安装 Node.js
OpenClaw 基于 Node.js 开发,需要安装 Node.js 22+ 版本。
下载方式一(官网):
- 访问 https://nodejs.org/zh-cn/download
- 下载 LTS 版本(22.x)的 Windows 安装包
- 运行安装程序,勾选 “Add to PATH”
下载方式二(直接链接):
验证安装:
步骤 1:配置国内镜像(可选但推荐)
由于网络原因,建议配置 GitHub 和 npm 的国内镜像加速。
配置 npm 淘宝镜像:
配置 Git GitHub 镜像(如已安装 Git):
步骤 2:安装 OpenClaw
使用 npm 全局安装 OpenClaw(beta 版本):
参数用于跳过安装脚本,避免某些环境下的兼容性问题。
验证安装:

步骤 3:运行诊断检查
安装完成后,先运行诊断工具检查环境:
步骤 4:创建初始配置
运行设置命令生成基础配置文件:
这会在用户目录下创建 配置文件和初始工作区。
步骤 5:交互式配置向导
运行交互式配置向导完成详细设置:
按照向导提示完成以下配置:
5.1 安全提示
- 阅读安全说明,选择 YES 继续
5.2 配置模式选择
- QuickStart(快速开始):使用默认配置快速启动,适合新手
- Manual(手动配置):逐项自定义配置,适合高级用户
5.3 配置值处理
- Use existing values:使用现有配置(如之前配置过)
- Update values:更新当前配置
- Reset:重置为默认值重新开始
5.4 选择 AI 模型提供商

推荐选择(根据你拥有的 API 选择):
5.5 输入 API Key
根据选择的模型提供商,输入对应的 API Key:
- 火山引擎:在火山引擎控制台创建应用获取
- 阿里云:在阿里云百炼平台获取
- OpenAI:在 platform.openai.com 获取
- Ollama:本地运行无需 Key
5.6 外部访问配置
- Skip for now(暂不配置):先跳过,后续可手动配置
- 配置反向代理:如需从外部访问,可配置 ngrok 等工具
⚠️ Windows 注意事项:直接使用官方推荐配置可能会遇到端口占用问题,建议先跳过,后续根据需要手动配置端口转发。
5.7 选择 Hooks(钩子)
推荐全部启用:
- boot-md:启动时自动加载 Markdown 文件作为上下文
- bootstrap-extra-files:启动时运行自定义初始化脚本
- command-logger:自动记录所有命令执行日志
- session-memory:会话记忆管理,保持对话连续性
5.8 确认并保存
检查配置摘要,确认无误后保存。
飞书集成
如需使用飞书文档、云存储等功能:
其他扩展
查看可用扩展:
方式一:直接启动
方式二:作为服务运行
启动后,访问 Web UI:
1. 安装时 npm 报错

问题: 或
解决:
2. GitHub 克隆失败
问题:
解决:
3. 端口被占用
问题:
解决:
4. 模型 API 调用失败
检查项:
- API Key 是否正确
- 账户余额是否充足
- 网络连接是否正常
- 模型名称是否匹配
安装完成后,你可以:
- 探索 Web UI:访问 http://localhost:18789 体验图形界面
- 配置消息通道:集成微信、Telegram 等
- 安装 Skills:扩展更多功能(参考 ClawHub)
- 阅读文档:https://docs.openclaw.ai
- 官方文档:https://docs.openclaw.ai
- GitHub 仓库:https://github.com/openclaw/openclaw
- 技能市场:https://clawhub.com
- 社区讨论:https://discord.gg/clawd
最后更新:2026 年 3 月 9 日
*适用版本:OpenClaw v2026.2.24+
作者: openclaw
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/227573.html