OpenClaw(大龙虾AI)保姆级教程！阿里云/Windows11/Mac/Linux部署+免费API配置+飞书联动自动化办公指南

优质文章学习记录

07 Apr 2026 — 21 min read

OpenClaw（曾用名Clawdbot，中文昵称“龙虾AI”）作为2026年最热门的开源AI智能体平台，凭借“本地部署+多工具联动+技能扩展”三大核心优势，成为个人与轻量团队的“AI数字员工”。它能实现本地文件处理、办公软件自动化、多平台消息联动等复杂任务，无需专业编程基础，即可通过自然语言指令解放重复劳动。

但新手在部署过程中常遇各类难题：Windows系统权限不足、Linux环境依赖缺失、Mac芯片适配问题、阿里云服务器配置复杂，以及模型对接、飞书机器人联动等高频报错。本文基于实测经验与官方文档，完整拆解2026年OpenClaw零基础全平台部署流程（阿里云+Windows11+MacOS+Linux），详细讲解阿里云百炼免费API配置步骤，补充飞书机器人联动技巧与全网高频避坑指南，所有代码可直接复制执行，助力新手1-2小时内完成从部署到落地的全流程。阿里云上OpenClaw极速一键部署最简单，步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。

一、核心认知：OpenClaw的价值与部署逻辑

（一）OpenClaw核心定位

OpenClaw是一款开源的AI代理与自动化框架，自身不具备大模型推理能力，需通过对接外部大模型API（如阿里云百炼、GLM）解锁智能功能，核心价值体现在三点：

隐私可控：支持本地部署，数据存储在设备或自建服务器，避免隐私泄露；
多端适配：兼容阿里云、Windows11、MacOS、Linux全平台，满足不同场景需求；
能力扩展：通过ClawHub技能市场的5700+技能，可解锁文件处理、网页总结、办公自动化等全场景功能，还能联动飞书、钉钉等办公软件。

（二）部署场景适配建议

阿里云部署：适合需要7×24小时不间断运行、多设备远程访问的场景，依托云服务器稳定性，避免本地设备关机导致服务中断；
Windows11本地部署：适合办公场景用户，可直接对接本地文件与办公软件，联动飞书实现自动化办公；
MacOS本地部署：苹果生态用户首选，适配M系列与Intel芯片，支持iMessage联动，操作便捷；
Linux本地部署：适合技术爱好者与服务器用户，稳定性强，资源占用低，支持自定义配置。

（三）前置准备（必做，避免部署中断）

1. 账号与凭证准备

阿里云账号：注册阿里云账号，完成实名认证，用于云服务器购买与百炼API开通；
阿里云百炼API密钥：访问登录阿里云百炼大模型服务平台，开通服务后创建Access Key ID和Access Key Secret（保存至加密记事本，仅创建时可完整查看）；
飞书开放平台账号：用于创建企业自建应用，获取App ID与App Secret（联动飞书需用）；
GitHub账号（可选）：用于验证技能源码安全性，避免安装恶意插件。

2. 设备与工具准备

阿里云服务器：推荐Ubuntu 22.04 LTS系统，2vCPU+4GiB内存+40GiB ESSD，满足多技能运行需求；
本地设备：Windows11（64位）、MacOS 12+、Linux（Ubuntu 22.04+），建议内存≥4GB、可用空间≥10GB；
辅助工具：Chrome/Edge浏览器、SSH终端（FinalShell，阿里云部署用）、VS Code（文本编辑）、加密记事本（存储敏感凭证）。

3. 环境前置要求

核心依赖：Node.js≥v22.0.0、Python≥3.9（本地部署需手动安装，阿里云部署可自动适配）；
网络要求：阿里云服务器优先选择中国香港、华东1地域（免备案/低延迟），本地设备确保网络通畅；
权限准备：Windows11需开启管理员权限，MacOS/Linux需具备sudo权限，阿里云账号需拥有服务器管理与安全组配置权限。

