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

Windows 本地部署 OpenClaw 对接飞书机器人实战

Windows 本地通过 PowerShell 一键安装 OpenClaw 智能体框架,配置通用 MaaS 模型接口及飞书长连接权限,实现 AI 数字员工的自动化交互与任务执行,包含环境搭建、参数初始化、服务启动及常见问题排查全流程。

嘘发布于 2026/3/24更新于 2026/7/2135 浏览
Windows 本地部署 OpenClaw 对接飞书机器人实战

Windows 本地部署 OpenClaw 对接飞书机器人实战

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

可以把它理解成:

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

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

环境准备与安装

本教程基于 Windows 系统,使用 PowerShell 进行部署。

打开 PowerShell,执行以下命令一键安装:

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

安装完成后,重新打开一个 CMD 窗口,输入命令启动配置向导:

openclaw-cn onboard

向导启动后,按提示选择继续(YES)即可进入初始化流程。

接入大模型服务

OpenClaw 作为智能体编排框架,需要连接外部大模型提供推理能力。这里以接入兼容 OpenAI 协议的 MaaS 服务为例。

访问 MaaS 平台控制台,登录账号后进入「密钥管理」创建 API Key。通常 Key 以 sk- 或 bk- 开头。

返回 onboard 向导,在对应位置粘贴 Key 并继续。这一步相当于为机器人注入'大脑'。

注意:确保 API 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 部署完成后统一在飞书后台设置,避免向导卡住。

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

启动网关与服务

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

openclaw-cn gateway

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

验证与排错

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

如果在实际操作中遇到问题,建议优先排查以下几点:

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

到这里,你已经完成了一套'本地部署 + 大模型服务 + 飞书长连接机器人'的完整搭建。这套环境可以作为后续各种 AI 自动化实验的基础,可以继续给机器人添加技能插件,扩展文件处理、浏览器自动化等能力,也可以尝试接入更多业务场景,比如自动客服、内部知识助手、运营日报等。

祝部署顺利,把 OpenClaw 打造成真正属于你的'数字员工'。

目录

  1. Windows 本地部署 OpenClaw 对接飞书机器人实战
  2. 环境准备与安装
  3. 接入大模型服务
  4. 配置飞书长连接
  5. 启动网关与服务
  6. 验证与排错
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • 基于Coze平台的AI客服机器人搭建实战指南
  • OpenClaw 开源机器人实现空间智能体记忆技术解析
  • 基于 Flask 和 Vue.js 的实验室设备租赁报修预约系统
  • Python 绘图基础:matplotlib 库常用功能详解
  • 降低 AIGC 疑似度:7 个实用技巧与专业工具案例
  • FAIR plus 机器人全产业链接会与 2026 展会前瞻
  • Lostlife2.0 实战:基于 Llama-Factory 重塑 NPC 对话逻辑
  • 微调大型语言模型:定制 Llama 3 8B 应用
  • 基于 Electron 的跨平台桌面应用开发实战
  • C++ 从零实现 Json-Rpc 框架:服务端模块划分
  • Diffusion Transformer (DiT):架构演进、视频生成应用与机器人动作预测详解
  • 大疆 RTK 无人机免像控与有像控精度实测对比
  • 数据结构初阶:二叉树链式存储实现
  • AI 大模型掌握与运用技巧:提示词工程与业务接入实践
  • 解决 VS Code Copilot 提示 Chat took too long to get ready 问题
  • Uptime Kuma 结合 cpolar 实现远程运维监控
  • RAG 提升大语言模型能力的三大关键技术
  • 从零开始学编程:五种最适合新手的入门语言
  • 使用闲置 Mac Mini 部署 OpenClaw 打造金融 AI 助手
  • Elasticsearch 中指定数组字段的统计查询记录

相关免费在线工具

  • 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