保姆级 OpenClaw （原 Clawdbot）飞书对接教程手把手教你搭建 AI 助手

何书艺 · 前天 19:15

<h1 id="保姆级-openclaw-原-clawdbot飞书对接教程-手把手教你搭建-ai-助手">保姆级 OpenClaw （原 Clawdbot）飞书对接教程手把手教你搭建 AI 助手</h1>
<p>OpenClaw 是一款开源的本地 AI 助手,支持在你自己的服务器上部署,通过飞书、WhatsApp、Telegram 等聊天工具交互。与云端 SaaS 服务不同,OpenClaw 让你完全掌控数据隐私,可以执行系统命令、浏览网页、管理文件,甚至编写代码。本教程将手把手教你在 Linux 系统下安装 OpenClaw 并对接飞书机器人,打造专属的智能助理。</p>
<blockquote>
<p>注意：本教程在 Linux 系统下进行</p>
</blockquote>
<h2 id="openclaw-是什么">OpenClaw 是什么？</h2>
<p>OpenClaw(原名 Clawdbot,后更名为 Moltbot,现正式命名为 OpenClaw)是一个运行在你本地环境的高权限 AI 智能体。它的核心特性包括：</p>
<ul>
<li><strong>本地部署</strong>：运行在你的服务器或电脑上,数据完全自主可控</li>
<li><strong>多平台支持</strong>：支持飞书、WhatsApp、Telegram、Discord、Slack 等主流聊天工具</li>
<li><strong>浏览器控制</strong>：可以浏览网页、填写表单、提取数据</li>
<li><strong>系统访问</strong>：读写文件、执行 Shell 命令、运行脚本</li>
<li><strong>持久化记忆</strong>：记住你的偏好和上下文,成为真正属于你的 AI</li>
<li><strong>插件扩展</strong>：支持社区技能插件,甚至可以自己编写插件</li>
</ul>
<p>无论是邮件管理、日程安排、数据查询还是代码编写,OpenClaw 都能成为你的得力助手。</p>
<h2 id="准备工作">准备工作</h2>
<p>首先准备一台闲置的云服务器或 VPS（推荐使用香港或海外节点）。由于 OpenClaw 运行时权限较大，出于安全考虑，不建议在本地或工作机上安装，推荐在一台独立的空服务器上部署。准备完成后，登录到服务器。</p>
<h2 id="安装">安装</h2>
<blockquote>
<p>如果你不想安装，可以直接使用阿里云的Openclaw 一键部署 (原 Clawdbot)，部署之后可以直接跳到对接飞书。</p>
</blockquote>
<p>第一步安装 Git</p>

<code ># 安装 Git
sudo apt update
sudo apt install git -y
</code>

复制代码

<p>第二步安装 Node.js</p>

<code ># 安装 NVM
# 国内使用 gitee 的镜像源
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
# 国外使用
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
# 重新加载环境变量
source ~/.bashrc
# 安装 Node.js 22
nvm install 22
# 查看 nodejs 版本
node -v # 输出 v22 即可，版本只要 22 就行
</code>

复制代码

<h2 id="安装-openclaw">安装 Openclaw</h2>

<code ># 使用官方脚本安装
curl -fsSL https://openclaw.bot/install.sh | bash
</code>

复制代码

<blockquote>
<p>服务器在国内，如果安装失败的话，可能需要解决网络问题</p>
</blockquote>
<p>其他平台安装方式请参考Openclaw 安装文档 (原 Clawdbot)</p>
<p>你会看到如下图输出<br>

<br>
如果首次安装，时间会很长，需要耐心等待。<br>
如果最后输出如下内容：</p>

<code >→ npm install failed; cleaning up and retrying...
</code>

复制代码

<p>新的脚本服务器内存要求变高了，据我使用下来 2G 内存，肯定会 OOM，如果出错的话，建议使用 <code>swap</code> 把硬盘空间当作交互内存使用。</p>
<p>成功之后会输出如下图片<br>

<br>
第一个选项选择 <code>yes</code>, 就是询问你是否知道风险的。<br>
第二步选择 <code>QuickStart</code><br>

<br>
第三步选择模型服务商，这里选择 <code>Qwen</code>，免费额度充足，适合入门使用<br>

<br>
选择千问模型后，会提供一个链接，复制并在浏览器中打开，如下图<br>

<br>
打开浏览器后，会看到如下界面。由于我已登录过，所以显示账户信息；如果尚未登录，按照提示完成登录即可。<br>

<br>
登录完成后，会出现以下选项，提示选择对应的千问模型，如下图<br>

</p>
<p>选择默认模型即可。接下来会提示选择 channel，这里先跳过，后续再添加</p>
<p>

<br>
继续下面选择 skills，也是选择 <code>No</code>，如下图<br>