二、2026年OpenClaw全平台部署流程（零基础友好）

（一）阿里云部署（长期运行首选）

新手零基础阿里云上部署OpenClaw喂饭级步骤流程

第一步：访问打开阿里云OpenClaw一键部署专题页面，找到并点击【一键购买并部署】。

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

镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
实例：内存必须2GiB及以上。
地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
端口放通：需要放通对应端口的防火墙，单击一键放通即可。
配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。

访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

1. 服务器选购与基础配置

时长：根据自己的需求及预算选择。

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

前往轻量应用服务器控制台
，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。

服务器选购：
- 访问阿里云轻量应用服务器控制台，选择“Ubuntu 22.04 LTS”系统镜像；
- 核心配置：2vCPU+4GiB内存+40GiB ESSD+200Mbps带宽，地域选择中国香港（免备案），付费类型选“包年包月”（长期使用更划算）；
- 提交订单后，等待实例状态变为“运行中”，记录公网IP、登录账号（默认root）与密码。

端口放行与环境准备：
```bash

1. SSH登录服务器（替换为你的公网IP）

ssh root@你的服务器公网IP

2. 一键放行核心端口

sudo apt install ufw -y
sudo ufw allow 22/tcp # SSH连接端口
sudo ufw allow 18789/tcp # OpenClaw核心端口
sudo ufw allow 443/tcp # API调用与飞书联动端口
sudo ufw enable
sudo ufw status # 显示“ALLOW”即为成功

3. 更新系统依赖并安装核心工具

sudo apt update && sudo apt upgrade -y
sudo apt install curl git npm python3-pip docker.io -y

4. 升级Node.js至22.0.0（系统自带版本过低）

sudo npm install -g n && sudo n 22.0.0

5. 配置npm国内镜像，加速安装

npm config set registry https://registry.npmmirror.com

 #### 2. OpenClaw安装与初始化 ```bash # 1. 一键安装OpenClaw（官方脚本，自动适配环境） curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git # 2. 验证安装（显示2026.x.x及以上版本即为成功） openclaw --version # 3. 初始化配置（按提示操作，新手直接回车） openclaw onboard # 交互步骤： # 1. 接受风险提示（输入Yes） # 2. 选择启动模式：QuickStart（快速开始，新手首选） # 3. 选择模型提供商：暂时选择“Custom Provider”（后续配置百炼API） # 4. 认证方式：复制控制台URL，浏览器登录完成授权 # 5. 跳过聊天平台集成（输入Skip for now） # 6. 保留默认端口18789（直接回车） # 4. 生成访问令牌（登录控制台需用，复制保存） openclaw token generate # 5. 查看令牌并保存 cat ~/.openclaw/openclaw.json | grep '"token"' | awk -F'"' '{print $4}' # 6. 设置开机自启，避免重启服务器后服务停止 sudo systemctl enable openclaw sudo systemctl start openclaw

3. 部署验证

浏览器输入 http://服务器公网IP:18789/?token=你的Token，能正常进入对话界面即为部署成功；
命令行验证：curl http://localhost:18789/health，返回{"status":"healthy"}即为正常。

4. 阿里云部署避坑要点

坑1：Node.js版本过低→严格执行升级命令，确保版本≥22.0.0，若升级失败，执行npm cache clean --force后重试；
坑2：端口未放行→18789、22、443三个端口必须放行，否则无法访问控制台与飞书联动；
坑3：内存不足导致服务崩溃→至少选择2GiB内存，运行5个以上技能推荐4GiB，可在阿里云控制台弹性升级；
坑4：npm安装超时→配置国内镜像后重新安装，若仍超时，检查服务器网络是否通畅。

（二）本地部署（Windows11+MacOS+Linux）

1. Windows11部署（办公场景首选）

系统要求：Windows11 64位、4GB+内存（推荐8GB+）、10GB+可用空间

