跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PowerShellSaaSAI

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

Windows 本地部署 OpenClaw 结合飞书长连接与 MaaS 大模型服务的完整流程。通过 PowerShell 一键安装环境,使用 onboard 向导初始化配置,获取第三方 MaaS 平台 API Key 注入模型能力,并在飞书开放平台配置自建应用与长连接订阅。最终启动网关服务,通过管理后台验证状态,发送消息测试交互效果。常见问题包括网络卡顿、端口占用及权限配置错误,排查后可实现稳定的 AI 数字员工运行。

beaabea发布于 2026/3/30更新于 2026/10/25111 浏览
Windows 本地部署 OpenClaw 实现飞书 AI 数字员工

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。

  1. 访问你选择的 MaaS 平台控制台,登录账号。
  2. 进入左侧菜单「密钥管理」→「创建 API Key」。
  3. 创建完成后复制 Key(通常以 sk- 或 bk- 开头)。
  4. 返回 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 打造成真正属于你的'数字员工'。

目录

  1. Windows 本地部署 OpenClaw 实现飞书 AI 数字员工
  2. OpenClaw 是什么?
  3. 环境准备与安装
  4. 1. 极速安装
  5. 2. 启动向导
  6. 接入大模型服务
  7. 搭建飞书长连接桥梁
  8. 1. 创建应用
  9. 2. 权限配置
  10. 3. 回调配置
  11. 4. 完成配置
  12. 启动与服务验证
  13. 1. 启动网关
  14. 2. 仪表盘检阅
  15. 3. 实战演练
  16. 快速排错提示
  17. 后续扩展

更多推荐文章

查看全部
  • 秋叶绘世 Stable Diffusion 整合包功能说明
  • Python 与 Wind 量化接口实战:环境配置与连接流程
  • GitHub Token 配置与安全使用指南
  • 从 3D 打印到步态学习:宇树 Qmini 双足机器人开源实战
  • 基于 Higress 将 REST API 转换为 MCP Server 实战指南
  • Llama3 中文通用 Agent 微调模型实战教程
  • Linux 定时更新 Git 仓库脚本方案
  • Python 学习路线与方法总结
  • 圣光艺苑:基于 Stable Diffusion 的鎏金画框艺术生成工具
  • AI 实体识别服务 WebUI 交互设计与体验优化
  • 2024 AI 图像生成项目精选
  • Copilot 智能体配置与高级用法实战指南
  • 向量数据库与 RAG 应用架构解析(上)
  • 人工智能大模型在医疗领域的应用进展与前景
  • Redis 与 Memcached 核心区别及性能分析
  • AI 时代为何仍需深入学习 SpringBoot
  • Go 语言中 unsafe.Pointer、uintptr 与指针的关系解析
  • 前端 WebSocket 实战指南:告别轮询,拥抱实时通信
  • Python 属性描述符:原理与 ORM 实战
  • Llama-3.2V-11B-COT 教育场景解题推理辅助应用实战

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online