使用minimax自动化本地部署openclaw操作历程

欢迎使用 OpenClaw！本文档将引导你在 Windows 系统上从零开始完成 OpenClaw 的本地部署，并配置核心功能。

https://img.shields.io/badge/Node.js-18.x%2520%257C%252020.x-brightgreen
https://img.shields.io/badge/OpenClaw-latest-blue
https://img.shields.io/badge/License-MIT-yellow

📑 目录

1. 环境准备
1. 安装核心软件
- 2.1 安装 Node.js
- 2.2 安装 Git
1. 安装与配置 OpenClaw
- 3.1 安装 OpenClaw CLI
- 3.2 配置 MiniMax API Key（必需）
- 3.3 配置环境依赖（.NET SDK）
1. 启动与使用 OpenClaw
- 4.1 启动 Gateway 网页控制台
- 4.2 配置邮件通知功能（可选）
- 4.3 创建你的第一个定时任务
1. 进阶配置
- 5.1 设置开机自启动
1. 常见问题与解决
1. 快速参考

1. 环境准备

在开始之前，请确保你的系统满足以下要求：

操作系统： Windows 10 或 Windows 11 (64位)
网络： 稳定的互联网连接，以下载必要的软件包。
磁盘空间： 建议至少 2GB 可用空间。

💡 推荐目录结构

为了便于管理，建议在 D:\ 盘创建如下文件夹结构，用于统一存放开发工具：

text
复制代码
D:\software\
├── node\          # Node.js 安装目录
└── git\           # Git 安装目录

2. 安装核心软件

2.1 安装 Node.js

OpenClaw 基于 Node.js 运行，因此需要先安装它。

下载： 访问 Node.js 官网，下载 LTS（长期支持） 版本的 Windows 安装包 (.msi 文件)。
安装：
- 双击运行安装程序。
- 在 Destination Folder 步骤，将安装路径修改为 D:\software\node。
- 保持其他默认设置不变，一路点击 "Next" 完成安装。
验证：

打开 命令提示符 (cmd) 或 PowerShell，输入以下命令：

powershell
复制代码
```
node -v
# 应输出类似 v20.x.x
npm -v
# 应输出类似 10.x.x
```

2.2 安装 Git

Git 用于版本管理，某些 OpenClaw 功能或插件可能会依赖它。

下载： 访问 Git 官网，下载 Windows 版本。
安装：
- 双击运行安装程序。
- 在 Select Destination Location 步骤，将安装路径修改为 D:\software\git。
- 推荐勾选以下选项：
  - Git Bash Here
  - Git GUI Here
  - Use Git from the Command Line
- 其他选项保持默认，一路点击 "Next" 完成安装。
验证：

打开命令提示符或 PowerShell，输入：

powershell
复制代码
```
git --version
# 应输出类似 git version 2.x.x
```

3. 安装与配置 OpenClaw

3.1 安装 OpenClaw CLI

OpenClaw 提供了一个全局的命令行工具 openclaw。

安装：

以管理员身份打开命令提示符或 PowerShell，执行以下命令：

powershell
复制代码
```
npm install -g openclaw
```

验证安装：

powershell

复制代码

openclaw --version
# 应显示当前安装的版本号

3.2 配置 MiniMax API Key（必需）

OpenClaw 的 AI Agent 功能需要调用 MiniMax 的大模型 API，因此必须配置 API Key。

获取 API Key：
- 访问 MiniMax 开放平台并注册/登录。
- 进入 开发者中心 -> API Key 管理。
- 点击 创建新的 API Key ，并立即复制 生成的 Key（格式如 sk-xxxxxxxxxxxxxxxx）。注意：关闭窗口后将无法再次查看。
在 OpenClaw 中配置：
- 启动 OpenClaw Gateway（见4.1节）。
- 在浏览器中打开控制台（http://localhost:8080）。
- 找到 Agent 设置 或 Secrets（密钥）管理 页面。
- 添加以下配置项：
配置项 (Key) 值 (Value) 说明

MINIMAX_API_KEY sk-xxxxxxxxxxxxxxxx 粘贴你从 MiniMax 复制的 API Key

MINIMAX_API_HOST https://api.minimax.chat/v1 (通常使用默认值即可)
验证配置：

在命令行中运行诊断工具：

powershell
复制代码
```
openclaw doctor
```
检查输出中是否有与 MiniMax 相关的成功信息。

配置项 (Key)	值 (Value)	说明
`MINIMAX_API_KEY`	`sk-xxxxxxxxxxxxxxxx`	粘贴你从 MiniMax 复制的 API Key
`MINIMAX_API_HOST`	`https://api.minimax.chat/v1`	(通常使用默认值即可)

3.3 配置环境依赖（.NET SDK）

OpenClaw 的某些 Skill（如执行本地代码、与系统交互）需要 .NET SDK 的支持。

自动安装（推荐）：
- 在 OpenClaw Gateway 网页控制台中，找到并运行名为 openclaw-install 的 Skill。该 Skill 会自动检测并引导你安装 .NET SDK。
手动安装（备选）：
- 访问 .NET 下载官网，下载并安装 .NET 9.0 SDK 或更高版本。
- 安装后，在命令行中验证：
powershell
复制代码
```
dotnet --version
# 应输出类似 9.0.x
```

4. 启动与使用 OpenClaw

4.1 启动 Gateway 网页控制台

Gateway 是 OpenClaw 的图形化管理界面，所有的任务创建、Agent 管理都在这里进行。

启动服务：

在命令行中输入以下命令：

