本教程旨在帮助你在 Windows 上顺利下载、配置并开始使用 OpenClaw——一个强大的本地 AI 智能体（小龙虾）。它无需编写代码，即可通过自然语言自动操控电脑、整理文件、提取内容，所有数据均保留在你的设备上，安全又省心。
- 1. 环境准备 (Node.js 24+)
- 2. 安装 Git (含国内镜像加速)
- 3. 下载与初始化 OpenClaw
- 4. 社区技能 (Skills) 安装指南
- 5. 国内主流大模型推荐与配置
- 6. 常见问题与最佳实践
OpenClaw 需要 Node.js v24 或更高版本作为运行环境。
- 访问 Node.js 官方网站 下载 v24+ 版本的
.msi安装包（推荐 LTS 版本）。 - 双击运行安装包，一路点击 "Next"，使用默认设置即可。
- 安装完成后，打开 PowerShell 或 命令提示符，输入以下命令验证安装：
node --version # 应输出类似 v24.x.x 的信息 npm --version
- 使用 Homebrew 包管理器安装：
brew install node@24
- 验证安装：
node --version npm --version
# 使用 NodeSource 官方源安装 Node.js 24.x
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs
node --versionOpenClaw 的某些技能（Skills）可能需要从 Git 仓库拉取代码。
- 国内镜像 (推荐)：访问 npmmirror Git for Windows 镜像站 下载最新版。
- 运行下载的
.exe安装包，按提示完成安装。
brew install gitsudo apt update
sudo apt install gitgit --version
# 应输出类似 git version 2.4x.x 的信息本部分涵盖使用官方脚本进行全自动安装。
- 以管理员身份打开 PowerShell。
- 执行以下命令：
iwr -useb https://openclaw.ai/install.ps1 | iex
该脚本会自动检测并安装 Node.js 及 OpenClaw 所需的所有依赖。
curl -fsSL https://openclaw.ai/install.sh | bash安装脚本会自动处理所有依赖，整个过程大约需要 3-5 分钟。
安装成功后，终端会启动一个新手引导程序 (Onboarding Wizard)。
- 选择快速安装模式：选择
QuickStart并回车。 - 配置模型 (Model)：
- 国内用户：推荐选择
Moonshot AI (Kimi)或智谱AI (GLM)。 - 根据提示，从对应平台获取并粘贴你的 API Key。
- 如果不确定，可以暂时跳过此步，后续在配置文件中手动添加（详见第 5 节）。
- 国内用户：推荐选择
- 选择聊天载体：首次体验可以选择
TUI（终端聊天界面）。 - 安装推荐技能：根据提示选择是否安装一些官方推荐的基础技能，初学者建议选择
Yes。
- 安装完成后，终端会显示
Gateway 在线或类似字样。 - 你也可以输入
openclaw status来查看服务运行状态。
技能 (Skills) 是 OpenClaw 的“超能力”，可以赋予它如处理天气、编写代码、浏览器自动化等特定功能。
ClawHub 是 OpenClaw 的官方技能市场。
- 安装 ClawHub CLI 工具：
npm install -g clawhub
- 搜索技能：
clawhub search "browser" - 安装技能：
clawhub install <技能名称>
例如：
clawhub install agent-browser-clawdbot
如果 clawhub 下载缓慢或失败，可采用手动方式：
- 访问 ClawHub 技能市场，搜索并下载你需要的技能包 (
.zip文件)。 - 解压下载的压缩包，你会得到一个文件夹（例如
agent-browser-clawdbot）。 - 将该文件夹完整地复制到 OpenClaw 的技能目录下：
C:\Users\<你的Windows用户名>\.openclaw-autoclaw\skills\注意：如果
.openclaw-autoclaw\skills目录不存在，请手动创建。 - 重启 OpenClaw 服务，新技能即会生效。
OpenClaw 自身不带 AI 模型，需要接入云端 API 或本地模型来赋予它“智慧”。以下是国内用户的首选方案。
| 模型 | 特点 | 推荐场景 | 如何获取 API Key |
|---|---|---|---|
| DeepSeek | 逻辑王者，擅长复杂推理、数学和代码生成 | 编程开发、数据分析、复杂问题求解 | 访问 DeepSeek 开放平台 注册并创建 |
| 智谱AI (GLM) | 中文能手，对中文理解深刻，适合内容创作 | 文案撰写、办公文档、内容生成 | 访问 智谱AI开放平台 注册并创建 |
| 通义千问 (Qwen) | 免费大户，通用能力强，提供大量免费额度，性价比极高 | 日常对话、通用任务、成本敏感场景 | 访问 阿里云百炼 开通并获取 |
| 月之暗面 (Kimi) | 长文专家，超长上下文处理能力一流，适合处理长文档 | 阅读并分析长篇报告、论文或合同 | 访问 Moonshot AI 控制台 创建 |
安装时若跳过了模型配置，可以手动编辑配置文件 ~/.openclaw/openclaw.json。
以下是一个配置 DeepSeek 和智谱 GLM 的示例，供你参考：
{
"models": {
"mode": "merge",
"providers": {
"deepseek": {
"api": "openai-completions",
"apiKey": "你的DeepSeek-API-Key",
"baseUrl": "https://api.deepseek.com/v1",
"models": [
{
"id": "deepseek-chat",
"name": "DeepSeek-Chat",
"contextWindow": 64000,
"maxTokens": 4096
}
]
},
"zhipu": {
"api": "openai-completions",
"apiKey": "你的智谱-API-Key",
"baseUrl": "https://open.bigmodel.cn/api/paas/v4",
"models": [
{
"id": "glm-4-flash",
"name": "GLM-4-Flash",
"contextWindow": 128000,
"maxTokens": 4096
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "deepseek/deepseek-chat",
"fallback": "zhipu/glm-4-flash"
}
}
}
}提示：
fallback配置是备选模型，当主模型不可用时（如额度用尽），OpenClaw 会自动切换。
-
安装/启动失败，提示被杀毒软件拦截？
- 这是最常见的问题。请务必将 OpenClaw 的安装目录添加到杀毒软件（如 Windows Defender、360、火绒）的白名单中。OpenClaw 需要操控文件系统，容易被误判。
-
一直显示“等待 Gateway 在线”？
- 检查杀毒软件：这是首要排查点，确保已将 OpenClaw 加入白名单。
- 重启服务：点击界面右上角的“重启服务”按钮，等待 1-3 分钟。
- 检查网络：确保网络连接正常，并暂时关闭代理/VPN 软件。
-
安装路径包含中文或空格？
- 请务必将 OpenClaw 安装在全英文路径下，例如
D:\OpenClaw。包含中文或空格的路径可能导致未知错误。
- 请务必将 OpenClaw 安装在全英文路径下，例如
-
如何获得更准确的执行结果？
- 指令清晰：像与人对话一样，尽量把任务描述得越详细越好。
- 善用技能 (Skills)：为你的“小龙虾”安装合适的技能，能让它如虎添翼，更高效地完成任务。
至此，你已成功在本地搭建起 OpenClaw 并拥有了一个完全私有的 AI 智能体。现在，你可以开始探索它强大的自动化能力了！
如果你有任何问题或想分享有趣的技能，欢迎提交 Issue 或 Pull Request。
📄 许可说明：本项目仅作为教程分享，OpenClaw 本身遵循其官方的开源协议。