<br>
继续下面选择 hooks，也是使用<code>空格</code>选择 <code>No</code>，如下图<br>

<br>
然后等待安装完成，最后会出现以下选项，这里选择 <code>TUI</code><br>

<br>
如果看到 TUI 聊天界面，说明安装成功，可以尝试输入 <code>Hello</code> 进行测试。<br>

<br>
然后直接使用 <code>ctrl+c</code> 先关闭，后面我们再来设置</p>
<h3 id="查看服务">查看服务</h3>
<p>可以使用下面的命令来查看</p>

<code >clawdbot status
</code>

复制代码

<p>会看到如下图的结果就说明服务启动了<br>

</p>
<h3 id="访问-web-ui-面板">访问 Web UI 面板</h3>
<p>如何访问面板？服务监听在 <code>http://127.0.0.1:18789/</code> 端口上，我们现在通过 ssh 隧道来访问，输入下面的命令</p>

<code >ssh -N -L 18789:127.0.0.1:18789 用户名@服务器IP
# 回车之后
用户名@服务器IP's password: # 输入密码
</code>

复制代码

<p>然后在浏览器打开 <code>http://127.0.0.1:18789/</code>, 你会看到 Dashboard 了，如下图<br>

<br>
图中显示的是未授权状态，回到服务器，输入以下命令</p>

<code >clawdbot dashboard
</code>

复制代码

<p>会看到下面的面板数据<br>

<br>
复制对应的 <code>Dashboard URL</code> 到浏览器打开，即可正常查看聊天记录。<br>

</p>
<p>至此 Openclaw (原 Clawdbot) 已安装完成，可以正常访问了。然后聊天框里面首次输入 <code>Hello</code>, <code>Clawdbot</code> 会询问你他应该叫什么，应该叫你什么。就是你需要给它设置个名字，还有 bot 改叫你什么。你可以在聊天框这么输入</p>

<code >Name: Openclaw
My Name: Boss
</code>

复制代码

<h2 id="对接飞书">对接飞书</h2>
<p>首先安装飞书插件，输入以下命令</p>

<code >clawdbot plugins install @m1heng-clawd/feishu
</code>

复制代码

<p>登录飞书开放平台 https://open.feishu.cn，点击「开发者后台 -> 创建企业自建应用」，如下图<br>

<br>
然后点击创建应用，如下<br>

<br>
创建完成后，首先到凭据管理中获取 App ID 和 App Secret，注意保存，后续配置需要使用。<br>

<br>
然后添加机器人，如下操作<br>

<br>
首先配置个名字<br>

</p>
<p>飞书的其他配置先暂停，回到服务器配置 Openclaw 的飞书参数</p>
<h3 id="添加飞书配置">添加飞书配置</h3>

<code >clawdbot config set channels.feishu.appId "飞书 app id"
clawdbot config set channels.feishu.appSecret "飞书 app secret"
clawdbot config set channels.feishu.enabled true
# 推荐使用 websocket
clawdbot config set channels.feishu.connectionMode websocket
clawdbot config set channels.feishu.dmPolicy pairing
clawdbot config set channels.feishu.groupPolicy allowlist
clawdbot config set channels.feishu.requireMention true
</code>

复制代码

<p>配置完成之后，重启</p>

<code >clawdbot gateway restart
</code>

复制代码

<h3 id="支持群机器人">支持群机器人</h3>
<p>如果需要在群聊中支持。你可以创建飞书群聊，然后把机器人应用拉进群里，但是上面的配置就需要做修改了。</p>
<blockquote>
<p>实际上你可以通过跟机器人聊天让它去改，把下面的命令告诉它，让它去改就行了。不需要自己去服务器改</p>
</blockquote>

<code ># 这个配置兼容上面的配置
clawdbot config set channels.feishu.dmPolicy open
clawdbot config set channels.feishu.groupPolicy open
clawdbot config set channels.feishu.allowFrom ['*']
</code>

复制代码

<p>重启完成后回到飞书，找到「事件和回调」，选择长连接模式，如下图<br>

<br>
如果配置成功，说明连接已建立。继续下面的配置，添加事件，选择「接收消息」事件<br>

<br>
事件添加完成之后，还需要开通权限，有以下权限全部勾选</p>
<table>
<thead>
<tr>
<th>权限</th>
<th>Scope（范围）</th>
<th>Description（说明）</th>
</tr>
</thead>
<tbody>
<tr>
<td>contact:user.base:readonly</td>
<td>用户信息</td>
<td>获取基础用户信息</td>
</tr>
<tr>
<td>im:message</td>
<td>消息全部勾选</td>
<td>发送和接收消息</td>
</tr>
</tbody>
</table>
<p>如下图<br>

</p>
<p>

</p>
<p>以上步骤全部完成后，即可与机器人对话。但在此之前需要先创建一个版本<br>

