Windows搭建 OpenClaw AI 助手教程 – 支持接入飞书/Telegram

前言

OpenClaw 是一个强大的 AI 助手框架，支持多种通讯渠道接入，包括飞书、Telegram、Discord 等。本教程将详细介绍如何在 Windows 服务器上搭建 OpenClaw，并配置飞书机器人。

环境要求

• Windows 10/11 或 Windows Server 2016+
• Node.js 22 或更高版本
• 管理员权限

第一步：安装 Node.js

首先，我们需要安装 Node.js 环境。

1. 访问 Node.js 官网下载 LTS 版本：https://nodejs.org/
2. 下载完成后，双击安装包进行安装
3. 建议使用默认设置，直接点击 Next 完成安装
4. 安装完成后，打开 PowerShell 终端，输入以下命令验证安装：

node --version

如果显示版本号（如 v22.x.x），则说明安装成功。

第二步：安装 OpenClaw

打开 PowerShell 终端（以管理员身份运行），执行以下命令：

iwr -useb https://openclaw.ai/install.ps1 | iex

安装过程会自动完成。安装完成后，可以验证是否成功：

openclaw --version

第三步：初始化配置

运行初始化向导：

openclaw onboard --install-daemon

向导会引导你完成：

• 选择 AI 模型提供商（如 MiniMax）
• 配置网关设置
• 添加通讯渠道（飞书/Telegram）

第四步：配置飞书机器人

4.1 创建飞书应用

1. 访问飞书开放平台：https://open.feishu.cn/app
2. 点击「创建企业应用」，填写应用名称和描述
3. 在「凭证与基础信息」中获取 App ID 和 App Secret

4.2 配置应用权限

在「权限管理」中，批量导入以下权限：

{
  "scopes": {
    "tenant": [
      "im:message",
      "im:message:send_as_bot",
      "im:message:readonly",
      "im:chat.members:bot_access"
    ],
    "user": ["im:message"]
  }
}

4.3 启用机器人能力

在「应用能力」-「机器人」中：

1. 启用机器人能力
2. 设置机器人名称

4.4 配置事件订阅

1. 在「事件订阅」中，选择「使用长连接接收事件」
2. 添加事件：im.message.receive_v1
3. 发布应用版本并提交审核

4.5 在 OpenClaw 中配置飞书

编辑配置文件 C:\Users\Administrator\.openclaw\openclaw.json：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "open",
      "accounts": {
        "main": {
          "appId": "你的App ID",
          "appSecret": "你的App Secret"
        }
      }
    }
  }
}

第五步：启动服务

# 启动网关
openclaw gateway start

# 查看状态
openclaw status

常用命令

常见问题

Q1: 飞书机器人无法接收消息？

A: 检查应用是否已发布，并确认事件订阅中的 im.message.receive_v1 事件已添加。

Q2: 如何更新 OpenClaw？

A: 运行 npm update -g openclaw 即可更新到最新版本。

Q3: 如何修改 AI 模型？

A: 在初始化向导中可以重新选择模型，或直接编辑配置文件。

结语

通过以上步骤，你已经在 Windows 服务器上成功搭建了 OpenClaw AI 助手，并配置好了飞书机器人。现在你可以直接在飞书中与 AI 助手对话了！

如有问题，欢迎在评论区留言交流。