保姆级教程：Mac本地搭建OpenClaw及阿里云上1分钟部署OpenClaw+飞书集成实战指南-阿里云开发者社区

OpenClaw（曾用名Clawdbot、Moltbot）作为2026年最热门的开源个人AI助手平台，以“自然语言驱动自动化”为核心，支持对接飞书、Telegram等主流通讯工具，可替代人工完成文件操作、日历管理、邮件处理等重复性工作。其模块化架构适配多系统环境，既可以在Mac上本地化部署打造私人助手，也能通过阿里云实现7×24小时稳定运行，完美兼顾隐私性与便捷性。

本文整合Mac本地部署、飞书机器人接入、2026年阿里云快速部署三大核心场景，包含可直接复制的代码命令与避坑指南，全程不含无关平台信息，无论是新手入门还是进阶使用，都能快速落地见效。OpenClaw阿里云上一键极速部署步骤详情访问阿里云OpenClaw一键部署专题页面 了解。

一、核心认知：OpenClaw的核心价值与适用场景

（一）OpenClaw是什么？

OpenClaw是一款开源跨平台AI助手框架，核心定位是“将自然语言指令转化为实际操作”。简单来说，它就像一个可定制的“数字员工”，你可以：

自主选择AI模型（支持Kimi、通义千问、DeepSeek等）；
接入常用通讯工具（飞书、WhatsApp等），随时随地发号施令；
安装技能插件，扩展文档处理、自动化办公、系统控制等功能；
本地私有化部署或云端部署，灵活适配不同需求。

（二）核心优势

跨平台兼容：支持Mac、Windows、Linux系统，Mac用户可享受原生GUI体验；
高度可定制：从模型选择到技能扩展，完全按个人需求配置；
多渠道联动：无需打开单独APP，通过飞书等常用工具即可交互；
轻量化部署：无需复杂环境配置，新手也能在30分钟内完成搭建。

（三）适用场景

个人办公：自动整理文件、发送邮件、管理日程；
团队协作：通过飞书群聊@机器人，快速生成报告、查询信息；
系统控制：在Mac/服务器上通过自然语言执行终端命令；
技能扩展：安装插件实现PDF编辑、语音转文字、智能家居控制等功能。

二、场景一：Mac本地部署OpenClaw（npm安装，稳定首选）

Mac部署推荐使用npm安装方式，版本控制方便、系统侵入性低，适合长期使用。以下步骤适配macOS Sonoma及以上版本，Apple Silicon M1/M2/M3芯片体验更佳。

（一）前置准备

系统要求：macOS Sonoma或更新版本，建议预留至少20GB磁盘空间；
网络环境：流畅的网络（部分依赖需从GitHub下载，必要时需科学上网）；
工具准备：终端（系统自带）、浏览器（用于下载Node.js）。

（二）环境配置：安装Node.js（核心依赖）

OpenClaw基于Node.js运行，需安装24.x版本（LTS长期支持版），推荐使用nvm（Node版本管理器）安装，避免版本冲突：

# 1. 安装nvm（Node版本管理器）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 2. 生效nvm（无需重启终端）
. "$HOME/.nvm/nvm.sh"

# 3. 安装Node.js 24（LTS版本）
nvm install 24

# 4. 设置Node.js 24为默认版本
nvm use 24

# 5. 验证安装结果（显示版本号即成功）
node -v  # 预期输出：v24.13.0及以上
npm -v   # 预期输出：11.6.2及以上

（三）安装OpenClaw（全程复制执行）

# 1. 全局安装OpenClaw（需输入Mac开机密码）
sudo npm install -g openclaw

# 2. 解决Git下载协议问题（避免Permission denied错误）
git config --global url."https://github.com/".insteadOf ssh://git@github.com/

# 3. 重新执行安装（若第一步报错，执行此命令）
sudo npm install -g openclaw

# 4. 验证安装成功（显示版本号即完成）
openclaw --version  # 预期输出：2026.2.x及以上

（四）初始化配置向导（必做）

# 启动OpenClaw初始化向导
openclaw onboard

按终端提示逐步完成以下配置，全程交互式操作，小白也能轻松跟随：

安全提示确认：选择「Yes」（按左方向键←切换，回车确认），表示理解使用风险；
配置模式选择：选择「QuickStart」（快速开始模式），后续可通过命令补充配置；
模型选择与API Key配置：
- 选择「Moonshot AI (Kimi K2.5)」（国内模型，性价比高，支持多模态）；
- 选择「Kimi API key (.cn)」（国内版API，访问更稳定）；
- 前往Kimi开放平台（https://platform.moonshot.cn/console/api-keys）注册账号，创建并复制API Key，粘贴到终端（输入时不可见，粘贴后回车即可）；
- 选择「Keep current (moonshot/kimi-k2.5)」，保持默认模型；
渠道配置：选择「Skip for now」（暂时跳过），后续单独配置飞书；
技能配置：选择「Yes」，然后选择「npm」作为包管理器，技能可暂时不选（后续通过插件安装）；
备用API配置：所有选项均选择「No」，无需额外配置；
完成配置：选择「Open the web UI」，浏览器会自动打开OpenClaw控制台（地址：http://127.0.0.1:18789）。

