介绍
OpenClaw 是一个开源的 AI 代理平台，支持与各种大型语言模型 (LLM) 集成，并可连接到多个通信渠道，如 Telegram、Slack 和飞书 (Feishu)。本教程将一步步指导你在 Windows 系统上安装 OpenClaw，配置 Minimax 模型（需要 Minimax API 密钥），并集成飞书作为通信渠道。
注意事项：
- 本教程假设你有基本的命令行操作经验。如果你是初学者，请仔细跟随每一步。
- OpenClaw 在 Windows 上可直接安装，但推荐使用 WSL2 (Windows Subsystem for Linux) 以获得更好性能。如果你使用 WSL2，请先启用它。
- 你需要一个 Minimax 账户来获取 API 密钥（免费注册，但模型使用可能有费用）。
- 对于飞书集成，你需要一个飞书账户，并创建应用（App）。
- 所有命令在 PowerShell 或命令提示符中运行。除非指定，否则使用 PowerShell。
先决条件
- 操作系统：Windows 10/11 (64-bit)。
- 安装 Node.js：
- 下载并安装 Node.js v22 或更高版本。从 官方网站 下载 LTS 版本。
- 安装后，打开 PowerShell，运行 node -v 验证（应显示 v22.x.x 或更高）。
- 安装 Git（可选，但推荐用于插件安装）：
- 从 Git 官网 下载并安装。
- Minimax API 密钥：
- 注册 Minimax 平台（或类似，具体取决于 2026 年网址）。
- 在仪表盘生成 API 密钥，复制备用。
- 飞书应用：
- 登录 飞书开放平台。
- 创建一个新应用，获取 App ID 和 App Secret。
- 在应用中启用机器人（Bot）功能，并配置事件订阅（包括消息接收事件）。
- 启用 WSL2（可选，但推荐）：
- 在 PowerShell（以管理员身份运行）执行：wsl --install。
- 重启电脑，安装 Ubuntu（默认）。
- 在 WSL 中运行命令时，使用 Ubuntu 终端。
步骤 1: 安装 OpenClaw
OpenClaw 提供一键安装脚本。直接在 Windows 上安装，或在 WSL2 中安装。
Option A: 直接在 Windows 上安装（推荐初学者）
- 打开 PowerShell（搜索 "PowerShell"，以管理员身份运行）。
- 运行安装命令：
iwr -useb https://openclaw.ai/install.ps1 | iex
- 脚本会检测 Node.js，如果缺失会提示安装。
- 安装完成后，会启动 onboarding 向导（互动配置）。
- 同意风险声明（输入 "Yes"）。
- 选择 "QuickStart" 模式（快速启动）。
- 跟随提示设置基本配置（稍后我们会修改模型和渠道）。
安装后，OpenClaw CLI 可用。运行 openclaw --version 验证。
Option B: 在 WSL2 中安装（更好性能）
- 打开 WSL2 终端（搜索 "Ubuntu"）。
- 运行安装命令：
curl -fsSL https://openclaw.ai/install.sh | bash
- 跟随 onboarding 向导，如上。
安装后测试：运行 openclaw status 检查是否运行。
步骤 2: 配置 Minimax 模型
Minimax 是高性能模型，需要 API 密钥。OpenClaw 支持 Minimax M2.5 等模型。
- 打开终端（PowerShell 或 WSL）。
- 运行配置命令：
openclaw configure
- 在互动向导中：
- 选择 "Model/auth"（模型/认证）。
- 选择 "MiniMax M2.5"（或类似版本，根据提示）。
- 输入你的 Minimax API 密钥（从 Minimax 仪表盘复制）。
- 选择默认模型（e.g., "minimax-m2.5"）。
- 设置上下文窗口（推荐 196608）和最大令牌（8192）。
- 保存配置（选择 "Finished"）。
手动编辑配置（可选）：
- 配置文件位于
~/.openclaw/openclaw.json（WSL）或 %USERPROFILE%\.openclaw\openclaw.json（Windows）。
- 添加/修改：
"models": {
"providers": {
"minimax": {
"apiKey": "你的_MINIMAX_API_KEY",
"models": [
{
"id": "minimax-m2.5",
"name": "MiniMax M2.5",
"contextWindow": 196608,
"maxTokens": 8192
}
]
}
}
}
- 重启 OpenClaw：
openclaw restart
测试模型：运行 openclaw test-model 或在后续渠道中测试。
步骤 3: 配置飞书集成
飞书 (Feishu) 是企业通信平台。OpenClaw 通过插件支持飞书，需要安装插件并配置应用凭证。
子步骤 3.1: 创建飞书应用
- 登录 飞书开放平台。
- 点击 "创建应用" > "企业自建应用"。
- 填写应用名称（e.g., "OpenClaw Bot"）。
- 在 "凭证与基础信息" 中获取 App ID 和 App Secret。
- 在 "机器人" tab 启用机器人。
- 在 "事件订阅" tab：
- 添加事件：im.message.receive_v1（接收消息）。
- 设置验证 URL（稍后配置，暂留空）。
- 保存并发布版本。
- 在飞书客户端中，将机器人添加到群组或个人聊天。
子步骤 3.2: 安装飞书插件
- 在终端运行：
openclaw plugins install feishu-openclaw
（如果插件名为 @openclaw/feishu 或类似，根据最新版本调整；从 npm 检查。）
子步骤 3.3: 配置飞书渠道
- 运行配置命令：
openclaw configure --section channels
- 在向导中：
- 选择 "feishu"（或 Lark，如果国际版）。
- 设置 "enabled": true。
- 输入 App ID: "cli_你的AppID"。
- 输入 App Secret: "你的AppSecret"。
- （可选）设置域名或其他选项（如多账户支持）。
- 保存配置。
手动编辑配置：
"channels": {
"feishu": {
"enabled": true,
"appId": "cli_你的AppID",
"appSecret": "你的AppSecret",
"domain": "feishu.cn" // 或 larksuite.com 如果国际版
}
}
- 重启网关：
openclaw gateway restart
- 返回飞书开放平台，设置事件订阅 URL 为 OpenClaw 提供的 webhook（通常在配置后显示，或检查日志）。
步骤 4: 启动和测试
- 启动 OpenClaw：
openclaw start
（或作为服务运行：openclaw onboard --install-daemon。）
- 测试 Minimax：
- 运行 openclaw chat（CLI 聊天），输入问题，检查响应。
- 测试飞书：
- 在飞书客户端向机器人发送消息（e.g., "Hello"）。
- 机器人应使用 Minimax 模型回复。
- 如果群聊，提及机器人（@BotName）。
- 检查日志：
openclaw logs
查找错误。
故障排除
- 安装失败：检查 Node.js 版本，确保 PowerShell 执行策略为 Unrestricted（运行
Set-ExecutionPolicy Unrestricted）。
- 模型未响应：验证 API 密钥有效，检查网络（Minimax 是云模型）。
- 飞书无响应：确保事件订阅正确配置，检查 webhook URL 是否可达。重启飞书应用版本。
- 插件未找到：更新 OpenClaw
npm update -g openclaw，或手动安装插件 npm install -g feishu-openclaw。
- 性能问题：如果慢，切换到本地模型（如通过 Ollama 集成），或使用 WSL2。
- 更多帮助：查看官方文档 docs.openclaw.ai，或 GitHub issues。
结语
恭喜！你现在有了一个在 Windows 上运行的 OpenClaw，集成 Minimax 模型，并连接到飞书。可以通过飞书与 AI 交互，用于工作流自动化等。如果需要高级配置，如多模型切换或技能添加，请参考官方文档。