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

Windows 本地一键部署 OpenClaw 对接飞书与模型服务

Windows 本地部署 OpenClaw 智能体平台,通过 PowerShell 脚本快速安装环境并初始化配置。支持接入飞书长连接机器人,实现多渠道指令接收与执行。配置兼容 OpenAI 协议的模型服务作为核心大脑,完成网关启动与后台状态监控。流程涵盖安装、向导配置、API Key 获取、权限设置及验证交互,适用于办公自动化、文件管理及多平台客服场景。提供常见报错排查指南,帮助开发者构建本地 AI 数字员工。

Ne0发布于 2026/3/26更新于 2026/7/2051 浏览
Windows 本地一键部署 OpenClaw 对接飞书与模型服务

OpenClaw 简介

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

可以把它理解成:

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

典型应用场景包括:

  • 办公自动化:整理邮件、同步日程、处理文档;
  • 本地文件管理:归类资料、批量处理文件;
  • 浏览器自动化:打开网页、抓取数据、填写表单;
  • 多平台客服 / 运营助手:通过飞书、钉钉等统一接待用户。

模型服务对接

OpenClaw 作为'智能体编排框架',本身不包含模型推理能力,需要连接外部大模型。支持兼容 OpenAI 协议的模型 API,只需将 base_url 指向服务商的网关,即可无缝接入各类兼容 OpenAI 的应用。

本教程以通用模型服务为例,如果你后续希望切换其他模型服务商,只需在 OpenClaw 中修改模型配置(API 地址、模型名、API Key)即可。

步骤一:极速安装,一行命令搞定环境

  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 渠道。
  • 访问飞书开放平台。
  • 创建企业自建应用 → 选择机器人类型 → 填写基本信息 → 创建。
  • 选择机器人,继续下一步。
  • 输入内容(自定义)。
  1. 在权限管理/批量导入/导出权限中清空原有权限,粘贴复制下方内容:
{
  "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"
]
}
}
  • 在「凭证与基础信息」中复制 App ID 和 App Secret。
  • 进入「事件与回调」:
    • 订阅方式选择 长连接订阅方式(不可选 HTTP 回调)。
    • 添加事件:至少包含 im.message.receive_v1(接收消息)。
    • 保存设置。

注意:事件订阅和回调配置建议在 openclaw 部署完成后统一在飞书后台设置,避免向导卡住。

  1. 在指定位置输入刚才复制的 机器人 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 自动化实验的基础:

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

如果在实际操作中遇到问题,建议优先:

  1. 回头检查每一步的配置(App ID / App Secret / API Key / 事件订阅);
  2. 查看 OpenClaw 官方文档和社区教程,更新到最新版本;
  3. 在飞书开放平台中确认事件订阅是否正常、是否有报错日志。

目录

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

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

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

更多推荐文章

查看全部
  • ChatGPT 结构化 Prompt 的高级应用技巧
  • PyPy 生成器优化深度解析:JIT 加速下的 Python 性能提升
  • 类加载器双亲委托机制详解
  • Neo4j 图谱可视化:节点与关系颜色定制方法
  • Java 高并发秒杀系统设计:架构、防超卖与性能优化
  • 知网 AIGC 检测不通过?三步降低 AI 率
  • 转行 Python 的几点建议
  • Python sqlite3 模块:轻量级数据库使用指南
  • RAG 检索增强生成技术入门与实战指南
  • Python 量化金融核心库与工具最全汇总
  • Dify 工作流发布为 MCP Server 实战指南
  • Java 爬虫实战:基于 HttpClient 的 GET 与 POST 请求实现
  • Stable Diffusion 对抗样本生成工具实战指南
  • VS Code 远程连接服务器后 GitHub Copilot 无法使用修复方案
  • 在 Mac 上安装 Java 和 IntelliJ IDEA
  • simplify-js:高性能多边形简化 JavaScript 算法库实用指南
  • Seata XA 模式:强一致性分布式事务的配置与权衡
  • Spring Boot 集成数据仓库与 ETL 工具实战
  • DeepSeek-R1-Distill-Llama-8B 数学解题应用实践
  • CentOS 搭建私人漫画库:Teemii + cpolar 公网访问

相关免费在线工具

  • 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