Windows系统OpenClaw部署保姆级教程 – 从零开始配置5个智能体

🦞 Windows 系统 OpenClaw 部署保姆级教程

从零开始配置5个智能体 · 图文并茂 · 终端命令详解

📖 字数：4000+👶 适合小白用户📦 包含完整部署流程

1. 什么是OpenClaw？它的前世今生

OpenClaw是一个开源的多渠道AI网关系统，它能够让你的AI助手同时在多个平台（如企业微信、QQ、飞书、钉钉、Telegram等）上运行，并且支持自定义智能体（Agents）来处理不同类型的任务。

发展历程

OpenClaw项目始于对AI助手多平台部署需求的探索。传统的AI助手往往只能在一个平台上运行，而OpenClaw通过模块化架构和插件系统，实现了真正的跨平台AI助手部署。当前最新版本为 2026.4.22，采用MIT开源许可证，完全免费使用。

核心理念

OpenClaw的核心理念是”一个AI，多平台运行”。通过统一的后端管理系统，你可以轻松地在不同平台上部署相同的AI能力，同时还可以根据每个平台的特点进行个性化定制。

💡 小贴士

OpenClaw不仅是一个AI网关，更是一个完整的AI助手生态系统。你可以通过配置不同的智能体来实现专业化的任务分工，比如让一个智能体专门负责写代码，另一个专门负责设计图片。

2. OpenClaw有什么本事？都能做什么

核心功能

OpenClaw提供了丰富的功能特性，主要包括：

✅ 多渠道集成

支持20+种消息渠道，包括：

企业办公

：飞书、钉钉、企业微信
社交平台

：QQ 等

✅ 智能体系统

支持创建和管理多个专业智能体，每个智能体可以有不同的角色和能力：

任务分工

：不同智能体处理不同类型的任务
模型选择

：每个智能体可以使用不同的AI模型
工作空间隔离

：每个智能体有独立的工作目录
协作机制

：智能体之间可以相互调用和协作
子智能体控制

：可配置每个智能体允许调用的子智能体列表

✅ 强大的工具集成

内置丰富的工具支持：

文件操作

：读写文件、管理目录
网络请求

：HTTP请求、网页抓取
浏览器控制

：自动化网页操作
系统命令

：执行终端命令
多媒体处理

：图片生成、语音合成、视频生成

✅ 安全与权限管理

提供完善的安全机制：

访问控制

：基于令牌（Token）的身份验证
权限分级

：不同用户不同权限级别
敏感信息管理

：配置文件权限控制，API 密钥在日志和界面显示时自动脱敏（redact）
审计日志

：完整的操作日志记录

3. 如何拥有它？部署硬件条件

系统要求

OpenClaw可以在多种操作系统上运行，本文重点介绍Windows系统的部署。以下是最低系统要求：

💻 操作系统要求

Windows 10 或更高版本（推荐 Windows 11）
64位操作系统
管理员权限（用于安装软件和配置环境）

⚙️ 硬件要求

📝 说明：以下硬件要求为经验估算值，实际需求取决于使用场景和并发量。

CPU

：Intel i5 或 AMD Ryzen 5 及以上
内存

：8GB RAM（推荐 16GB 或更多）
存储

：至少 10GB 可用磁盘空间
网络

：稳定的互联网连接

📝 注意事项：虽然OpenClaw本身对硬件要求不高，但如果你计划运行多个智能体或处理大量并发请求，建议配置更高的硬件规格。特别是内存，每个智能体都会占用一定的内存资源。

软件依赖

在开始部署之前，你需要先安装以下软件：

📦 Node.js 运行环境

OpenClaw基于Node.js开发，需要安装 Node.js v22 LTS 或更高版本。

为什么需要这个版本？因为OpenClaw使用了Node.js 22中的一些新特性，低版本可能无法正常运行。

🔧 Git 版本控制工具

用于克隆OpenClaw源代码仓库（仅源码安装需要），建议安装最新版本的Git for Windows。

🌐 Web浏览器

用于访问OpenClaw的Web管理界面，推荐使用Chrome、Edge或Firefox最新版本。

4. Windows系统详细部署步骤

安装方式选择

OpenClaw提供两种安装方式：

方式A（推荐）

：npm 全局安装

简单快捷，适合大多数用户
方式B

：源码安装