（五）本地部署验证

在浏览器控制台输入指令「介绍一下你的核心功能」，若AI回复结构化内容，说明本地部署成功；

终端验证：执行以下命令启动TUI交互界面，输入指令测试：

# 启动TUI终端交互
openclaw tui
# 输入测试指令：帮我在桌面创建一个名为OpenClaw_Test的文件夹

检查桌面是否生成目标文件夹，若成功则说明文件操作权限正常。

三、场景二：接入飞书机器人（实现多渠道交互）

本地部署后，通过飞书机器人可实现手机端、电脑端随时随地交互，步骤如下：

（一）飞书开放平台创建应用

访问飞书开放平台（https://open.feishu.cn），登录企业飞书账号；
创建企业自建应用：
- 点击「创建企业自建应用」，输入应用名称（如“OpenClaw AI助手”）、应用描述，上传图标，点击「创建」；
添加机器人能力：
- 左侧导航栏「应用能力」→「添加应用能力」，选择「机器人」→「添加」；
开通核心权限：
- 左侧「权限管理」→「开通权限」，搜索并勾选以下权限（输入关键词快速查找）：
  - 消息与群组相关：所有以「im:」开头的权限（如im:chat、im:message）；
  - 云文档相关：所有以「docs:」「bitable:」开头的权限；
  - 通讯录相关：「contact:contact.base:readonly」（获取通讯录基本信息）；
- 点击「确认开通权限」，所有权限均为免审权限，即时生效；
发布应用（测试版）：
- 左侧「版本管理与发布」→「创建版本」，输入版本号（如1.0.0）、更新说明（如“OpenClaw AI助手初版”）；
- 「可用范围」选择“部分成员”，添加测试成员（如自己的飞书账号）；
- 点击「保存」→「确认发布」，无需审核，即时生效。

（二）OpenClaw配置飞书插件

# 1. 清理旧版飞书插件（避免冲突）
sudo rm -rf ~/.openclaw/extensions/feishu

# 2. 安装飞书插件
openclaw plugins install @m1heng-clawd/feishu

# 3. 启动配置命令
openclaw config

按终端提示完成配置：

运行环境选择：选择「Local (this machine)」；
配置模块选择：选择「Channels（渠道）」；
渠道操作选择：选择「Configure/link（配置链接）」；
渠道选择：选择「Feishu/Lark（飞书）」；
输入飞书应用凭证：
- 回到飞书开放平台，左侧「凭证与基础信息」，复制「App ID」和「App Secret」，依次粘贴到终端；
域名选择：选择「Feishu（feishu.cn）- China」；
群聊策略选择：选择「Open - respond in all groups（requires mention）」（群聊中@机器人即可响应）；
完成配置：选择「Finished」→「Yes」→「Open（public inbound DMs）」→「Continue」，配置自动保存。

（三）飞书事件订阅配置（核心步骤）

飞书开放平台左侧「事件与回调」→「事件配置」；
订阅方式选择「使用长连接接收事件」，点击「保存」；
点击「添加事件」，搜索并勾选以下4个事件：
- 机器人进群v2.0（im.chat.member.bot.added_v1）；
- 机器人被移出群v2.0（im.chat.member.bot.deleted_v1）；
- 消息已读v2.0（im.message.message_read_v1）；
- 接收消息v2.0（im.message.receive_v1）；
点击「确认添加」，完成事件订阅；
重新发布应用：左侧「版本管理与发布」→「创建版本」（版本号2.0.0），更新说明填写“添加事件订阅”，发布后生效。

（四）飞书机器人验证

打开飞书APP，搜索创建的应用名称（如“OpenClaw AI助手”），进入单聊；
发送指令「你用的什么模型？」，若机器人回复「我在用Kimi K2.5 (moonshot/kimi-k2.5)」，说明接入成功；
群聊测试：将机器人拉入飞书群，@机器人发送「帮我生成一份周末出行计划」，验证群聊响应能力。

四、场景三：2026年阿里云OpenClaw(Clawdbot)部署简单步骤

本地部署受设备关机、断网影响，阿里云提供专属镜像与弹性算力，支持7×24小时稳定运行，适合需要持续服务的场景：

（一）部署前准备