# 1. 以管理员身份打开PowerShell（右键开始菜单选择） # 2. 解决执行策略限制（避免脚本无法运行） Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force # 3. 安装核心依赖（Node.js 22+、Python 3.9） winget install OpenJS.NodeJS.LTS --version 22.2.0 winget install Python.Python.3.9 winget install Git.Git # 4. 配置npm国内镜像，加速OpenClaw安装 npm config set registry https://registry.npmmirror.com # 5. 一键安装OpenClaw（国内用户专用脚本，避免网络卡顿） iwr -useb https://clawd.org.cn/install.ps1 | iex # 6. 验证安装（显示2026.x.x及以上版本即为成功） openclaw --version # 7. 启动配置向导（中文适配版，新手友好） openclaw-cn onboard # 交互步骤： # 1. 接受风险提示（输入Yes） # 2. 选择QuickStart快速模式 # 3. 模型选择暂时跳过（后续配置百炼API） # 4. 完成授权后，自动启动网关服务 # 8. 生成访问令牌 openclaw token generate # 9. 查看令牌（复制用于登录） type %USERPROFILE%\.openclaw\openclaw.json | findstr "token"

关键配置（必做）：

将C:\Users\你的用户名\.openclaw添加到Windows Defender排除列表，避免被误判为病毒；
若出现“权限不足”报错，重新以管理员身份运行PowerShell，执行icacls %USERPROFILE%\.openclaw /grant:r 你的用户名:(F)赋予权限。

访问方式：浏览器输入 http://127.0.0.1:18789/?token=你的Token，能正常进入对话界面即为成功。

2. MacOS部署（苹果生态用户首选）

系统要求：MacOS 12+（M系列/Intel芯片）、8GB+内存、10GB+可用空间

# 1. 打开终端（Cmd + Space输入“Terminal”） # 2. 安装Homebrew（国内用户用镜像加速） /bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)" # 3. 安装核心依赖（Node.js 22、Python 3.9、Git） brew install node@22 [email protected] git # 4. 配置Node.js环境变量（确保全局可调用） echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc source ~/.zshrc # 5. 一键安装OpenClaw（官方脚本，自动适配芯片） curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git # 6. 验证安装（显示版本号即为成功） openclaw --version # 7. 初始化配置（按提示操作） openclaw onboard # 交互步骤： # 1. 接受风险提示（输入Yes） # 2. 选择QuickStart模式 # 3. 暂时跳过模型配置 # 4. 保留默认端口18789 # 8. 启动网关服务（后台运行） nohup openclaw gateway start > ~/.openclaw/logs/gateway.log 2>&1 & # 9. 生成访问令牌 openclaw token generate

M系列芯片避坑：若安装失败，执行arch -arm64 brew install node@22，指定ARM架构安装依赖。

访问方式：浏览器输入 http://localhost:18789/?token=你的Token。

3. Linux部署（Ubuntu/Debian，稳定性强）

系统要求：Ubuntu 22.04+/Debian 11+、4GB+内存、10GB+可用空间

# 1. 更新系统依赖 sudo apt update && sudo apt upgrade -y # 2. 安装核心依赖 sudo apt install curl git npm python3-pip docker.io -y # 3. 升级Node.js至22.0.0 sudo npm install -g n && sudo n 22.0.0 # 4. 配置npm国内镜像 npm config set registry https://registry.npmmirror.com # 5. 一键安装OpenClaw curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git # 6. 验证安装 openclaw --version # 7. 初始化配置 openclaw onboard # 8. 启动服务并设置开机自启 sudo systemctl enable openclaw sudo systemctl start openclaw # 9. 生成访问令牌 openclaw token generate

访问方式：浏览器输入 http://localhost:18789/?token=你的Token。

4. 本地部署通用避坑指南

