简介
本文面向希望在 Windows 本地（PowerShell）部署 OpenClaw，使用兼容 OpenAI 协议的 MaaS 平台作为大模型，并通过飞书长连接模式实现 AI 机器人的用户。内容涵盖从零开始安装配置、对接飞书机器人、验证与排错的完整流程，适合个人开发者或小团队搭建自己的'数字员工'。建议按顺序操作，遇到报错先对照文末提示处理。
OpenClaw 是什么？
OpenClaw 是一个开源的个人 AI 智能体平台，核心定位是'能真正干活的 AI 助手'，而不是简单的聊天机器人。它运行在你的本地电脑或服务器上，通过 WhatsApp、Telegram、Discord、飞书、钉钉等聊天工具接收指令，可以直接操作文件系统、运行命令、控制浏览器、设置定时任务等。
可以把它理解成：
- 一个'AI 管家'或'数字员工'，有长期记忆、能记住你的偏好和历史对话；
- 一个多渠道网关，让同一个 AI 大脑同时服务飞书、钉钉、Telegram、WhatsApp 等多个平台；
- 一个编排框架，本身不自带模型推理能力，需要连接外部大模型（如阿里云百炼、通义千问、Claude、GPT 等）。
典型应用场景包括办公自动化、本地文件管理、浏览器自动化以及多平台客服运营助手。
模型服务配置
本教程以通用 MaaS 平台为例，如果你后续希望切换其他模型服务商，只需在 OpenClaw 中修改模型配置（API 地址、模型名、API Key）即可。
MaaS 平台的核心特点：
- 模型即服务：DeepSeek-V3.x、Qwen 系列等多模态、文本模型统一通过 API 暴露，无需自己训练或部署推理引擎；
- 低门槛体验：新用户注册可获得大量免费 Token 额度，适合个人开发者和小项目；
- 兼容 OpenAI 协议：只需将
base_url指向平台的网关，即可无缝接入各类兼容 OpenAI 的应用。
简单理解：
- OpenClaw = '指挥中心 + 执行层'（多渠道、记忆、工具调用）
- MaaS 平台 = '算力 + 模型层'（提供大模型推理服务）
步骤一：极速安装，一行命令搞定环境
打开 PowerShell，执行以下命令一键安装：
iwr -useb https://clawd.org.cn/install.ps1 | iex
步骤二：启动向导，初始化配置参数
重新打开一个 CMD，输入命令启动配置向导：
openclaw-cn onboard
向导启动后，选择继续（YES）。
步骤三：注入灵魂，获取 API Key
访问 MaaS 平台控制台，登录账号。进入左侧菜单「密钥管理」→「创建 API Key」。创建完成后复制 Key（通常以 sk- 或 bk- 开头）。返回 onboard 向导，在对应位置粘贴 Key 并继续。
步骤四：打通渠道，搭建飞书长连接桥梁
在 onboard 向导中，选择配置 Feishu 渠道。
- 访问飞书开放平台，创建企业自建应用 → 选择机器人类型 → 填写基本信息 → 创建。
- 在权限管理中清空原有权限，粘贴以下内容：
{ "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 部署完成后统一在飞书后台设置，避免向导卡住。
- 在指定位置输入刚才复制的机器人 App ID 和 App Secret，继续下一步直到向导完成。
步骤五：引擎点火，启动核心网关服务
配置完成后，启动 OpenClaw 的网关：
openclaw-cn gateway
步骤六：仪表盘检阅，后台状态可视化
- 浏览器打开命令中提示的网址。
- 登录 OpenClaw 管理后台。
- 检查事件订阅是否为长连接模式。
- 确认已添加的事件列表完整。
步骤七：实战演练，验证智能交互效果
发送消息给机器人（如 @机器人 你好）。如果机器人正常回复，则部署成功！
快速排错提示
- onboard 卡住或报错 → 检查网络，重新运行 openclaw-cn onboard。
- gateway 启动失败 → 检查端口 18789 是否被占用，可加参数 --port 其他端口。
- 飞书不回复 → 确认选了'长连接'、事件已订阅、App ID/Secret/Key 无误。
- 模型无响应 → 确认 MaaS 平台 API Key 有效、配额充足。
结语
到这里，你已经完成了一套'本地部署 + MaaS 模型 + 飞书长连接机器人'的完整搭建。这套环境可以作为你后续各种 AI 自动化实验的基础：
- 可以继续给机器人添加技能（技能插件），扩展文件处理、浏览器自动化等能力；
- 可以尝试接入其他模型服务商，对比不同模型的效果和成本；
- 也可以把这套机器人接入更多业务场景，比如自动客服、内部知识助手、运营日报等。
如果在实际操作中遇到问题，建议优先回头检查每一步的配置（App ID / App Secret / API Key / 事件订阅），查看 OpenClaw 官方文档和社区教程，更新到最新版本，并在飞书开放平台中确认事件订阅是否正常、是否有报错日志。祝你玩得顺手，把 OpenClaw 打造成真正属于你的'数字员工'。