一篇带你从零开始部署个人 AI 助手的保姆级教程
前言
OpenClaw 是一个开源的个人 AI 助手框架，支持多种大模型、多通道消息接入，还能扩展技能和工具。相比 Docker 部署，原生安装更轻量、更灵活，适合想要深度定制的用户。
本文将详细介绍在 Windows 系统上原生安装 OpenClaw 的完整流程，包括一个关键但容易被忽略的步骤——开启工具权限。
更详细的教程请访问：
一、环境准备
1.1 安装 Node.js
OpenClaw 基于 Node.js 开发，需要先安装 Node.js 环境。
下载地址： https://nodejs.org/
推荐安装LTS 长期支持版（目前为 v20.x 或更高版本）
安装时建议勾选以下选项：
✅ Automatically install the necessary tools（自动安装必要工具）
✅ Add to PATH（添加到环境变量）
安装
完成后，打开 PowerShell 验证：
node -v
npm -v如果显示版本号，说明安装成功。
1.2 安装 Git（可选但推荐）
用于后续更新和管理配置文件。
下载地址： https://git-scm.com/download/win
二、安装 OpenClaw
2.1 全局安装
打开 PowerShell，执行以下命令：
npm install -g openclaw安装过程可能需要几分钟，请耐心等待。
2.2 验证安装
openclaw --version显示版本号即安装成功。
三、初始化配置
3.1 创建工作目录
# 创建工作目录（可自定义位置）
mkdir D:\OpenClaw
cd D:\OpenClaw3.2 初始化配置文件
openclaw init这会在当前目录生成配置文件结构：
D:\OpenClaw\
├── AGENTS.md # Agent 行为指南
├── SOUL.md # 人格设定
├── USER.md # 用户信息
├── MEMORY.md # 长期记忆
├── TOOLS.md # 工具说明
├── HEARTBEAT.md # 心跳任务
└── memory/ # 记忆存储目录3.3 配置模型
编辑配置文件（位于~/.openclaw/openclaw.json或工作目录），添加你的模型 API：
{
"model": "your-model-provider/model-name",
"apiKey": "your-api-key"
}支持的模型提供商包括：
OpenAI
Claude (Anthropic)
智谱 GLM
阿里云百炼
DeepSeek
其他兼容 OpenAI API 的服务
四、启动服务
4.1 启动 Gateway
在工作目录执行：
openclaw gateway start服务启动后，你会看到日志输出，表示 AI 助手已就绪。
4.2 查看状态
openclaw gateway status五、开启工具权限
这是最关键的一步！默认情况下，OpenClaw 的工具功能是禁用的，需要手动开启。
5.1 编辑配置文件
打开配置文件，找到或添加以下配置：
{
"tools": {
"enabled": true,
"allow": {
"fileSystem": true,
"webSearch": true,
"codeExecution": false
}
}
}5.2 配置说明
enabled: true- 启用工具功能fileSystem: true- 允许访问文件系统（读写文件）webSearch: true- 允许网络搜索codeExecution: false- 禁用代码执行（安全考虑）
5.3 重启服务
openclaw gateway restart5.4 验证权限
重启后，让 AI 执行一个简单命令测试：
用户：帮我查看桌面有什么文件如果 AI 能正确列出文件，说明权限已生效 ✅
六、配置消息通道
OpenClaw 支持多种消息通道，让你的 AI 助手无处不在。
6.1 支持的通道
6.2 以 QQ Bot 为例
前往 QQ 开放平台创建机器人
获取 AppID 和 Token
编辑配置文件：
{
"channels": {
"qqbot": {
"allow": true,
"allowFrom": ["*"],
"appId": "your-app-id",
"clientSecret": "your-token"
}
}
}重启 Gateway
七、设置开机自启动
7.1 使用 OpenClaw 内置服务
# 注册为计划任务（登录时自动启动）
openclaw service install7.2 验证自启任务
Get-ScheduledTask -TaskName "*openclaw*"应显示OpenClaw Gateway任务状态为Ready。
八、常用命令速查
九、常见问题
9.1 端口被占用
如果启动失败，提示端口被占用：
# 查看端口占用
netstat -ano | findstr :3000
# 结束进程
taskkill /PID <进程ID> /F9.2 权限不足
确保以管理员身份运行 PowerShell。
9.3 模型连接失败
检查 API Key 是否正确
检查网络连接
查看日志：
openclaw gateway logs
十、进阶配置
10.1 自定义人格
编辑SOUL.md文件，定义 AI 的性格和行为：
# AI 人格设定
你是一个友好的 AI 助手，名字叫小橙。
你擅长技术问题解答，喜欢用幽默的方式交流。
你的回答要简洁明了，避免冗长。10.2 添加技能
OpenClaw 支持扩展技能，可以从技能市场安装：
openclaw skill install 10.3 配置记忆系统
编辑MEMORY.md，设置长期记忆策略：
# 记忆配置
- 保存用户偏好设置
- 记录重要对话内容
- 定期清理过期记忆
- 支持记忆检索和更新十一、总结
恭喜！你已经成功在 Windows 上原生安装并配置了 OpenClaw。现在你可以：
通过多种通道与 AI 助手交互
自定义 AI 的人格和行为
扩展各种实用技能
让 AI 执行文件操作等工具任务
OpenClaw 的强大之处在于其灵活性和可扩展性。随着你的深入使用，你会发现更多有趣的功能和玩法。
十二、相关资源
官方文档： https://docs.openclaw.com
GitHub 仓库： https://github.com/openclaw/openclaw
社区论坛： https://forum.openclaw.com
技能市场： https://clawhub.com