坑1：权限不足→Windows11以管理员身份运行PowerShell，Mac/Linux执行命令时添加sudo；
坑2：Node.js版本过低→所有系统需确保Node.js≥22.0.0，执行node --version验证；
坑3：端口18789被占用→Windows11执行netstat -ano | findstr "18789"终止占用进程；Mac/Linux执行lsof -i:18789 | xargs kill -9；
坑4：配置向导启动失败→Windows11执行openclaw-cn onboard（中文适配版），其他系统执行openclaw onboard；
坑5：Mac M系列芯片适配失败→用arch命令指定ARM架构安装依赖，避免Rosetta 2转译导致的兼容性问题。

三、阿里云百炼免费API配置（核心步骤，零成本解锁AI能力）

OpenClaw部署完成后，需配置大模型API才能实现自然语言理解与任务执行，阿里云百炼为新用户提供90天免费额度，国内节点低延迟，是新手首选。

（一）API密钥获取步骤

登录阿里云官网，搜索“阿里云百炼”，进入百炼大模型控制台；
点击“开通服务”，阅读并同意协议，新用户自动领取免费额度；
进入“密钥管理”页面，点击“创建Access Key”，完成身份验证后，生成Access Key ID和Access Key Secret；
复制并保存密钥（仅创建时可完整查看Access Key Secret，丢失需重新创建）；
开启“消费限额”（推荐）：进入“费用管理”→“消费限额”，设置每月最大消费额度，避免超额计费。

（二）OpenClaw对接阿里云百炼API（全环境通用）

# 1. 配置百炼API密钥（替换为你的凭证） openclaw config set models.providers.bailian.accessKeyId "你的Access Key ID" openclaw config set models.providers.bailian.accessKeySecret "你的Access Key Secret" # 2. 配置国内接口地址（降低延迟） openclaw config set models.providers.bailian.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1" # 3. 设置默认模型（推荐qwen3.5，免费额度足够使用） openclaw config set models.default "qwen3.5" # 4. 配置超时时间与技能协同优化 openclaw config set models.providers.bailian.timeout 60000 openclaw config set models.providers.bailian.skillCooperation true # 5. 重启服务生效（不同环境重启命令） # 阿里云/Linux sudo systemctl restart openclaw openclaw gateway restart # MacOS pkill -f openclaw && nohup openclaw gateway start > ~/.openclaw/logs/gateway.log 2>&1 & # Windows11（PowerShell） stop-process -name openclaw -force start /b openclaw gateway start > %USERPROFILE%\.openclaw\logs\gateway.log 2>&1

（三）API配置验证

登录OpenClaw控制台，输入测试指令：帮我生成一份2026年3月工作周报模板；
若返回结构化的周报模板，说明API配置成功；
命令行验证：openclaw cli -c "介绍一下你自己"，返回正常回复即为配置无误。

（四）API配置避坑要点

坑1：密钥复制错误→逐字符核对Access Key ID和Secret，避免多余空格或换行；
坑2：接口地址错误→国内部署必须使用https://dashscope.aliyuncs.com/compatible-mode/v1，海外部署需替换为国际版地址；
坑3：免费额度耗尽→登录百炼控制台查看额度使用情况，新用户可领取90天免费额度；
坑4：服务未重启→配置完成后必须重启OpenClaw服务，否则配置不生效；
坑5：模型选择错误→免费额度仅支持qwen3.5等基础模型，选择qwen3-max会提示额度不足。

四、核心拓展：Skills安装与飞书机器人联动

（一）OpenClaw Skills两种安装方法

Skills是OpenClaw的核心能力模块，支持提示词指令安装与手动安装两种方式，适配不同网络环境：

1. 提示词指令安装（网络通畅首选）

直接在OpenClaw控制台发送自然语言指令，系统自动完成下载、验证、安装，高危技能会触发二次确认，示例：

指令：帮我从ClawHub安装summarize（网页总结）和office-automation（办公自动化）两个技能

避坑要点：技能名称需从ClawHub官网查询确认，避免拼写错误导致安装失败。

2. 手动安装（网络受限场景）

