OpenClaw保姆级教程：2026最新版零基础安装部署，手把手教你“养龙虾”

OpenClaw（曾用名 Clawdbot/Moltbot）是一个开源的 AI 自动化代理平台。它不仅仅是聊天机器人，而是能真正执行任务的 AI 助手——帮你处理邮件、管理日程、操作电脑文件、抓取数据，甚至写代码。

与传统 AI 助手的区别

• 传统 AI：你问“帮我整理桌面文件”，它只会给你文字建议。
• OpenClaw：你下达指令，它直接重命名、分类、移动文件，并告诉你“已完成”。

在开始安装前，请确保你的电脑满足以下条件：

系统要求

• 操作系统：macOS、Linux 或 Windows（必须安装 WSL2，推荐 Ubuntu）。不建议直接在 Windows 命令提示符下运行。
• Node.js：版本 ≥ 22（必须）
• 内存：至少 2GB（推荐 4GB+）
• 网络：国内用户需准备代理（如 Clash 等），否则 Gateway 可能无法启动。
• API Key：你需要一个 AI 模型的 API 密钥。推荐国内用户使用 MiniMax（国内直连，有免费额度）或 智谱 GLM。也可以使用 Anthropic Claude 或 OpenAI（需代理）。

检查并安装 Node.js

打开终端（macOS/Linux）或 WSL2 终端，输入：

获取 API Key（以 MiniMax 为例）

1. 访问 MiniMax 官网 注册登录。
2. 进入控制台，创建 API Key，复制保存（注意：只显示一次）。

一键安装（推荐新手）

根据你的操作系统，在终端中运行对应命令：

macOS / Linux

Windows (在 WSL2 的 Linux 终端中运行，不要在 PowerShell 直接运行)

验证安装

如果显示版本号（如 ），说明安装成功。

运行以下命令启动配置向导：

向导会问你一系列问题，请按如下建议回答：

步骤说明

1. Gateway 模式：选择 （本地运行，推荐新手）。
2. 认证方式：选择你准备好的 API Key 提供商，例如 。
3. 输入 API Key：粘贴你之前复制的 Key。
4. 选择默认模型：根据你的提供商选择，例如 MiniMax 的 。
5. 频道配置：这里先不选择任何频道（直接回车跳过），后面我们会手动接入飞书。
6. 配对安全设置：保持默认（ 模式）。
7. 工作区目录：保持默认 。
8. 安装推荐技能：建议输入  安装基础技能。
9. 后台服务安装：输入  安装服务，这样 OpenClaw 会开机自启。

向导完成后，会生成一个 Gateway token，请保存好（后续 Web UI 登录可能需要）。

查看服务状态

如果显示 ，说明服务已启动。

打开 Web UI

https://via.placeholder.com/800×400?text=OpenClaw+Web+UI

让 OpenClaw 接入飞书，你就可以在手机/电脑上随时随地指挥它。

6.1 创建飞书应用

1. 打开 飞书开放平台，点击「创建应用」→「企业自建应用」，名称随意（如“我的龙虾”）。
2. 创建成功后，在「凭证与基础信息」页面，复制 App ID 和 App Secret 备用。

6.2 安装飞书插件

OpenClaw 需要安装一个飞书插件才能连接。在终端执行：

6.3 修改 OpenClaw 配置文件

编辑 ，在  中添加飞书配置：

保存文件后，重启 Gateway：

6.4 配置飞书应用权限和事件

1. 回到飞书开放平台，进入你的应用。
2. 在「权限管理」中，开启以下权限（至少）：
3. 在「事件与回调」中，订阅方式选择「长连接」，添加事件：
4. 在「版本管理与发布」中，创建一个版本并发布（仅需发布到企业内，可选）。

6.5 在飞书中测试

1. 打开飞书，搜索你刚刚创建的应用名称（如“我的龙虾”），进入对话。
2. 发送一条消息，例如 。如果机器人回复（可能需要先批准配对），说明接入成功。
   

   注意：首次私聊会收到一个配对码，你需要记住这个码，然后在终端中批准：

   Skills 是 OpenClaw 的“工具箱”。安装后，你的龙虾才能执行具体任务。

   常用技能推荐

   技能名称 安装命令 功能 联网搜索 实时联网搜索 文件管理 读写、整理文件 定时任务 设置提醒、日报 网页自动化 控制浏览器 邮件管理 处理 Gmail 等

   安装示例：

查看已安装技能

使用技能示例

在飞书中对机器人说：

机器人就会调用相应技能执行。

常用命令速查

安全建议（非常重要）

• 不要将 Gateway 暴露在公网：默认只监听 ，不要随意修改。
• 使用 Token 认证：如果要从其他设备访问 Web UI，需设置 token：

启用沙盒模式：限制 AI 对系统的访问：

定期备份配置：

Q1: Gateway 无法启动，提示网络错误？

• 原因：国内网络无法访问 GitHub 等资源。
• 解决：在终端设置代理（假设代理地址为 ）：

• 然后重新启动 Gateway。

Q2: 飞书机器人不回复？

• 检查：
  1. 是否已批准配对？ openclaw
  2. 飞书应用的权限和事件是否配置正确？
  3. 查看日志  看有无错误。

Q3: 命令  找不到？

• 原因：Node.js 的全局 bin 目录未加入 PATH。
• 解决：找到安装位置（如 ），加入 PATH：

Q4: 模型调用失败，提示 API Key 无效？

这些就是安装部署一只龙虾的教程了

• 重新配置：

  或手动设置：

  恭喜！你已经成功部署了自己的 OpenClaw 助手，并接入了飞书。现在你可以：

• 继续探索更多 Skills，让助手帮你处理邮件、管理日历。
• 尝试编写自定义 Skill（参考第四篇教程的“中级阶段”）。