OpenClaw Windows 11本地部署详细教程
📋 文档信息
- 版本: 1.0
- 生成日期: 2026年03月11日 16:27:00
- 适用系统: Windows 11 21H2或更高版本
- 验证环境: 基于实际系统测试验证
📖 目录
1. 环境准备与系统要求
1.1 Windows 11系统要求
- 操作系统: Windows 11 21H2或更高版本
- 处理器: 64位处理器，2GHz或更快
- 内存: 8GB RAM（推荐16GB）
- 磁盘空间: 至少10GB可用空间
- 网络: 稳定的互联网连接
- 权限: 管理员权限
1.2 管理员权限设置
- 右键点击"命令提示符"或"PowerShell"
- 选择"以管理员身份运行"
- 确认UAC（用户账户控制）提示
1.3 PowerShell执行策略设置
# 以管理员身份运行PowerShell，设置执行策略
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
2. 必备软件安装
2.1 Node.js安装（必需）
OpenClaw基于Node.js开发，需要Node.js v18或更高版本。
安装方法：
# 使用winget安装Node.js LTS版本
winget install OpenJS.NodeJS.LTS
# 或者从官网下载安装包
# https://nodejs.org/zh-cn/download/
验证安装：
node --version
# 应显示：v18.x.x 或更高
npm --version
# 应显示：9.x.x 或更高
2.2 Git安装（推荐）
用于克隆源码和版本控制。
安装方法：
# 使用winget安装Git
winget install Git.Git
# 或者从官网下载
# https://git-scm.com/download/win
验证安装：
git --version
# 应显示：git version 2.x.x
2.3 Python安装（可选）
某些扩展功能可能需要Python。
安装方法：
# 使用winget安装Python
winget install Python.Python.3.12
验证安装：
python --version
# 应显示：Python 3.12.x
3. OpenClaw安装方法
3.1 方式A：npm全局安装（推荐新手）
最简单快捷的安装方式。
# 安装OpenClaw
npm install -g openclaw-cn
# 验证安装
openclaw --version
# 应显示：0.1.x 或更高版本
3.2 方式B：Git克隆源码安装（开发者）
获取最新功能和源码。
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 安装依赖
npm install
# 链接到全局
npm link
# 验证安装
openclaw --version
3.3 方式C：Docker容器安装（隔离环境）
使用Docker实现环境隔离。
# 拉取镜像
docker pull openclaw/openclaw
# 运行容器
docker run -d --name openclaw -p 3000:3000 openclaw/openclaw
# 查看日志
docker logs openclaw
4. 配置与优化
4.1 基础配置
OpenClaw配置文件位于：C:\Users\<用户名>\.openclaw\config.yaml
基础配置示例：
# config.yaml 基础配置
gateway:
port: 3000
host: localhost
models:
default: deepseek/deepseek-chat
deepseek:
api_key: ${DEEPSEEK_API_KEY}
channels:
webchat:
enabled: true
port: 8080
4.2 中文支持配置
# 添加中文支持
i18n:
default_locale: zh-CN
supported_locales:
- zh-CN
- en-US
# 中文模型配置
models:
default: deepseek/deepseek-chat
deepseek:
api_key: ${DEEPSEEK_API_KEY}
endpoint: https://api.deepseek.com
4.3 性能优化
# 性能优化配置
performance:
max_concurrent_requests: 10
request_timeout: 30000 # 30秒
cache_enabled: true
cache_ttl: 3600 # 1小时
# 内存优化
memory:
max_workspace_size_mb: 1024
auto_cleanup: true
cleanup_interval: 3600 # 1小时
4.4 安全配置
# 安全配置
security:
require_authentication: false # 开发环境可关闭
allowed_origins:
- http://localhost:8080
- http://localhost:3000
# API密钥保护
encrypt_api_keys: true
key_rotation_days: 30
5. 常见问题解决
5.1 安装失败问题
问题：npm install 失败
解决方案：
# 清理npm缓存
npm cache clean --force
# 删除node_modules重新安装
rm -rf node_modules
rm -rf package-lock.json
npm install
问题：权限不足
解决方案：
- 以管理员身份运行命令行
- 或者使用：
npm install -g openclaw-cn --unsafe-perm
5.2 启动错误
问题：端口被占用
解决方案：
# 查看占用端口的进程
netstat -ano | findstr :3000
# 终止进程（替换PID）
taskkill /PID <进程ID> /F
# 或者修改配置使用其他端口
问题：服务无法启动
解决方案：
# 检查日志
openclaw gateway status
openclaw gateway logs
# 重启服务
openclaw gateway restart
5.3 网络连接问题
问题：无法访问API
解决方案：
- 检查网络连接
- 验证API密钥
- 检查防火墙设置
- 尝试使用代理
# 设置代理（如果需要）
set HTTP_PROXY=http://proxy.example.com:8080
set HTTPS_PROXY=http://proxy.example.com:8080
5.4 模型加载失败
问题：DeepSeek API错误
解决方案：
- 检查API密钥是否正确
- 确认账户余额充足
- 检查API端点配置
# 正确配置示例
models:
deepseek:
api_key: "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
endpoint: "https://api.deepseek.com"
6. 使用入门指南
6.1 启动OpenClaw服务
# 启动gateway服务
openclaw gateway start
# 检查状态
openclaw gateway status
# 查看日志
openclaw gateway logs
6.2 访问Web界面
- 启动服务后，打开浏览器
- 访问：http://localhost:8080
- 开始与OpenClaw交互
6.3 基本命令
# 查看帮助
openclaw --help
# 查看版本
openclaw --version
# 列出可用工具
openclaw tools list
# 运行特定任务
openclaw run <任务名称>
6.4 配置管理
# 查看当前配置
openclaw config get
# 更新配置
openclaw config set <键> <值>
# 重新加载配置
openclaw gateway restart
附录A：命令速查表
安装和更新
# 安装
npm install -g openclaw-cn
# 更新
npm update -g openclaw-cn
# 卸载
npm uninstall -g openclaw-cn
服务管理
# 启动
openclaw gateway start
# 停止
openclaw gateway stop
# 重启
openclaw gateway restart
# 状态
openclaw gateway status
# 日志
openclaw gateway logs
配置管理
# 获取配置
openclaw config get
# 设置配置
openclaw config set gateway.port 4000
# 重置配置
openclaw config reset
工具和扩展
# 列出工具
openclaw tools list
# 安装扩展
openclaw extensions install <扩展名>
# 更新扩展
openclaw extensions update <扩展名>
附录B：资源链接
官方资源
- GitHub仓库: github.com/openclaw/op…
- 官方文档: docs.openclaw.ai
- 中文文档: docs.openclaw.ai/zh-CN/
社区支持
- Discord社区: discord.com/invite/claw…
- GitHub Issues: github.com/openclaw/op…
- 技能市场: clawhub.com
相关工具
- Node.js: nodejs.org/zh-cn/
- Git: git-scm.com/
- Docker: www.docker.com/
模型API
- DeepSeek: platform.deepseek.com/api-docs/
- OpenAI: platform.openai.com/docs/api-re…
- Anthropic: docs.anthropic.com/claude/refe…
📝 转换为Word文档的方法
方法1：在线转换（推荐）
- 访问 cloudconvert.com/md-to-docx
- 上传本.md文件
- 点击转换按钮
- 下载转换后的.docx文件
方法2：使用VS Code
- 安装"Markdown to Word"扩展
- 用VS Code打开本文件
- 右键选择"Export to Word"
- 保存为.docx格式
方法3：手动复制
- 在Microsoft Word中新建文档
- 打开本.md文件
- 全选并复制所有内容
- 粘贴到Word文档中
- 调整格式（保留基本结构）
✅ 验证清单
安装验证
- Node.js v18+ 已安装
- npm 已安装
- OpenClaw 已安装
- 服务可正常启动
配置验证
- 配置文件存在
- API密钥已配置
- 端口未被占用
- 网络连接正常
功能验证
- Web界面可访问
- 基本命令可用
- 模型可正常调用
- 工具可正常使用
教程完成时间：2026年03月11日 16:27:00
基于Windows 11实际环境验证
如有问题，请参考第5章常见问题解决方案