适合需要开发或定制的用户

方式A：npm 全局安装（推荐）

1安装 Node.js

访问 Node.js官方网站
下载 LTS版本（长期支持版本），确保版本号 >= 22
运行安装程序，按照向导完成安装
验证安装是否成功

CMD:: 打开命令提示符（CMD）或 PowerShell:: 输入以下命令查看Node.js版本node --version:: 查看npm版本npm --version

命令解释：

node --version

：显示已安装的Node.js版本
npm --version

：显示npm（Node包管理器）版本

如果显示的版本号符合要求（Node.js >= v22），说明安装成功。

2安装 Git（可选）

如果需要克隆代码仓库或进行版本管理，建议安装Git：

访问 Git官方网站
下载 Git for Windows
运行安装程序，建议使用默认设置
验证安装

CMD:: 在命令提示符中输入git --version

3安装 OpenClaw

CMD:: 全局安装 OpenClawnpm install -g openclaw:: 验证安装openclaw --version

4启动 OpenClaw

CMD:: 启动 OpenClaw Gatewayopenclaw gateway start

启动成功后，你会看到类似这样的输出：

OUTPUTOpenClaw gateway listening on http://localhost:18789

💡 小贴士

OpenClaw默认监听端口 18789。你可以在浏览器中访问 http://localhost:18789 来打开Web管理界面。

⚠️ 常见问题

如果安装 node-llama-cpp 等本地编译包时遇到报错，需要安装 Visual Studio Build Tools：

访问 Visual C++ Build Tools 官方下载页面

下载并安装 Visual Studio Build Tools

关键操作：务必勾选 “使用 C++ 的桌面开发” 这个工作负载

右侧的”安装详细信息”中，默认包含的 Windows 10/11 SDK 和 MSVC 编译器即可

方式B：源码安装

1克隆源代码

CMD:: 创建工作目录mkdir C:\openclawcd C:\openclaw:: 克隆OpenClaw源代码git clone https://github.com/openclaw/openclaw.git:: 进入项目目录cd openclaw

2安装依赖包

OpenClaw支持 npm 和 pnpm 作为包管理器。

CMD:: 使用 npm 安装npm install:: 或使用 pnpm（需要先安装 pnpm）:: npm install -g pnpm:: pnpm install

3构建项目（仅源码安装需要）

CMD:: 使用 npm 构建npm run build:: 或使用 pnpm 构建:: pnpm build

⚠️ 注意：如果在 CMD 中运行 pnpm build 报”bash 不是内部或外部命令”，请在 Git Bash 中运行，路径格式如 /c/openclaw/（相当于 C:\openclaw\）。

4启动

CMD:: 源码安装启动方式node openclaw.mjs

配置基本设置

5配置AI模型

OpenClaw需要配置AI模型才能正常工作。编辑配置文件：

CMD:: 创建配置目录（首次运行时 OpenClaw 会自动创建）:: 配置文件位置：:: Windows: %USERPROFILE%\.openclaw\openclaw.json:: Linux/Mac: ~/.openclaw/openclaw.json:: 使用记事本编辑配置文件notepad %USERPROFILE%\.openclaw\openclaw.json

在配置文件中添加你的AI模型API密钥。以下是一个使用通义千问（Qwen）的示例配置：

JSON{"models": {"providers": {"generic": {"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1","apiKey": "your-dashscope-api-key-here","api": "openai-completions","models": [          {"id": "qwen3.6-plus","name": "Qwen 3.6 Plus","contextWindow": 999999,"maxTokens": 4096          },          {"id": "glm-5","name": "GLM-5","contextWindow": 202752,"maxTokens": 16384          },          {"id": "MiniMax-M2.5","name": "MiniMax M2.5","contextWindow": 204800,"maxTokens": 131072          }        ]      }    }  }}

📝 注意事项

你需要将 your-dashscope-api-key-here 替换为你实际的阿里云 DashScope API 密钥。

💡 提示：qwen3.6-plus 是通义千问模型之一，你可以根据需要选择其他模型如 glm-5、MiniMax-M2.5 等。

支持的AI提供商包括：

通义千问（阿里云 DashScope）
Google Gemini
百度千帆
腾讯混元
MiniMax
DeepSeek
OpenAI（需科学上网）
Anthropic（需科学上网）

