OpenClaw安装保姆级教程

发布于 · 2026-01-31 · # 逻辑编织

0. 前言

OpenClaw 简介

OpenClaw（原名 Moltbot/Clawdbot）是一个开源的、本地优先的个人AI助手网关。它允许用户在自己的硬件上运行 AI Agent，将 DeepSeek、Claude 等大模型能力直接接入飞书、TG等即时通讯软件。与传统聊天机器人不同，OpenClaw 拥有“执行力”，可以通过插件系统操作设备、管理文件、甚至与其他 Agent 协作。其核心理念是数据主权，确保所有的上下文记忆和操作权限都保留在用户自己的设备上，而非云端厂商的围墙内。

OpenClaw 发展时间线（2026年1月）

2026年1月中旬 - "Clawdbot" 时期：项目以 Clawdbot 之名在开发者社区（GitHub, Reddit）爆火，被誉为能真正做事的AI，因其能将个人电脑转化为全能AI助理而引发关注。
2026年1月27日 - "Moltbot" 过渡期：随着项目热度出圈（甚至带动了二手 Mac Mini 的销量），项目组短暂将名称更改为 Moltbot，并在多个云平台发布了快速部署指南，国内云服务厂商亦有主动跟进。
2026年1月30日 - "OpenClaw" 正式定名：为了解决频繁更名带来的“身份危机”并确立开源定位，项目正式更名为 OpenClaw，并发布了里程碑版本 v2026.1.30，同步上线了全新的 Web 管理界面。

1. 基础环境配置

OpenClaw是基于node.js环境实现的，所以在安装之前，需要自己先装好node.js的环境。虽然一键脚本可以自动帮你安装，但我还是习惯手动安装，且通过nvm对node.js进行包管理，具体步骤如下：

使用脚本安装NVM

#使用安装脚本一键安装NVM
root@ubuntu-s-2vcpu-2gb-sfo2-01:~# curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash 

……

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

root@ubuntu-s-2vcpu-2gb-sfo2-01:~# source .bashrc

#确认NVM已经安装成功，正常输出版本号极即为安装成功
root@ubuntu-s-2vcpu-2gb-sfo2-01:~# nvm --version
0.40.4

使用NVM安装node.js，安装pnpm

root@ubuntu-s-2vcpu-2gb-sfo2-01:~# nvm install --lts
Installing latest LTS version.

……

Now using node v24.13.0 (npm v11.6.2)
Creating default alias: default -> lts/* (-> v24.13.0 *)

2. 通过npm安装OpenClaw

# 执行安装命令
root@ubuntu-s-2vcpu-2gb-sfo2-01:~# npm install -g openclaw-cn@latest
changed 1 package in 2s
1 package is looking for funding
  run `npm fund` for details

安装完成后可以通过如下命令，确认是否已经完成安装，如果可以正常输出版本号且不报错即为安装成功：

root@ubuntu-s-2vcpu-2gb-sfo2-01:~# openclaw-cn --version
2026.1.30

3. 配置OpenClaw

# 运行安装向导
openclaw-cn onboard --install-daemon

根据提示输入相关信息，配置好模型，完成初始化配置。（消息通知渠道可以暂时不配置，跳过即可）

4. 配置飞书渠道

第一步：创建飞书应用

打开飞书开放平台
访问飞书开放平台，使用飞书账号登录。
创建应用
点击创建企业自建应用

填写应用名称和描述、选择应用图标、创建企业自建应用

获取应用凭证
在应用的凭证与基础信息页面，复制：
App ID（格式如 cli_xxx）
App Secret
❗ 重要：请妥善保管 App Secret，不要分享给他人。

配置应用权限
在权限管理页面，点击批量导入按钮，粘贴以下 JSON 配置一键导入所需权限：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

启用机器人能力
在应用能力 > 机器人页面：开启机器人能力

配置机器人名称

至此我们在飞书开放平台中的配置告一段落，接下来让我们切换到终端中，继续完成OpenClaw中的飞书渠道配置。

第二步：在OpenClaw中配置飞书渠道

通过向导配置，运行以下命令，根据提示粘贴 App ID 和 App Secret：

openclaw-cn channels add

重启网关服务使配置生效：

# 重启openclaw网关服务
systemctl --user restart openclaw-gateway
# 查看服务状态，确认是否启动成功
systemctl --user status openclaw-gateway
# 实时查看日志输出，确认是否存在飞书渠道启动成功的日志
journalctl --user -u openclaw-gateway -f

第三步：回到飞书完成机器人事件配置

在事件订阅页面：选择使用长连接接收事件（WebSocket 模式）；同时添加事件：im.message.receive_v1（接收消息）

如果出现上图4️⃣中所提示的【应用未建立长连接】，则说明第二步的网关配置未成功，需要返回检查。

发布应用：在版本管理与发布页面创建版本，提交审核并发布，等待管理员审批（企业自建应用通常自动通过）

第四步：测试飞书机器人

发送测试消息
在飞书中找到您创建的机器人，发送一条消息。

配对授权
默认情况下，机器人会回复一个配对码。您需要批准此代码，批准后即可正常对话。

openclaw-cn pairing approve feishu <配对码>

5. 效果展示

至此，已经成功完成了OpenClaw的安装和飞书渠道的配置。现在，您可以在飞书中与机器人进行交互。