Windows 原生安装 OpenClaw 完整教程

前言

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:\OpenClaw

3.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 restart

5.4 验证权限

重启后，让 AI 执行一个简单命令测试：

用户：帮我查看桌面有什么文件

如果 AI 能正确列出文件，说明权限已生效 ✅

六、设置开机自启动

6.1 使用 OpenClaw 内置服务

# 注册为计划任务（登录时自动启动）
openclaw service install

6.2 验证自启任务

Get-ScheduledTask -TaskName "*openclaw*"

应显示OpenClaw Gateway任务状态为Ready。

七、常用命令速查

八、常见问题

8.1 端口被占用

如果启动失败，提示端口被占用：

# 查看端口占用
netstat -ano | findstr :3000
# 结束进程
taskkill /PID <进程ID> /F

8.2 权限不足

确保以管理员身份运行 PowerShell。

8.3 模型连接失败

• 检查 API Key 是否正确
• 检查网络连接
• 查看日志：openclaw gateway logs

九、进阶配置

9.1 自定义人格

编辑SOUL.md文件，定义 AI 的性格和行为：

# AI 人格设定
你是一个友好的 AI 助手，名字叫小橙。
你擅长技术问题解答，喜欢用幽默的方式交流。
你的回答要简洁明了，避免冗长。

9.2 添加技能

OpenClaw 支持扩展技能，可以从技能市场安装：

openclaw skill install 

9.3 配置记忆系统

编辑MEMORY.md，设置长期记忆策略：

# 记忆配置
- 保存用户偏好设置
- 记录重要对话内容
- 定期清理过期记忆
- 支持记忆检索和更新

十、总结

恭喜！你已经成功在 Windows 上原生安装并配置了 OpenClaw。现在你可以：

• 通过多种通道与 AI 助手交互
• 自定义 AI 的人格和行为
• 扩展各种实用技能
• 让 AI 执行文件操作等工具任务

OpenClaw 的强大之处在于其灵活性和可扩展性。随着你的深入使用，你会发现更多有趣的功能和玩法。