阿里云账号：注册并登录阿里云账号，完成个人实名认证（支付宝刷脸即时通过）；
核心凭证：
- 阿里云百炼API Key（访问登录阿里云百炼大模型服务平台→密钥管理→创建并保存，新用户可领取超7000万免费Token）；
- Kimi API Key（与本地部署共用）；
服务器配置规划：
- 实例规格：轻量应用服务器2vCPU+2GiB内存+40GiB ESSD云盘（基础配置，支持5-10人同时使用）；
- 地域选择：优先美国弗吉尼亚、中国香港等免备案地域，无需ICP备案即可公网访问；
- 成本预估：新人专享68元/年起，性价比极高。

（二）详细部署流程

阿里云用户零基础部署OpenClaw步骤喂饭级步骤流程

第一步：访问阿里云OpenClaw一键部署专题页面，找到并点击【一键购买并部署】。
阿里云OpenClaw一键部署专题页面：https://www.aliyun.com/activity/ecs/clawdbot

第二步：选购阿里云轻量应用服务器，配置参考如下：

镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
实例：内存必须2GiB及以上。
地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
时长：根据自己的需求及预算选择。

第三步：访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。
端口放通：需要放通对应端口的防火墙，单击一键放通即可。
配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

Step1：购买阿里云轻量应用服务器

访问阿里云OpenClaw一键部署专题页面，点击「一键购买并部署」；
配置选择：
- 镜像：选择「应用镜像→OpenClaw（原Moltbot）2026版」（预置Node.js、Nginx等所有依赖）；
- 实例规格：默认2vCPU+2GiB内存+40GiB ESSD，无需修改；
- 地域：选择海外免备案地域（如美国弗吉尼亚）；
支付订单后，等待实例状态变为「运行中」，记录服务器公网IP（如47.xx.xx.xx）。

Step2：服务器环境配置

端口放行：
- 进入轻量应用服务器控制台，找到目标实例→「防火墙→添加规则」；
- 放行端口18789（OpenClaw核心端口），协议TCP，来源设为0.0.0.0/0，点击「保存」；

远程登录服务器：

# 替换为服务器公网IP
ssh root@你的服务器公网IP

配置API Key：

# 配置Kimi API Key（替换为你的API Key）
openclaw config set models.providers.moonshot.apiKey "你的Kimi API Key"

# 配置阿里云百炼API（替换为你的AccessKeyID和AccessKeySecret）
openclaw aliyun configure --access-key 你的AccessKeyID --secret-key 你的AccessKeySecret

# 设置默认模型为Kimi K2.5
openclaw config set agents.defaults.model.primary "moonshot/kimi-k2.5"

Step3：启动服务并设置开机自启

# 启动OpenClaw服务
systemctl start openclaw

# 设置开机自启
systemctl enable openclaw

# 验证服务状态（显示active(running)即为正常）
systemctl status openclaw

# 生成管理员访问Token
openclaw token generate --admin

Step4：部署验证

浏览器访问：http://服务器公网IP:18789/?token=生成的管理员Token；
输入指令「帮我分析一下当前市场情绪」，若10秒内返回结构化回复，说明阿里云部署成功。

（三）阿里云部署避坑指南

国内地域备案要求：若选择北京、上海等国内地域，需完成ICP备案后才能公网访问，新手优先选择免备案地域；
权限问题：企业用户需确保子账号拥有「轻量应用服务器管理」「百炼密钥管理」权限，否则无法完成配置；
资源扩容：若出现服务卡顿，可通过阿里云控制台弹性升级实例规格（无需重新部署）；
Token安全：管理员Token仅用于首次登录，登录后建议创建普通用户账号，限制权限。

五、OpenClaw技能扩展与常用命令

（一）技能插件安装（扩展功能）

OpenClaw默认功能有限，通过ClawHub技能市场可安装上千种插件，推荐以下高频实用技能：

# 1. 安装ClawHub技能管理工具
npx clawhub install clawhub

# 2. 安装常用技能（直接复制批量执行）
# 文件管理核心技能
npx clawhub install filesystem-mcp
# PDF编辑（合并、拆分、内容提取）
npx clawhub install nano-pdf
# 飞书文档同步
npx clawhub install feishu-docs
# 语音转文字（基于OpenAI-Whisper）
npx clawhub install openai-whisper
# 日历管理（对接Mac日历）
npx clawhub install calendar
# 终端命令执行（通过自然语言执行终端命令）
npx clawhub install terminal-exec

# 3. 重启服务使技能生效
openclaw gateway restart

（二）常用命令速查

# 启动网关服务
openclaw gateway start

# 停止网关服务
openclaw gateway stop

# 查看运行状态
openclaw status

# 健康检查（排查问题）
openclaw health

# 更新OpenClaw到最新版本
openclaw update

# 诊断问题
openclaw doctor

