前言

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。

七、常用命令速查

命令	说明
openclaw gateway start	启动 Gateway
openclaw gateway stop	停止 Gateway
openclaw gateway restart	重启 Gateway
openclaw gateway status	查看状态
openclaw config list	查看配置
openclaw config set key value	设置配置项
openclaw service install	安装服务
openclaw service uninstall	卸载服务

八、常见问题

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 的强大之处在于其灵活性和可扩展性。随着你的深入使用，你会发现更多有趣的功能和玩法。

感谢您的来访，获取更多精彩文章请收藏本站。