OpenClaw 安装/卸载指南:Windows 版完整教程

# 打开 PowerShell 或 CMD 管理员权限打开node --versionnpm --version

# 验证安装python --versionpip --version

2.3 安装 Git

# 验证安装git --version

# 使用管理员权限运行 PowerShellnpm install --global windows-build-tools

或者手动下载安装： Visual Studio Build Tools

(https://visualstudio.microsoft.com/visual-cpp-build-tools)

# 全局安装 OpenClaw CLInpm install -g openclaw# 验证安装openclaw --version

# 克隆仓库git clone https://github.com/openclaw/openclaw.gitcd openclaw# 安装依赖npm install# 构建项目npm run build# 链接到全局（可选）npm link

四、配置 OpenClaw

4.1 初始化配置

# 创建配置目录mkdir %USERPROFILE%\.openclaw# 初始化配置文件openclaw init

4.2 配置 AI 模型（国内大模型）

编辑配置文件%USERPROFILE%\.openclaw\config.yaml：

# OpenClaw 配置文件# AI 模型配置（使用国内大模型）models:  default: qwen  # 阿里千问（推荐）  qwen:    provider: openai  # 千问兼容 OpenAI 格式    api_key: sk-your-qwen-api-key-here    base_url: https://dashscope.aliyuncs.com/compatible-mode/v1    model: qwen-plus  # DeepSeek（性价比高）  deepseek:    provider: openai  # DeepSeek 兼容 OpenAI 格式    api_key: sk-your-deepseek-api-key-here    base_url: https://api.deepseek.com    model: deepseek-chat  # 腾讯混元（元宝）  hunyuan:    provider: openai    api_key: your-hunyuan-api-key-here    base_url: https://api.hunyuan.cloud.tencent.com/v1    model: hunyuan-turbos-latest# 网关配置gateway:  host: localhost  port: 8080# 日志配置logging:  level: info  file: %USERPROFILE%\.openclaw\logs\openclaw.log

4.3 配置环境变量

# 设置环境变量（PowerShell,管理员权限）- 使用千问[Environment]::SetEnvironmentVariable("QWEN_API_KEY", "sk-your-qwen-key", "User")[Environment]::SetEnvironmentVariable("OPENCLAW_CONFIG_PATH", "%USERPROFILE%\.openclaw", "User")# 或者使用 DeepSeek[Environment]::SetEnvironmentVariable("DEEPSEEK_API_KEY", "sk-your-deepseek-key", "User")# 刷新环境变量$env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")

五、启动 OpenClaw

5.1 启动网关服务

# 启动 OpenClaw 网关openclaw gateway start# 或者后台运行openclaw gateway start --daemon

5.2 验证服务状态

# 检查网关状态openclaw gateway status# 测试连接openclaw ping
5.3常用命令
# 查看帮助openclaw --help# 查看版本openclaw --version# 启动交互式会话openclaw chat# 运行特定技能openclaw skill run <skill-name># 查看日志openclaw logs# 停止服务openclaw gateway stop

六、安装技能（Skills）

6.1 浏览可用技能

# 列出官方技能openclaw skill list# 搜索技能openclaw skill search <keyword>

6.2 安装技能

# 安装特定技能openclaw skill install weather# 安装多个技能openclaw skill install weather news calculator# 从 GitHub 安装openclaw skill install github:username/repo

6.3 常用技能推荐

七、更新与卸载

7.1 更新 OpenClaw

# 使用 npm 更新npm update -g openclaw# 或者重新安装npm install -g openclaw@latest

7.2 卸载 OpenClaw

# 卸载全局包npm uninstall -g openclaw# 删除配置文件rmdir /s %USERPROFILE%\.openclaw# 删除环境变量（手动）

八、常见问题解决

8.1 安装问题（Windows）

问题 1：npm 安装失败

# 错误信息：permission denied# 解决方案：使用管理员权限运行 PowerShell# 或者以普通用户身份安装到本地npm install openclaw --prefix %USERPROFILE%\openclaw

问题 2：node-gyp 编译错误

# 安装 windows-build-toolsnpm install --global windows-build-tools# 或者使用 chocochoco install visualstudio2017buildtools

问题 3：Python 找不到

# 检查 Python 路径where python# 手动设置 Python 路径npm config set python python3.11

8.2 运行问题

问题 1：网关启动失败

# Windows：检查端口占用netstat -ano | findstr :8080# macOS：检查端口占用lsof -i :8080# 更换端口openclaw gateway start --port 8081

问题 2：API 密钥无效

# Windows：检查配置文件type %USERPROFILE%\.openclaw\config.yaml# macOS：检查配置文件cat ~/.openclaw/config.yaml# 重新初始化openclaw init --force

问题 3：技能加载失败

# 清除技能缓存openclaw skill cache clear# 重新安装技能openclaw skill reinstall <skill-name>

8.3 性能问题

问题1：响应慢

# 检查网络连接（国内模型通常更快更稳定）ping dashscope.aliyuncs.com# 切换到更快的模型openclaw config set model qwen-turbo  # 千问快速版# 或者切换到 DeepSeek（性价比高）openclaw config set model deepseek-chat# 启用本地缓存openclaw config set cache.enabled true

问题2：API Key 无效

# 确认使用的是国内模型的 API Key# 千问：在 https://bailian.console.aliyun.com/ 获取# DeepSeek：在 https://platform.deepseek.com/ 获取# 检查配置cat %USERPROFILE%\.openclaw\config.yaml

安装完成后，你就可以开始使用 OpenClaw 构建强大的 AI Agent 了！

友好建议：不懂技术的不要安装，可能会半途而废。

看完本文有收获？点赞、分享是最大的支持！