# 1. 前往ClawHub官网（https://clawhub.ai/），搜索目标技能（如summarize），下载压缩包 # 2. 解压压缩包至指定目录 # Windows11：C:\Users\你的用户名\.openclaw\workspace\skills\ # MacOS：~/Documents/.openclaw/workspace/skills/ # Linux：~/.openclaw/workspace/skills/ # 3. 重启OpenClaw网关，使技能生效 # Windows11（PowerShell） openclaw gateway restart # MacOS/Linux openclaw gateway restart

验证方法：发送指令“更新技能列表”，或执行clawhub list，查看技能是否已安装。

（二）飞书机器人联动（办公自动化实战）

完成基础部署后，将OpenClaw与飞书机器人绑定，可通过飞书聊天直接指挥AI执行任务，步骤如下：

1. 飞书机器人基础配置

登录飞书开放平台，用企业管理员账号创建“企业自建应用”，填写名称与图标；
在“凭证与基础信息”中记录App ID和App Secret（务必保密）；

权限配置：进入“权限管理”→“批量导入/导出权限”，粘贴以下权限代码，完成开通：

{ "scopes": { "tenant": ["aily:file:read", "aily:file:write", "application:application.self_manage", "bot.menu:write", "contact:contact.base:readonly", "im:chat.access_event.bot_p2p_chat:read", "im:message", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message:send_as_bot"], "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"] } }

2. OpenClaw对接飞书机器人

# 1. 安装飞书技能 clawhub install feishu-integration # 2. 配置飞书凭证（替换为你的App ID和Secret） openclaw config set channels.feishu.appId "你的飞书App ID" openclaw config set channels.feishu.appSecret "你的飞书App Secret" openclaw config set channels.feishu.region "cn" # 3. 重启OpenClaw服务 openclaw gateway restart

3. 飞书应用发布与测试

飞书开放平台中，点击“应用能力”→“机器人”，设置机器人名称并保存；
点击“创建版本”，填写版本号与更新说明，发布后应用状态变为“已发布”；
开启事件订阅：进入“事件与回调”，配置订阅方式，确保飞书能接收OpenClaw反馈；
实战测试：在飞书聊天中@机器人，发送指令“帮我总结最近3封工作邮件的核心内容”，验证联动效果。

4. 飞书联动避坑要点

坑1：权限不足→必须用企业管理员账号创建应用，确保已开通所有必要权限；
坑2：App ID/Secret错误→逐字符核对凭证，避免拼写错误；
坑3：应用未发布→仅“已发布”状态的应用可正常使用，草稿状态无法联动；
坑4：网络不通→阿里云部署需放行443端口，本地部署确保网络能访问飞书开放平台。

五、全网高频报错避坑指南（新手必备）

1. SSH认证失败（提示“Permission denied (publickey)”）

原因：本地Git缺少有效SSH密钥，无法访问GitHub；

解决方案：

# 生成SSH密钥（全环境通用） ssh-keygen -t ed25519 -C "你的邮箱地址" # 复制公钥，添加到GitHub账号SSH密钥列表 cat ~/.ssh/id_ed25519.pub

2. OpenClaw启动失败（提示“port is already in use”）

原因：端口18789被其他程序占用；

解决方案：终止占用进程，或更换端口启动：

# 更换端口启动（全环境通用） openclaw gateway --port 18790

3. 技能安装后无法调用

原因：安装路径错误或未重启服务；
解决方案：确认技能文件夹在.openclaw/workspace/skills/目录下，重启OpenClaw网关。

4. 百炼API调用失败（提示“invalid api key”）

原因：API密钥错误或过期；
解决方案：逐字符核对密钥，若过期，在百炼控制台重新创建并配置。

5. Windows11提示“脚本执行被阻止”

原因：PowerShell执行策略限制；
解决方案：重新执行Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force，允许本地脚本运行。

6. Mac M系列芯片安装失败（提示“Cannot install under Rosetta 2”）

原因：Rosetta 2转译导致兼容性问题；