powershell
复制代码
```
openclaw gateway
```
访问控制台：

打开浏览器，访问 http://localhost:8080。如果服务启动成功，你将看到 OpenClaw 的管理界面。

你可以在此页面管理 Agents、配置定时任务、查看执行日志。

4.2 配置邮件通知功能（可选）

当任务执行完成或失败时，OpenClaw 可以通过邮件发送通知。你需要配置一个发件邮箱的 SMTP 信息。

获取邮箱授权码（以 QQ 邮箱为例）：
- 登录 QQ 邮箱网页版。
- 进入设置 -> 账户。
- 找到 POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务 区域。
- 开启 SMTP 服务 ，根据指引生成授权码 （一个16位字符串）。请保存好这个授权码，它不同于你的邮箱登录密码。

在 OpenClaw 中配置：

在 Gateway 控制台的 Secrets（密钥）管理 页面，添加以下配置：

配置项 (Key)	值 (Value)	说明
`EMAIL_USER`	`your_email@qq.com`	你的发件邮箱地址
`EMAIL_PASS`	`你的16位授权码`	刚刚获取的授权码，而非密码
`EMAIL_HOST`	`smtp.qq.com`	SMTP 服务器地址 (QQ邮箱)
`EMAIL_PORT`	`587`	端口 (推荐TLS) 或 `465` (SSL)

4.3 创建你的第一个定时任务

现在，我们来创建一个每周一早上9点运行的任务，例如收集新闻并发送邮件。

在 Gateway 控制台，进入 任务管理 页面，点击 新建任务。

填写任务配置：

任务名称： 每周军事新闻摘要
执行周期： 使用 Cron 表达式，例如 0 9 * * 1 (代表每周一 09:00)。
执行脚本： 在代码编辑器中编写你的任务逻辑。可以参考下方示例：

javascript

复制代码

// 示例脚本：collectAndSendNews.js
async function main() {
    console.log('开始收集新闻...');
    // 1. 假设有一个 fetchNews 函数可以获取新闻
    // const newsItems = await fetchNews({ keywords: ['军事', '国防'], days: 7 });

    // 2. 生成摘要
    // const summary = generateSummary(newsItems);

    // 3. 发送邮件
    // await sendEmail({
    //     to: 'your_email@qq.com',
    //     subject: '本周军事新闻摘要',
    //     html: `<p>${summary}</p>`
    // });
    console.log('任务执行完毕。');
}

main();

保存任务。到了设定时间，OpenClaw 将自动执行该脚本。

5. 进阶配置

5.1 设置开机自启动

为了让 OpenClaw Gateway 在电脑开机后自动运行，可以使用 Windows 的任务计划程序。

按 Win + R 键，输入 taskschd.msc 并回车，打开 任务计划程序。
在右侧操作栏中，点击 创建基本任务...。
名称： 输入 OpenClaw Gateway AutoStart。
触发器： 选择 计算机启动时。
操作： 选择 启动程序。
- 程序或脚本： 输入 powershell.exe
- 添加参数（可选）： 输入 -Command "openclaw gateway"
完成： 勾选 当单击"完成"时，打开此任务属性的对话框，然后点击完成。
在弹出的属性对话框中：
- 勾选 使用最高权限运行。
- 在条件选项卡中，取消勾选 只有在计算机使用交流电源时才启动此任务（如果是台式机或希望一直运行）。
点击确定。重启电脑后，OpenClaw Gateway 将自动启动。

6. 常见问题与解决

Q1: 安装 OpenClaw 时提示 `EACCES: permission denied`

原因： 权限不足。
解决： 以管理员身份运行命令提示符或 PowerShell，再执行安装命令。

Q2: 启动 Gateway 时提示 `Error: listen EADDRINUSE: address already in use :::8080`

原因： 8080 端口已被其他程序占用。
解决：
1. 找出占用端口的进程 PID：
  
  powershell
  复制代码
```
netstat -ano | findstr :8080
```
  最后一列数字即为 PID。
2. 结束该进程：
  
  powershell
  复制代码
```
taskkill /PID <你的PID> /F
```
3. 重新启动 Gateway：openclaw gateway

Q3: 邮件发送失败

检查项：
1. 确认 EMAIL_PASS 使用的是 授权码，而不是邮箱登录密码。
2. 确认在邮箱设置中已开启 SMTP 服务。
3. 确认 EMAIL_HOST 和 EMAIL_PORT 填写正确 (QQ邮箱为 smtp.qq.com 和 587)。
4. 检查网络是否能连接到 SMTP 服务器。

Q4: 定时任务到点没有执行

检查项：
1. 确认 openclaw gateway 进程是否在运行。
2. 在 Gateway 控制台的任务管理页面，检查任务状态是否为"启用"。
3. 查看该任务的 执行日志，排查是否有代码错误。

Q5: 如何更新 OpenClaw 到最新版？

解决： 以管理员身份运行命令行，执行：

powershell
复制代码
```
npm update -g openclaw
```

7. 快速参考

命令	描述
`openclaw --version`	查看 OpenClaw 版本
`openclaw gateway`	启动 Gateway 网页控制台
`openclaw task list`	在命令行查看所有任务
`openclaw task run <任务名>`	在命令行手动触发一个任务
`openclaw doctor`	运行环境诊断，检查配置是否正确
`npm update -g openclaw`	更新 OpenClaw 到最新版本

文档版本: 2.0 | 最后更新: 2026年3月

本回答由 AI 生成，内容仅供参考，请仔细甄别。