💡 提示：每个提供商下有不同的模型。模型 ID 需要与配置中定义的一致。

5. 配置5个智能体详细指南

OpenClaw的强大之处在于其智能体系统。通过配置5个不同角色的智能体，你可以实现专业的任务分工。下面详细介绍如何配置这5个智能体。

5个智能体的角色介绍

🎨

美术设计师

art-designer

图像生成、视觉设计、UI/UX设计

✍️

营销文案专家

marketing-writer

文案写作、营销内容创作

🛠️

系统运维工程师

sys-ops

系统监控、故障排查、性能优化

🔍

资料搜集研究员

data-researcher

信息搜集、数据分析、市场调研

🦐

虾兵T800

shrimp-t800

编程开发、代码调试、技术方案设计

1创建智能体目录结构

在 OpenClaw 工作目录下为每个智能体创建独立的工作空间：

CMD:: 进入 OpenClaw 工作目录cd %USERPROFILE%\.openclaw:: 创建 workspace-agents 目录mkdir workspace-agents:: 为每个智能体创建独立的工作目录mkdir workspace-agents\art-designermkdir workspace-agents\marketing-writermkdir workspace-agents\sys-opsmkdir workspace-agents\data-researchermkdir workspace-agents\shrimp-t800

每个智能体都有独立的目录，这样可以避免文件冲突和权限问题。

2为每个智能体创建 IDENTITY.md 文件

在每个智能体的工作目录中创建 IDENTITY.md 文件，定义智能体的身份信息。这是 OpenClaw Agent 工作空间的约定文件。

art-designer/IDENTITY.md：

MARKDOWN# IDENTITY.md- Name: 美术设计师- Creature: 视觉创意专家- Vibe: 创意、艺术、细致- Emoji: 🎨

marketing-writer/IDENTITY.md：

MARKDOWN# IDENTITY.md- Name: 营销文案专家- Creature: 文案创作专家- Vibe: 专业、有说服力、创意- Emoji: ✍️

sys-ops/IDENTITY.md：

MARKDOWN# IDENTITY.md- Name: 系统运维工程师- Creature: 技术运维专家- Vibe: 严谨、可靠、高效- Emoji: 🛠️

data-researcher/IDENTITY.md：

MARKDOWN# IDENTITY.md- Name: 资料搜集研究员- Creature: 信息分析专家- Vibe: 仔细、客观、全面- Emoji: 🔍

shrimp-t800/IDENTITY.md：

MARKDOWN# IDENTITY.md- Name: 虾兵T800- Creature: 代码开发专家- Vibe: 专业、精准、高效- Emoji: 🦐

3为每个智能体创建 SOUL.md 文件

SOUL.md 文件定义了智能体的核心能力和工作方式。以下是一个通用模板：

MARKDOWN# SOUL.md - [智能体名称]## 🎯 核心能力### 专业技能- [列出该智能体的专业技能]### 工作风格- [描述工作风格和特点]## 📋 工作流程### 接收任务时1. 确认任务目标和预期成果2. 评估复杂度和所需资源3. 给出时间估算4. 确认优先级### 执行任务时1. 按专业领域执行任务2. 保持高质量标准3. 遇到问题及时报告4. 记录关键决策### 任务完成后1. 总结交付物2. 记录经验教训3. 更新相关文档

你需要根据每个智能体的特点，修改相应的 SOUL.md 文件内容。

4在 openclaw.json 中注册智能体

编辑主配置文件，将5个智能体添加到 agents.list 数组中。

必填字段：

id

: 智能体唯一标识
model

: 为该智能体分配的 AI 模型（格式：提供商ID/模型ID）

可选字段：

name

: 智能体显示名称
workspace

: 工作目录路径（每个智能体的独立工作空间）
agentDir

: Agent 配置目录（存储 SOUL.md、IDENTITY.md 等文件的目录，通常可省略，系统会自动在 ~/.openclaw/agents/ 下创建）
identity

: 设置智能体显示名称和 emoji
subagents

: 配置该智能体允许调用的子智能体列表
runtime

: 配置 ACP 运行时（用于集成 Codex、Claude Code 等外部编码助手）

以下是一个实战配置示例，为每个智能体分配了不同的模型：