# 卸载OpenClaw
openclaw uninstall

# 重新进入配置向导
openclaw onboard

六、常见问题排查

（一）Mac本地部署常见问题

安装时提示「Permission denied」：
- 原因：权限不足，未使用sudo命令；
- 解决方案：重新执行安装命令，前缀加上sudo，输入开机密码即可。
初始化向导无法连接Kimi：
- 原因：API Key错误或网络问题；
- 解决方案：重新创建Kimi API Key，确保无空格或拼写错误；检查网络是否能访问GitHub。
飞书机器人无响应：
- 原因：事件订阅未配置或插件未安装成功；
- 解决方案：重新检查飞书事件订阅配置，确保4个核心事件已添加；重新安装飞书插件：openclaw plugins reinstall @m1heng-clawd/feishu。

（二）阿里云部署常见问题

浏览器无法访问控制台：
- 原因：端口未放行或服务未启动；
- 解决方案：重新放行18789端口，执行systemctl start openclaw启动服务。
模型调用失败：
- 原因：API Key错误或网络不通；
- 解决方案：重新配置API Key，执行ping platform.moonshot.cn测试网络连通性。

七、总结

OpenClaw的多场景部署特性，让不同需求的用户都能找到合适的方案：Mac本地部署保障数据隐私，适合个人日常使用；阿里云部署实现7×24小时在线，适配团队协作与持续服务需求；飞书集成则打破了工具壁垒，让AI助手融入日常工作流。

本文详细拆解了从环境配置、模型对接、渠道接入到技能扩展的全流程，所有代码命令均可直接复制执行，新手也能零门槛落地。虽然OpenClaw仍处于Beta阶段，存在部分Bug，但作为AI自动化的雏形，其展现的“自然语言驱动一切”的能力，已经让我们看到了未来智能生活的可能。

随着社区的发展，OpenClaw的技能插件与模型适配会持续丰富。建议定期更新版本、关注官方文档，逐步打造属于自己的专属AI助手。

保姆级教程：Mac本地搭建OpenClaw及阿里云上1分钟部署OpenClaw+飞书集成实战指南

一、核心认知：OpenClaw的核心价值与适用场景

（一）OpenClaw是什么？

（二）核心优势

（三）适用场景

二、场景一：Mac本地部署OpenClaw（npm安装，稳定首选）

（一）前置准备

（二）环境配置：安装Node.js（核心依赖）

（三）安装OpenClaw（全程复制执行）

（四）初始化配置向导（必做）

（五）本地部署验证

三、场景二：接入飞书机器人（实现多渠道交互）

（一）飞书开放平台创建应用

（二）OpenClaw配置飞书插件

（三）飞书事件订阅配置（核心步骤）

（四）飞书机器人验证

四、场景三：2026年阿里云OpenClaw(Clawdbot)部署简单步骤

（一）部署前准备

（二）详细部署流程

阿里云用户零基础部署OpenClaw步骤喂饭级步骤流程

Step1：购买阿里云轻量应用服务器

Step2：服务器环境配置

Step3：启动服务并设置开机自启

Step4：部署验证

（三）阿里云部署避坑指南

五、OpenClaw技能扩展与常用命令

（一）技能插件安装（扩展功能）

（二）常用命令速查

六、常见问题排查

（一）Mac本地部署常见问题

（二）阿里云部署常见问题

七、总结

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

保姆级教程：Mac本地搭建OpenClaw及阿里云上1分钟部署OpenClaw+飞书集成实战指南

一、核心认知：OpenClaw的核心价值与适用场景

（一）OpenClaw是什么？

（二）核心优势

（三）适用场景

二、场景一：Mac本地部署OpenClaw（npm安装，稳定首选）

（一）前置准备

（二）环境配置：安装Node.js（核心依赖）

（三）安装OpenClaw（全程复制执行）

（四）初始化配置向导（必做）

（五）本地部署验证

三、场景二：接入飞书机器人（实现多渠道交互）

（一）飞书开放平台创建应用

（二）OpenClaw配置飞书插件

（三）飞书事件订阅配置（核心步骤）

（四）飞书机器人验证

四、场景三：2026年阿里云OpenClaw(Clawdbot)部署简单步骤

（一）部署前准备

（二）详细部署流程

阿里云用户零基础部署OpenClaw步骤喂饭级步骤流程

Step1：购买阿里云轻量应用服务器

Step2：服务器环境配置

Step3：启动服务并设置开机自启

Step4：部署验证

（三）阿里云部署避坑指南

五、OpenClaw技能扩展与常用命令

（一）技能插件安装（扩展功能）

（二）常用命令速查

六、常见问题排查

（一）Mac本地部署常见问题

（二）阿里云部署常见问题

七、总结

热门文章

最新文章

相关电子书