作为AI从业者，实测跑通的MoltBot（OpenClaw对应真实开源项目）全流程，无虚构命令、无假地址，每一步都能复现，新手也能跟着搞定，对接飞书实现智能自动回复。 先明确：MoltBot = OpenClaw（真实项目）
先给你彻底厘清，避免被名字搞混——网上说的OpenClaw，其实就是MoltBot的曾用名（早期叫ClawdBot，后更名MoltBot，部分人仍习惯叫OpenClaw）。它是真实的开源本地AI智能体框架，社区维护，能部署在本地/服务器，对接大模型，还能接入飞书等办公工具，实现消息自动处理、文档操作等自动化功能。重点：它有真实的GitHub仓库，有可运行的代码、真实的命令，不是虚构项目，这也是这篇教程能100%跑通的核心前提。
部署前必看：环境要求（亲测可用，无兼容坑）
MoltBot基于Node.js开发，核心依赖就3个：Node.js、Git、大模型API Key，先把这些准备好，避免部署到一半卡壳。
1. 系统要求（实测兼容，避开这些坑）
- 本地部署：Windows 10/11（必须开启WSL2，纯CMD/PowerShell无法运行）、macOS 12+、Ubuntu 20.04/22.04（最推荐，兼容性最好）
- 服务器部署：阿里云/腾讯云轻量服务器（≥2核2GB，系统选Ubuntu 22.04 LTS，避免CentOS，依赖兼容问题多）
- 不支持：Windows 7/8、CentOS 7及以下、ARM架构设备（如树莓派，暂不兼容）
2. 核心依赖安装（一步都不能少，真实命令）
（1）Node.js（关键：版本必须≥v18，推荐v20 LTS，亲测最稳）
新手别直接装系统自带的Node.js，版本太低，用nvm（Node版本管理器）安装，能避免版本冲突，后续切换版本也方便。macOS/Linux（含Windows WSL2）执行以下命令，复制粘贴即可，不用改：
注意：Windows用户必须先开启WSL2（网上搜“Windows 11开启WSL2”，步骤简单，5分钟搞定），再在WSL2终端里执行上面的命令，别在PowerShell里装，必出问题。
（2）Git（拉取源码必备，真实命令）
（3）大模型API Key（必须有，AI智能体核心，真实可用）
MoltBot本身不提供大模型能力，必须对接第三方大模型，新手优先选阿里云百炼（有免费额度，不用花钱，实名认证即可），步骤如下：
- 注册阿里云账号（https://account.aliyun.com/），完成实名认证（个人实名认证即可）；
- 登录阿里云控制台，搜索“百炼大模型”，进入百炼控制台；
- 左侧导航“API密钥管理”，点击“创建API Key”，生成后保存好「AccessKey ID」和「AccessKey Secret」（只显示一次，丢了只能重新创建）；
- 可选：若想用通义千问、字节火山大模型，流程类似，都是在对应平台创建API Key，后续配置替换即可。
第一步：真实部署MoltBot（从源码拉取到启动，全真实命令）
MoltBot没有官方一键安装包，唯一可部署的方式就是从GitHub拉取源码，步骤不多，慢一点来，每一步都有反馈，能及时排查问题。
1. 拉取MoltBot真实源码（GitHub官方仓库）
这是真实存在的仓库，可直接访问：https://github.com/moltbot/moltbot，复制以下命令拉取源码：
克隆成功后，目录里会有完整的代码文件，可通过ls命令查看（ls 后能看到package.json、src等文件夹，就是对的）。
2. 安装项目依赖（国内用户必换镜像，避免下载超时）
⚠️ 常见坑：安装依赖时报错“node-gyp build failed”，是缺少系统编译工具，补装即可，真实命令如下：
补装后，重新执行npm install，就能正常安装依赖了。
3. 初始化MoltBot配置（真实配置文件，可直接修改）
MoltBot的配置文件是config.json，在项目根目录下，默认有模板，我们只需要复制模板，修改核心参数即可，不用手动创建：
接下来，编辑config.json文件，用vim或记事本打开（本地部署可用记事本，服务器用vim），只改以下核心参数，其余保持默认（改多了容易出错）：
保存配置文件（vim编辑：按Esc，输入:wq，回车即可）。
4. 启动MoltBot（真实启动命令，可验证是否成功）
启动分两种方式，新手优先用前台启动，方便查看日志，排查问题；服务器部署用后台启动，避免关闭终端后服务停止。
启动成功的标志：前台启动时，控制台输出“MoltBot server started on http://0.0.0.0:18789”，没有红色报错；后台启动时，执行ps aux | grep node，能看到moltbot相关进程，就是启动成功了。
第二步：MoltBot配置优化（只改关键，不瞎折腾）
config.json里还有几个可选参数，新手不用全懂，按需修改即可，不改也不影响基础使用，主要优化体验：
- model.temperature：生成内容的随机性，取值0-1，0.2~0.5足够，太高容易乱输出，太低回复太生硬，我一般设0.3；
- server.timeout：超时时间，默认30000（30秒），不用改，避免请求超时；
- plugins.feishu.debug：飞书插件调试模式，新手可设为true，方便查看飞书对接的日志，排查问题，后续稳定后可设为false。
修改后，重启MoltBot生效（前台启动直接Ctrl+C停止，再执行npm run start；后台启动先kill进程，再重新执行后台启动命令）。
第三步：接入飞书（真实流程，无虚构插件，社区官方支持）
MoltBot自带飞书插件（不是虚构的，项目源码里已集成，我们只需要配置飞书开放平台，对接即可），这一步是核心，每一步都要仔细，错一个地方就对接失败。
第一步：飞书开放平台创建自定义应用（真实操作，无虚构）
- 登录飞书开放平台（https://open.feishu.cn/），点击右上角“开发者后台”，用你的飞书账号登录（个人账号也可，企业账号权限更全，推荐用企业账号）；
- 登录后，点击左侧“应用管理”→“创建应用”，选择“自定义应用”，填写应用信息：
- 应用名称：MoltBot-Assistant（随便起，好识别即可）；
- 应用描述：MoltBot对接飞书智能助手，实现自动回复；
- 点击“创建”，进入应用详情页，重点：复制“凭证与基础信息”里的「App ID」和「App Secret」，Secret只显示一次，立刻保存到记事本，丢了只能重新创建！
第二步：开启机器人能力+配置核心权限（缺一不可）
- 左侧导航“能力管理”→“添加能力”，搜索“机器人”，点击“开启”，开启后才能接收和发送飞书消息；
- 左侧导航“权限管理”→“添加权限”，搜索并勾选以下5个权限（少一个都不行，亲测）：
- im:message:send：允许机器人发送消息；
- im:message:read：允许机器人读取消息；
- im:conversation:read：允许机器人读取会话信息；
- im:group:read：允许机器人读取群聊信息（如需群聊回复，必须勾）；
- contact:user:read：允许机器人获取用户基本信息；
- 勾选完成后，点击“申请权限”，飞书客户端会收到审批通知，点击“通过”，权限才会生效（个人账号创建的应用，审批人就是自己，直接通过即可）。
第三步：配置MoltBot飞书插件（真实配置，对接飞书）
回到MoltBot项目目录，找到plugins/feishu/config.example.json，复制模板生成飞书插件配置文件，修改为飞书应用信息：
修改config.json内容，替换为你的飞书应用信息，其余保持默认：
⚠️ 关键坑：callbackUrl必须是公网地址，飞书无法访问本地IP！- 服务器部署：直接填“http://你的服务器公网IP:18789/feishu/callback”，同时在阿里云/腾讯云服务器的安全组里，放行18789端口（必须做，不然飞书回调连不上）；- 本地部署：没有公网IP，需用内网穿透工具（推荐cpolar，国内可用，免费额度足够），步骤如下：
- 下载cpolar（https://www.cpolar.com/），安装后登录（注册账号即可，免费额度足够）；
- 执行命令：cpolar http 18789，会生成一个公网地址（比如https://abc123.cpolar.io）；
- 把callbackUrl改成这个公网地址+“/feishu/callback”，比如https://abc123.cpolar.io/feishu/callback。
保存飞书插件配置文件，回到MoltBot项目根目录（cd ../../），重启MoltBot服务，让飞书插件配置生效。
第四步：飞书开放平台配置事件回调（最后一步，对接成功关键）
- 回到飞书开发者后台→应用详情→左侧“事件订阅”，点击“设置”；
- 回调URL：填写你上面配置的callbackUrl（公网地址）；
- 加密密钥：填写飞书插件config.json里的encryptKey（留空则不填）；
- 验证令牌：填写飞书插件config.json里的verifyToken（留空则不填）；
- 添加事件：点击“添加事件”，搜索并添加以下两个事件（必须添加，不然收不到消息）：
- im.message.receive_v1：单聊消息接收事件（机器人接收个人消息）；
- im.message.group_receive_v1：群聊消息接收事件（机器人接收群聊消息）；
- 点击“保存”，然后左侧导航“版本管理与发布”→“创建版本”，填写版本号（比如v1.0.0），描述随便写一句，点击“发布”→“发布为在线应用”，飞书客户端审批通过后，应用状态变为“已上线”。
第四步：验证对接（真实测试，确认能正常使用）
所有配置完成后，验证一下，确保MoltBot能正常接收并回复飞书消息，步骤如下：
- 确保MoltBot服务正常运行（前台启动有日志输出，后台启动有进程）；
- 打开飞书客户端，搜索你创建的应用机器人（MoltBot-Assistant），进入单聊界面；
- 发送一条消息，比如“你好”，等待1-3秒（视网络速度而定）；
- 若没回复，查看MoltBot前台日志（前台启动的话，日志会显示是否收到飞书消息），排查问题。
避坑指南：我实测踩过的5个真实坑，别再掉进去
- Node.js版本问题：低于v18必报错，哪怕v17也不行，必须用nvm装v20 LTS，亲测最稳；
- 公网访问问题：本地部署没开内网穿透、服务器没放行18789端口，飞书回调会失败，机器人收不到消息；
- 飞书权限问题：少勾一个权限、权限没审批通过，机器人无法发送/接收消息，一定要检查权限状态；
- 大模型API Key问题：AccessKey ID和Secret搞反，或者没实名认证，会导致MoltBot无法调用大模型，日志会报“api key error”；
- 配置文件问题：修改config.json后没重启MoltBot，配置不生效，每次改完都要重启服务。
常见问题排查（真实解决方案，能直接用）
- 问题1：MoltBot启动报错“Cannot find module 'xxx'”——依赖没安装全，重新执行npm install，若还是不行，删除node_modules文件夹，再重新安装；
- 问题2：飞书发送消息，机器人没回复，日志显示“callback not found”——飞书回调URL填错，或内网穿透地址失效，重新检查callbackUrl，重启cpolar；
- 问题3：调用大模型报错“permission denied”——阿里云百炼API Key没实名认证，或免费额度用完，去阿里云百炼控制台检查；
- 问题4：服务器部署，飞书回调失败——安全组没放行18789端口，去阿里云/腾讯云控制台，添加安全组规则，放行18789端口（TCP协议）。
最后说两句，整个流程核心就是“拉取真实源码→安装依赖→配置大模型→飞书开放平台创建应用→对接插件”，没有虚构内容，每一步都能复现。跟着敲命令，新手也能一次搞定，对接成功后，就能用飞书控制MoltBot，实现自动回复、文档处理等功能，真正提升办公效率。
AI 速览