JSON{"agents": {"list": [      {"id": "main","name": "main","model": "generic/qwen3.6-plus"      },      {"id": "art-designer","name": "art-designer","workspace": "C:\\Users\\你的用户名\\.openclaw\\workspace-agents\\art-designer","model": "generic/qwen3.6-plus","identity": {"name": "美术设计师","emoji": "🎨"        }      },      {"id": "marketing-writer","name": "marketing-writer","workspace": "C:\\Users\\你的用户名\\.openclaw\\workspace-agents\\marketing-writer","model": "generic/MiniMax-M2.5","identity": {"name": "营销文案专家","emoji": "✍️"        }      },      {"id": "sys-ops","name": "sys-ops","workspace": "C:\\Users\\你的用户名\\.openclaw\\workspace-agents\\sys-ops","model": "generic/glm-5","identity": {"name": "系统运维工程师","emoji": "🛠️"        }      },      {"id": "data-researcher","name": "data-researcher","workspace": "C:\\Users\\你的用户名\\.openclaw\\workspace-agents\\data-researcher","model": "generic/qwen3-max-2026-01-23","identity": {"name": "资料搜集研究员","emoji": "🔍"        }      },      {"id": "shrimp-t800","name": "shrimp-t800","workspace": "C:\\Users\\你的用户名\\.openclaw\\workspace-agents\\shrimp-t800","model": "generic/glm-5","identity": {"name": "虾兵T800","emoji": "🦐"        }      }    ]  }}

📝 注意事项

Windows 路径

：在 JSON 文件中使用双反斜杠（\\）转义

模型选择

：每个智能体可以使用不同的 AI 模型，根据任务特点选择最合适的模型

模型 ID 必须存在

：引用的模型 ID 必须在对应的 provider 下有定义，否则智能体无法正常工作

5重启 OpenClaw 并测试

完成配置后，重启 OpenClaw 服务：

CMD:: 重启 OpenClawopenclaw gateway restart

然后可以通过以下方式测试智能体：

在Web界面中选择不同的智能体进行对话
通过命令行发送消息到特定智能体
检查每个智能体的工作目录是否有正确的文件结构

💡 测试建议

可以给每个智能体发送一个简单的自我介绍请求，比如”请介绍一下你自己”，看看它们是否能正确识别自己的角色和能力。

6. 性能优化与日常维护

性能优化建议

内存优化

运行多个智能体会消耗较多内存，建议进行以下优化：

限制并发数量：在 agents.defaults 中设置 maxConcurrent 参数
使用合适的模型：为不同任务选择合适大小的模型
定期清理缓存：删除不必要的临时文件和日志

启动优化

为了加快启动速度，可以：

预编译依赖：使用 npm install --prefer-offline
禁用不必要的插件：在配置文件中关闭不需要的渠道插件
使用SSD存储：将OpenClaw安装在SSD上可以显著提升性能

日常维护

版本更新

定期更新OpenClaw到最新版本：

CMD:: npm 全局安装更新npm install -g openclaw@latest:: 源码安装更新cd C:\openclaw\openclawgit pullnpm installnpm run build

备份配置

定期备份重要配置文件：

%USERPROFILE%\.openclaw\openclaw.json
各个智能体的工作目录
自定义的技能文件

监控日志

OpenClaw 的日志默认输出到终端。如需查看运行状态：

CMD:: 查看 OpenClaw 状态openclaw status

7. 常见问题解答

Q1: 安装过程中出现”node: command not found”错误

A: 这说明Node.js没有正确安装或没有添加到系统PATH环境变量中。请重新安装Node.js，并确保在安装过程中勾选”Add to PATH”选项。

Q2: 启动OpenClaw时端口被占用

A: OpenClaw默认使用18789端口。如果该端口被其他程序占用，可以在配置文件中修改端口：

{"gateway": {"port": 18790  }}

Q3: 智能体无法正常响应

A: 检查以下几点：

AI模型API密钥是否正确配置
智能体的工作目录路径是否正确
网络连接是否正常
日志文件中是否有错误信息

Q4: Windows Defender阻止OpenClaw运行

A: OpenClaw是开源软件（MIT许可证），不会包含恶意代码。你可以在Windows Defender中将OpenClaw目录添加到排除列表中。

Q5: 如何添加新的智能体？

A: 按照第5节的方法，创建新的工作目录、IDENTITY.md 和 SOUL.md 文件，然后在 openclaw.json 的 agents.list 中注册即可。