</p>
<blockquote>
<p>注意：每次修改配置后都需要重新发布版本，建议全部配置完成后再统一发布。</p>
</blockquote>
<p>发布完成后，回到飞书客户端，可以看到应用已上线，点击打开应用<br>

<br>
向机器人发送 <code>Hello</code>，即可收到 Moltbot 的回复<br>

</p>
<h2 id="常见问题-faq">常见问题 FAQ</h2>
<h3 id="openclaw-和-clawdbotmoltbot-是什么关系">OpenClaw 和 Clawdbot、Moltbot 是什么关系？</h3>
<p>OpenClaw 是该项目的最新正式名称。项目最初叫 Clawdbot，后因商标问题更名为 Moltbot，最终在 2025 年 1 月正式定名为 OpenClaw。三者是同一个项目的不同阶段命名。</p>
<h3 id="openclaw-支持哪些-ai-模型">OpenClaw 支持哪些 AI 模型？</h3>
<p>OpenClaw 支持多种 AI 模型服务商，包括 Anthropic Claude、OpenAI GPT、通义千问（Qwen）、KIMI、小米 MiMo 等。本教程使用通义千问是因为其免费额度充足，适合入门学习。</p>
<h3 id="为什么安装时提示-npm-install-failed">为什么安装时提示 npm install failed？</h3>
<p>这通常是服务器内存不足导致的。新版本脚本对内存要求较高，2G 内存可能会出现 OOM（内存溢出）。建议配置 swap 交换空间，将硬盘空间作为虚拟内存使用。</p>
<h3 id="openclaw-可以在-windows-或-macos-上运行吗">OpenClaw 可以在 Windows 或 macOS 上运行吗？</h3>
<p>可以。OpenClaw 支持 Mac、Windows 和 Linux 系统。本教程以 Linux 为例，其他系统的安装方式可参考官方文档。</p>
<h3 id="飞书机器人配置后无法收到消息怎么办">飞书机器人配置后无法收到消息怎么办？</h3>
<p>请检查以下几点：</p>
<ol>
<li>确认飞书插件已正确安装（<code>clawdbot plugins install @m1heng-clawd/feishu</code>）</li>
<li>检查 App ID 和 App Secret 配置是否正确</li>
<li>确认已开通「接收消息」事件权限</li>
<li>检查长连接模式是否配置成功</li>
<li>确保应用版本已发布</li>
</ol>
<h3 id="openclaw-数据安全吗">OpenClaw 数据安全吗？</h3>
<p>OpenClaw 运行在你自己的服务器上，所有数据都在本地存储，不会上传到第三方云端。但由于它具有系统级权限，建议在独立的服务器上部署，避免在生产环境或重要数据的机器上运行。</p>
<h3 id="除了飞书openclaw-还支持哪些平台">除了飞书，OpenClaw 还支持哪些平台？</h3>
<p>OpenClaw 支持多个聊天平台，包括 WhatsApp、Telegram、Discord、Slack、Microsoft Teams、Signal、iMessage、Google Chat、Twitch 等。每个平台需要安装对应的插件。</p>
<h3 id="openclaw-可以做什么">OpenClaw 可以做什么？</h3>
<p>OpenClaw 可以执行多种任务：</p>
<ul>
<li>邮件管理和自动回复</li>
<li>日程安排和提醒</li>
<li>浏览网页和数据提取</li>
<li>文件读写和管理</li>
<li>执行 Shell 命令</li>
<li>编写和运行代码</li>
<li>数据查询和分析</li>
</ul>
<h3 id="如何更新-openclaw-到最新版本">如何更新 OpenClaw 到最新版本？</h3>
<p>使用以下命令更新：</p>

<code >openclaw update
</code>

复制代码

<h3 id="openclaw-命令和-clawdbot-命令有什么区别">OpenClaw 命令和 clawdbot 命令有什么区别？</h3>
<p>OpenClaw 更名后，官方推荐使用 <code>openclaw</code> 命令，但为了兼容性，<code>clawdbot</code> 命令仍然可用。两者功能完全相同，建议新用户直接使用 <code>openclaw</code> 命令。</p>
<p>保姆级 OpenClaw （原 Clawdbot）飞书对接教程手把手教你搭建 AI 助手</p><br>来源：程序园用户自行投稿发布，如果侵权，请联系站长删除<br>免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

账号		自动登录	找回密码
密码			立即注册

保姆级 OpenClaw （原 Clawdbot）飞书对接教程手把手教你搭建 AI 助手

相关帖子

浏览过的版块

签约作者

保姆级 OpenClaw （原 Clawdbot）飞书对接教程 手把手教你搭建 AI 助手

相关帖子

相关推荐

浏览过的版块

签约作者

保姆级 OpenClaw （原 Clawdbot）飞书对接教程手把手教你搭建 AI 助手