Windows 本地部署 OpenClaw 实现飞书 AI 数字员工

本指南面向希望在 Windows 环境下通过 PowerShell 一键部署 OpenClaw，并对接第三方 MaaS 平台与飞书长连接模式的用户。内容涵盖从零开始的环境安装、配置向导、渠道打通及验证排错流程，适合个人开发者或小团队搭建自己的'数字员工'。

OpenClaw 是什么？

OpenClaw（原名 Clawdbot / Moltbot）是一个开源的个人 AI 智能体平台，核心定位是'能真正干活的 AI 助手'，而非简单的聊天机器人。它运行在你的本地电脑或服务器上，通过 WhatsApp、Telegram、Discord、飞书、钉钉等聊天工具接收指令，可以直接操作文件系统、运行命令、控制浏览器、设置定时任务等。

可以把它理解成：

一个'AI 管家'或'数字员工'，有长期记忆，能记住你的偏好和历史对话；
一个多渠道网关，让同一个 AI 大脑同时服务飞书、钉钉、Telegram、WhatsApp 等多个平台；
一个编排框架，本身不自带模型推理能力，需要连接外部大模型（如阿里云百炼、通义千问、Claude、GPT 等）。

典型应用场景包括办公自动化、本地文件管理、浏览器自动化以及多平台客服运营助手。

环境准备与安装

1. 极速安装

打开 PowerShell，执行以下命令一键安装依赖环境：

iwr -useb https://clawd.org.cn/install.ps1 | iex

2. 启动向导

重新打开一个 CMD 窗口，输入命令启动配置向导：

openclaw-cn onboard

向导启动后，按提示选择继续（YES）。

接入大模型服务

OpenClaw 作为智能体编排框架，需要连接外部大模型提供推理能力。你需要获取一个兼容 OpenAI 协议的 MaaS 平台 API Key。

访问你选择的 MaaS 平台控制台，登录账号。
进入左侧菜单「密钥管理」→「创建 API Key」。
创建完成后复制 Key（通常以 sk- 或 bk- 开头）。
返回 onboard 向导，在对应位置粘贴 Key 并继续。

注意：确保 API Key 有效且配额充足，否则模型可能无响应。

搭建飞书长连接桥梁

1. 创建应用

在 onboard 向导中，选择配置 Feishu 渠道。访问飞书开放平台，创建企业自建应用，选择机器人类型，填写基本信息后创建。

2. 权限配置

在权限管理/批量导入/导出权限中清空原有权限，粘贴以下内容：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application.self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "contact:contact.base:readonly",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

3. 回调配置

在「凭证与基础信息」中复制 App ID 和 App Secret。进入「事件与回调」：

订阅方式选择长连接订阅方式（不可选 HTTP 回调）。
添加事件：至少包含 im.message.receive_v1（接收消息）。
保存设置。

提示：事件订阅和回调配置建议在 OpenClaw 部署完成后统一在飞书后台设置，避免向导卡住。

4. 完成配置

在指定位置输入刚才复制的机器人 App ID 和 App Secret，继续下一步直到向导完成。

启动与服务验证

1. 启动网关

配置完成后，启动 OpenClaw 的网关服务：

openclaw-cn gateway

2. 仪表盘检阅

浏览器打开命令中提示的网址，登录 OpenClaw 管理后台。检查事件订阅是否为长连接模式，确认已添加的事件列表完整。

3. 实战演练

发送消息给机器人（如 @机器人你好）。如果机器人正常回复，则部署成功！

快速排错提示

onboard 卡住或报错：检查网络，重新运行 openclaw-cn onboard。
gateway 启动失败：检查端口 18789 是否被占用，可加参数 --port 指定其他端口。
飞书不回复：确认选了'长连接'、事件已订阅、App ID/Secret/Key 无误。
模型无响应：确认 MaaS 平台 API Key 有效、配额充足。

后续扩展

到这里，你已经完成了一套'本地部署 + MaaS 模型 + 飞书长连接机器人'的完整搭建。这套环境可以作为你后续各种 AI 自动化实验的基础：

可以继续给机器人添加技能插件，扩展文件处理、浏览器自动化等能力；
可以尝试接入不同的大模型服务商，对比效果；
也可以把这套机器人接入更多业务场景，比如自动客服、内部知识助手、运营日报等。

如果在实际操作中遇到问题，建议优先回头检查每一步的配置，查看官方文档更新到最新版本，并在飞书开放平台中确认事件订阅是否正常、是否有报错日志。祝你玩得顺手，把 OpenClaw 打造成真正属于你的'数字员工'。