OpenClaw 是 Moltbot/Clawdbot 的最新正式名称。经过版本迭代与改名后，2026 年统一以「OpenClaw」作为官方名称，核心定位是通过自然语言指令，替代人工完成流程化、重复性工作，无需用户掌握编程技能，适配多场景自动化需求。
该项目经历了多次更名，Clawdbot → Moltbot → OpenClaw（当前名称）
OpenClaw 是什么？
OpenClaw 是一个开源的个人 AI 助手平台。
简单来说，它是一个可以将你自己的 AI 助手接入你已经在用的即时通讯工具（Telegram、WhatsApp、飞书等）的系统。你可以自己挑选 AI 模型进行连接，添加各种工具和技能（如飞书等），构建专属工作流。如果应用得好，它就是一个能帮你干活的'员工'。
OpenClaw 采用模块化设计，其核心架构如图所示。
注意：OpenClaw 需要访问不少本地权限和文件。建议找一台没有数据的 Mac 来试水，避免自己的隐私数据泄露。
准备工作
在开始之前，请确认你的 Mac 满足以下条件：
- macOS Sonoma 或更新版本（推荐使用 Apple Silicon M1 及以上芯片，性能会更好）。
- 流畅的网络环境，必要时可能需要配置代理（部分依赖库需要从 GitHub 下载）。
官方网站：https://openclaw.ai/
安装方式说明
对于新手来说，官网给出的四个安装方式区别如下：
- One-liner： 一键脚本安装，最简单、官方推荐。它会自动检测系统并安装依赖。适合个人用户，想快速在 Mac/Linux 上体验完整功能。缺点是如果你对系统环境有洁癖，脚本方式侵入性太强，不方便后期更新维护。
- npm： 全局安装方式，需要依赖 Node.js 包管理器安装，适合前端开发者或已熟悉 Node.js 的用户。通过它安装，你知道自己在装什么，依赖了什么，不会弄乱你的开发环境。版本控制方便，更新更容易，本文选用此安装方式。
- Hackable： 源码安装方式，可任意魔改，下载源代码到本地。适合想要修改核心逻辑、自己写复杂插件、或者给项目提 PR 的人（小白请直接忽略）。
- macOS： GUI 界面应用，这是一个 Mac 端应用，提供了一个菜单栏图标，原生体验并提供语音交互、快捷指令等原生 Mac 功能。但是它通常是为了配合 CLI（命令行版）使用的，而不是完全替代命令行，想用此应用还是需要先安装前三中任意一个。
经过上面的解释你应该很清楚各个安装方式的区别了，只是想玩玩 OpenClaw 并且懒得装 Node 环境，玩完重装系统也无所谓，那就一键部署选 One-liner。如果想把它当主力工具，长期稳定使用，出了问题好修、版本好管、系统干净，那就选 npm 安装。
环境配置（npm 安装）
OpenClaw 依赖于 Node.js 环境。如果你不懂这是什么，没关系，照着输命令即可。
官方下载地址：https://nodejs.org/zh-cn/download
- 复制官网链接到浏览器打开，然后点击 macOS 安装程序（.pkg）下载安装包。如果你更熟悉用 Homebrew 下载，那会更方便，官网下载可避免一些未知错误；
- 然后打开下载后的安装包，按照安装包的直接正常安装即可；
- 安装完成，点击「关闭」即可；
- 打开「终端」；
- 在终端内输入：
sudo npm i -g openclaw
然后回车，输入开机密码后再回车；
- 如果出现如图错误，修改 Git 下载协议（强制使用 HTTPS），复制下方代码到终端，回车执行即可解决；
git config --global url."https://github.com/".insteadOf ssh://[email protected]/
- 重新输入
sudo npm i -g openclaw，出现如图界面表示安装成功；
- 启动 OpenClaw 的初始化向导，输入下方代码，然后回车；
openclaw onboard
- 这一步主要是提醒你，使用 OpenClaw 可能会有一些风险。请问你是否继续？按向左方向键 ←，选择
Yes，按 Enter 回车确认；
- 选择 QuickStart（快速开始模式），回车；
- 这里是配置 AI 模型 API Key，OpenClaw 需要连接到大语言模型才能工作。OpenClaw 比较费 token，国外模型成本较高，新版本已经支持 KIMI K2.5，小编以 KIMI 为例；
注：其他任意模型均可，也可以用 Ollama 本地运行的 DeepSeek 的蒸馏版，即可免费使用 AI 模型。
- 如果没有 KIMI 的 API Key，打开下方官方地址注册账号获取 API key，KIMI 认证后的账号可以获得 15 元的免费代金券；
https://platform.moonshot.cn/console/api-keys
- 然后复制你的 API key，请保存好自己的 API；
- 选择 Kimi API key (.cn)，回车；
- 然后输入你的 API Key，回车；
- 选择保持当前（moonshot/kimi-k2.5），回车；
- 接着你会看到选择聊天选择工具的选项。这里你建议先「暂时跳过」，先在终端（Terminal）里把 OpenClaw 跑起来，确认它的 AI 大脑、文件读写权限都正常工作，后面再单独部署；
- 这里选择「Yes」，也可以暂不配置选择「No」，后面通过 UI 界面再进行配置；
- 选择「npm」；
- 关于技能，你可以先跳过选择此步骤，或者使用空格键您需要的技能，可多选；
- 这里可以配置备用 API，如果不想配置就都选「No」即可；
- 正在完成最后的启动服务配置，大约 30 秒左右；
- 配置完成，选择「Open the web UI」，打开可视化页面；
- 安装完成，浏览器自动打开 Web UI 界面；
接入飞书机器人
- 首先进入飞书开放平台。登录成功后，点击创建企业自建应用；
- 接着填写应用名称（如 "OpenClaw 助手"）、应用描述，选择应用图标，点击「创建应用」按钮，进入应用管理页面；
- 在添加应用能力中选择「机器人」→ 点击「添加」；
- 在开发配置中点击「权限管理」→「开通权限」；
- 在搜索框内搜索「im:」勾选全部相关权限名称，最后点击「确认开通权限」；
- 点击左侧「云文档」勾选全部相关权限名称，最后点击「确认开通权限」；
- 点击顶部「创建版本」按钮；
- 简单填写相关内容，然后点击「保存」；
- 点击「确认发布」；
- 机器人发布完成，开始配置 OpenClaw
- 为了防止与自带的飞书文件夹冲突，我们直接把之前的先全部删掉，方便后面顺利安装，输入下方代码到终端内，然后回车，输入开机密码执行；
sudo rm -rf ~/.openclaw/extensions/feishu
- 清理完成后，接着下载飞书插件，在终端输入下方代码，然后回车，输入开机密码执行；
openclaw plugins install @m1heng-clawd/feishu
- 正在下载飞书插件，耐心等待即可；
- 出现下面界面表示飞书插件安装成功；
- 在输入下方输入代码，然后回车，输入开机密码执行；
openclaw config
- 选择「Local (this machine)」，然后回车;
- 选择「Channels（渠道）」，然后回车；
- 选择「Configure/link（配置链接）」，然后回车；
- 选择「Feishu/Lark（飞书）」，然后回车；
- 打开飞书开放平台，在「应用凭证」里，复制 AppID 和 AppSecret；
- 在终端对应位置分别输入飞书的 AppID 和 AppSecret；
- 选择「Feishu（feishu.cn）- China」，然后回车；
- 选择「Open - respond in all groups（requires mention）」，然后回车；
- 选择「Finished」然后回车；
- 选择「Yes」，回车；
- 选择「Open...」，回车；
- 选择「Continue」，回车；
- 配置完成，关闭终端；
- 重新打开终端，然后输入下方代码，重启配置；
openclaw gateway
- 打开飞书开放平台，选择「事件与回调」→「订阅方式」→「使用长连接接收事件」→「保存」；
- 然后点击同一页面内的「添加事件」；
- 在弹出的列表中，搜索并添加「接收消息」、「消息已读」、「机器人进群」、「机器人被移出群」，最后点击「确认添加」；
- 添加完成后如下图所示；
- 点击「权限管理」→搜索「通讯录」→选中「获取通讯录基本信息」→「确认开通权限」；
- 配置完成后我们需要重新发布新版本，点击顶部「创建版本」；
- 按如图所示输入；
- 点击「确认发布」；
- 打开手机端「飞书」，搜索机器人的名字，给机器人发消息，如果机器人以 AI 的方式进行回复，那么恭喜你配置成功。
常用命令
openclaw onboard # 重新进入配置向导
openclaw status # 查看运行状态
openclaw health # 健康检查
openclaw gateway start # 启动服务
openclaw gateway stop # 停止服务
openclaw update # 更新到最新版本
openclaw doctor # 诊断问题
openclaw uninstall # 卸载 OpenClaw
技能库
最后再推荐两个 OpenClaw 技能库，它就是给你的 AI 装上一堆「技能插件」，让它从'动嘴皮子'变成'真能干活'。
- 宝藏仓库地址 GitHub 地址：
https://github.com/VoltAgent/awesome-openclaw-skills
里面包含内容众多，可根据自身需求进行安装；
- ClawHub，精英特工的技能平台。
官方网站：https://clawhub.ai/
