跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PowerShellAI

Windows 本地部署 OpenClaw 对接飞书机器人指南

介绍如何在 Windows 本地通过 PowerShell 一键部署 OpenClaw 开源 AI 智能体平台,并配置飞书长连接机器人。内容涵盖环境安装、模型 API 接入、飞书应用权限设置及网关启动流程,提供常见问题排查指引,帮助用户快速搭建本地 AI 数字员工。

独立开发者发布于 2026/4/6更新于 2026/7/2567 浏览
Windows 本地部署 OpenClaw 对接飞书机器人指南

简介

本文面向想在 Windows 本地使用 PowerShell 一键部署 OpenClaw,通过飞书长连接模式实现 AI 机器人的用户。 内容涵盖从零开始安装配置、对接飞书机器人、验证与排错的完整流程,适合个人开发者或小团队搭建自己的数字员工。 建议阅读方式:

  • 按顺序一步步操作,不要跳过首次配置向导。
  • 遇到报错时,先对照文末快速排错提示处理,再继续后续步骤。

OpenClaw 是什么?

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

  • 一个 AI 管家或数字员工,有长期记忆、能记住你的偏好和历史对话;
  • 一个多渠道网关,让同一个 AI 大脑同时服务飞书、钉钉、Telegram、WhatsApp 等多个平台;
  • 一个编排框架,本身不自带模型推理能力,需要连接外部大模型(如阿里云百炼、Claude、GPT 等)。 典型应用场景包括:
  • 办公自动化:整理邮件、同步日程、处理文档;
  • 本地文件管理:归类资料、批量处理文件;
  • 浏览器自动化:打开网页、抓取数据、填写表单;
  • 多平台客服 / 运营助手:通过飞书、钉钉等统一接待用户。

步骤一:极速安装环境

  1. 打开 PowerShell。
  2. 执行以下命令一键安装:
iwr -useb https://clawd.org.cn/install.ps1 | iex

步骤二:初始化配置参数

  1. 重新打开一个 CMD。
  2. 输入命令启动配置向导:
openclaw-cn onboard
  1. 向导启动后选择继续(YES)。

步骤三:配置大模型 API Key

  • 访问您的大模型服务商控制台,登录账号。
  • 进入左侧菜单密钥管理创建 API Key。
  • 创建完成后复制 Key(通常以 sk- 或 bk- 开头)。
  • 返回 onboard 向导,在对应位置粘贴 Key 并继续。

步骤四:搭建飞书长连接桥梁

  1. 在 onboard 向导中,选择配置 Feishu 渠道。
  2. 访问飞书开放平台,创建企业自建应用 → 选择机器人类型 → 填写基本信息 → 创建。
  3. 在权限管理中清空原有权限,粘贴以下内容:
{ "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"
]
}
}
  1. 在凭证与基础信息中复制 App ID 和 App Secret。
  2. 进入事件与回调:
    • 订阅方式选择长连接订阅方式(不可选 HTTP 回调)。
    • 添加事件:至少包含 im.message.receive_v1(接收消息)。
    • 保存设置。 注意:事件订阅和回调配置建议在 openclaw 部署完成后统一在飞书后台设置,避免向导卡住。
  3. 在指定位置输入刚才复制的机器人 App ID 和 App Secret,继续下一步直到向导完成。

步骤五:启动核心网关服务

配置完成后,启动 OpenClaw 的网关:

openclaw-cn gateway

步骤六:后台状态可视化

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

步骤七:验证智能交互效果

  • 发送消息给机器人(如 @机器人 你好)。
  • 如果机器人正常回复,则部署成功!

快速排错提示

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

结语

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

  • 可以继续给机器人添加技能插件,扩展文件处理、浏览器自动化等能力;
  • 可以尝试接入不同的大模型服务商,对比不同模型的效果和成本;
  • 也可以把这套机器人接入更多业务场景,比如自动客服、内部知识助手、运营日报等。 如果在实际操作中遇到问题,建议优先回头检查每一步的配置(App ID / App Secret / API Key / 事件订阅),查看官方文档和社区教程更新到最新版本,并在飞书开放平台中确认事件订阅是否正常、是否有报错日志。

目录

  1. 简介
  2. OpenClaw 是什么?
  3. 步骤一:极速安装环境
  4. 步骤二:初始化配置参数
  5. 步骤三:配置大模型 API Key
  6. 步骤四:搭建飞书长连接桥梁
  7. 步骤五:启动核心网关服务
  8. 步骤六:后台状态可视化
  9. 步骤七:验证智能交互效果
  10. 快速排错提示
  11. 结语
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 基于 GLM-4.7-Flash 构建本地 Copilot 工具
  • OpenClaw 汉化中文版部署指南:npm、Docker 安装与环境配置
  • 前后端分离架构深度解析:模式对比与选型指南
  • OpenClaw 智能体安装部署与 QQ 机器人接入指南
  • GitHub 之外:国内外主流代码托管平台推荐与选型
  • MinIO 开源版本部署实战:避开许可证陷阱
  • Xcode 真机调试报错:Developer Disk Image 无法卸载解决方案
  • Docker 快速部署 Nginx、Redis、MySQL、Tomcat 及制作镜像
  • 基于陀螺仪航向反馈的轮式机器人PID直线控制
  • Cursor 集成 MCP 服务:从环境搭建到实战应用
  • 基于 FPGA 的高速串行通信模块设计与验证
  • ESP32-CAM 实时监控方案:从局域网到外网部署
  • OpenSCA-cli 开源组件安全扫描与使用指南
  • GeoAI 快速上手:地理空间 AI 分析指南
  • Vue Print Designer 前端可视化打印设计器
  • Ubuntu 搭建前端环境及 Vue 实战
  • wechat-need-web 插件实现浏览器访问微信网页版方案
  • Linux 下 libwebkit2gtk-4.1-0 安装与使用指南
  • 网络安全学习方向与路线详解
  • Neo4j Desktop 2 安装与使用指南

相关免费在线工具

  • 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