小白都能看懂的“养龙虾”教程：OpenClaw保姆级部署（阿里云+Windows/Mac/Linux）+ 免费大模型接入+全场景落地指南-阿里云开发者社区

2026年，AI智能体领域最火的词非“养龙虾”莫属。这里的“龙虾”，不是餐桌上的海鲜，而是开源AI智能体OpenClaw的中文昵称——因图标形似小龙虾得名，更因“能动手、真干活”的核心能力，成为个人与企业追捧的“专属数字员工”。它彻底打破了传统AI“只说不做”的局限，不再是单纯的聊天工具，而是能直接操控电脑、自主完成任务的自动化引擎，核心价值可概括为“语言指令→AI自主规划→自动操作→完成反馈”的全闭环。

对于零基础用户而言，“养龙虾”的核心门槛在于全平台部署、大模型API配置与技能选型。本文基于2026年OpenClaw最新稳定版（v2026.3.8），结合国内用户使用场景，从零拆解全流程：先详解阿里云+本地（Windows11/MacOS/Linux）部署步骤，再配置阿里云百炼Coding Plan免费API激活“智能大脑”，接着落地办公、生活、团队协作等高频场景，最后补充新手避坑指南与常见问题解答，所有代码可直接复制执行，全程保姆级指导，助力用户1-2小时内从“入门”到“精通”，真正拥有24小时在线的“数字员工”。阿里云上OpenClaw极速一键部署最简单，步骤详情访问阿里云OpenClaw一键部署专题页面 了解。

一、核心认知：“养龙虾”到底养的是什么？能做什么？

（一）OpenClaw的本质：不止于聊天的“数字员工”

OpenClaw是一款遵循MIT协议的开源、本地优先AI智能体平台，核心是将大模型的“思考能力”与电脑的“执行能力”深度结合。它的本质不是传统意义上的聊天AI，而是一个能自主拆解任务、调用工具、完成实际操作的“数字员工”，与其他工具的核心差异用一张表格就能清晰区分：

工具类型	核心能力	交互方式	核心价值
OpenClaw（龙虾AI）	直接操控电脑，自动完成全流程任务	自然语言指令，多渠道触发	替代重复劳动，落地执行
传统对话式AI（ChatGPT/千问）	生成文本、方案、代码，不直接执行	被动聊天，需手动落地	提供思路建议，不干活
普通自动化工具（n8n/Zapier）	按预设流程执行单一任务	手动配置，无AI理解	固定流程自动化，灵活度低

简单来说，传统AI是“顾问”，告诉你“怎么做”；OpenClaw是“员工”，直接帮你“做完”——你只需说“整理桌面的PDF文件”，它就会自动新建文件夹、移动文件，全程无需手动干预；你说“搜索2026年AI智能体报告并总结”，它会自动联网抓取、提炼要点，直接反馈结果。

（二）OpenClaw的核心特点：为什么值得“养”？

能动手，不嘴炮：区别于仅输出文本的AI，OpenClaw可操控鼠标、键盘、文件、浏览器，直接完成真实操作，覆盖“办公→生活→协作”全场景；
本地部署，隐私安全：数据、任务执行全在本地设备，不上传云端，敏感信息不泄露，符合个人隐私与企业合规需求；
模块化技能，按需扩展：像装手机App一样，通过ClawHub技能市场安装插件，核心技能覆盖文件管理、信息处理、自动化执行等，无限扩展功能边界；
全平台兼容，门槛极低：支持Windows11、MacOS、Linux，2vCPU+2GiB内存即可起步，零基础用户也能快速上手；
多通道交互，随时随地指挥：通过飞书、钉钉、Telegram等聊天工具，用自然语言发指令，无需打开专用软件，便捷性拉满。

（三）“养龙虾”的核心场景：从个人到团队全覆盖

OpenClaw的能力由技能包拓展，新手装基础技能就能覆盖90%的高频需求，核心场景如下：

1. 办公自动化（职场人必备）

文件管理：自动整理桌面/文件夹、分类邮件、批量重命名文件、格式转换；
报告与纪要：写周报/日报、生成Excel报表、自动整理会议纪要、收发会议通知；
待办与日历：管理日程、设置任务提醒、同步审批进度，避免遗漏重要事项。

2. 信息处理（效率神器）

资料搜集：联网搜索资料、抓取网页数据、监控行业动态；
文档处理：总结长文/论文、翻译文档、提取关键信息、识别PDF文字；
知识管理：搭建本地知识库，智能问答、快速检索，成为“活字典”。

3. 电脑操作（解放双手）

系统维护：清理磁盘垃圾、安装卸载软件、自动化执行重复脚本；
批量操作：批量修改文件格式、批量发送消息/邮件、批量处理数据；
代码辅助：简单代码编写、调试、格式化，提升开发效率。

4. 生活与个性化场景（贴心助手）

价格监控：盯盘选股、监控电商价格，降价自动提醒；
日程管理：预订票务、提醒生日/纪念日、规划出行路线；
个性化服务：定制新闻摘要、生成食谱、辅导学习，适配多样化需求。

5. 团队协作（企业刚需）

对接飞书/钉钉，自动同步工作进度、汇总群消息、分发任务；
共享知识库，团队成员可通过聊天工具快速查询企业资料；
自动化协作流程，减少跨部门沟通成本，提升团队效率。

（四）部署前必做准备（避免踩坑，一次成功）

1. 设备与环境要求

无论是云端还是本地部署，内存是核心硬性要求，低于4GB会导致服务启动失败，各部署方式具体要求如下：

部署方式	最低配置	推荐配置	系统要求	核心依赖
阿里云轻量服务器	2vCPU+2GiB内存+40GiB ESSD	个人：2vCPU+4GiB内存+40GiB ESSD；企业：4vCPU+8GiB内存+80GiB ESSD	Ubuntu 22.04 LTS、Alibaba Cloud Linux 3.2104 LTS	阿里云百炼API密钥、Docker
Windows11本地	4GiB内存+20GiB磁盘空间	8GiB内存+30GiB磁盘空间	Windows11 64位	Node.js≥v22.0.0、Python≥3.9、Git、Docker Desktop
MacOS本地	4GiB内存+20GiB磁盘空间	8GiB内存+30GiB磁盘空间	MacOS 12及以上（M系列/Intel芯片）	Homebrew、Node.js≥v22.0.0、Git、Docker
Linux本地	4GiB内存+20GiB磁盘空间	8GiB内存+30GiB磁盘空间	Ubuntu 22.04+ 64位	curl、Git、Python≥3.9、Node.js≥v22.0.0、Docker

2. 必备凭证与工具

核心凭证：阿里云账号（注册阿里云账号，完成实名认证，用于服务器购买与百炼API开通）、阿里云百炼Coding Plan API Key（格式为sk-sp-xxxxx，新用户可领90天免费额度）及专属Base URL；
辅助工具：SSH远程工具（FinalShell，用于阿里云服务器登录）、系统终端（Windows11：PowerShell管理员模式；MacOS/Linux：原生终端）、文本编辑器（VS Code、记事本、Nano）、加密记事本（存储API Key、Token等敏感凭证）；
可选工具：飞书/钉钉/Telegram账号（多渠道控制用）、Ollama（本地模型部署用）、GitHub账号（自定义技能安装用）。

3. 基础工具安装（全系统通用，必做）

基础工具是部署OpenClaw的前提，所有命令可直接复制执行，避免手动安装出错：

# 1. 安装Node.js（推荐v22+，确保兼容性，避免版本过低导致部署失败）
# Windows11（PowerShell，管理员模式）
winget install OpenJS.NodeJS.LTS --version 22.2.0 -y

# MacOS（终端）
brew install node@22
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Linux/Ubuntu（终端）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 2. 验证Node.js版本（显示v22+即为成功）
node -v

# 3. 安装核心工具（Git、pnpm，技能管理与依赖安装必备）
# Windows11
winget install Git.Git -y
npm install -g pnpm

# MacOS/Linux
brew install git  # MacOS
sudo apt install git -y  # Linux
npm install -g pnpm

# 4. 安装Docker（容器化部署必备，官方推荐，稳定性更强）
# Windows11：下载Docker Desktop并安装，开启“以管理员身份运行”（官网：https://www.docker.com/products/docker-desktop/）
# MacOS
brew install docker --cask
open -a Docker  # 启动Docker

# Linux/Ubuntu
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
sudo systemctl start docker
sudo systemctl enable docker

# 5. 配置npm国内镜像，加速依赖下载（解决国内下载缓慢、超时问题）
npm config set registry https://registry.npmmirror.com
pnpm config set registry https://registry.npmmirror.com

# 6. 验证工具安装（显示版本号即为成功）
git --version && pnpm --version && docker --version

⚠️ 避坑提醒：npm安装完成后，若终端提示“openclaw: command not found”，是因为npm全局安装目录未添加到系统PATH，需手动将路径添加到~/.zshrc（MacOS/Linux）或系统环境变量（Windows11）；MacOS M系列芯片用户，若安装失败，执行arch -arm64 brew install node@22，指定ARM架构安装依赖。

二、2026年OpenClaw全平台部署流程（阿里云+本地）

OpenClaw支持阿里云云端部署与本地部署（Windows11/MacOS/Linux），两种部署方式各有优势，可根据自身需求选择：阿里云部署适合需要7×24小时稳定运行、多设备访问、团队共享的场景；本地部署适合功能测试、数据隐私要求较高的场景，以下为详细步骤，全程保姆级指导，新手可直接照搬。

（一）阿里云部署（长期运行首选，新手易上手）

阿里云为2026版OpenClaw打造了专属一键部署方案，通过预置镜像、简化流程设计，彻底打破技术门槛，无需用户掌握编程技能，同时提供手动部署与Docker部署两种方式，适配不同需求。

方案一：一键脚本部署（新手首选，5分钟完成）

适配阿里云轻量应用服务器特性，脚本自动优化系统配置、安装依赖并启动服务，无需手动干预，新手快速上手。

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

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

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

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

轻量应用服务器OpenClaw镜像.png

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

阿里云百炼密钥管理图.png

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

端口放通：需要放通对应端口的防火墙，单击一键放通即可。
配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

阿里云百炼Coding Plan 配置教程：创建API-Key，推荐访问订阅阿里云百炼Coding Plan，阿里云百炼Coding Plan每天两场抢购活动，从按tokens计费升级为按次收费，可以进一步节省费用！

购买后，在控制台生成API Key。注：这里复制并保存好你的API Key，后面要用。
回到轻量应用服务器-控制台，单击服务器卡片中的实例 ID，进入服务器概览页。
在服务器概览页面单击应用详情页签，进入服务器详情页面。
端口放通在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw 服务运行端口的防火墙。
这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key，直接选择就可以。
获取访问地址单击访问 Web UI 面板下的执行命令，获取 OpenClaw WebUI 的地址。

服务器选购与基础配置：
- 访问阿里云轻量应用服务器控制台，选择“Ubuntu 22.04 LTS”系统镜像；
- 核心配置：2vCPU+4GiB内存+40GiB ESSD+200Mbps带宽，地域优先选择中国香港（免备案）或华东1（杭州），付费类型选“包年包月”；
- 提交订单后，记录服务器公网IP、默认登录账号（root）与密码，在阿里云控制台“安全组”中，一键放行22（SSH远程端口）、18789（OpenClaw核心端口）、443（API调用端口）。
一键部署操作（通过FinalShell远程连接服务器）：

# 1. SSH连接服务器（替换为你的服务器公网IP，按提示输入密码）
ssh root@你的服务器公网IP

# 2. 执行阿里云专属一键部署脚本（国内优化版，自动处理依赖与配置）
curl -fsSL https://openclaw.ai/aliyun-install.sh | bash

# 3. 按向导完成核心配置（新手直接按默认选择，无需修改）
# 关键步骤提示：
# 1. 风险提示：按左方向键选择Yes，回车确认
# 2. 绑定地址：0.0.0.0:18789（默认，支持远程访问）
# 3. 模型选择：暂时选择“Custom Provider”（后续配置阿里云百炼API）
# 4. 通讯平台：选择Skip for now（后续按需添加）
# 5. 技能配置：选择No（后续单独安装核心技能）
# 6. 认证设置：自动生成访问令牌（Token），复制保存好，登录Web控制台需用

# 4. 验证部署与开机自启（确保服务器重启后服务不中断）
systemctl status openclaw  # 显示active(running)即为服务正常
systemctl enable openclaw  # 设置开机自启
curl http://127.0.0.1:18789/api/v1/health  # 返回healthy即为部署成功

远程访问验证：
- 打开浏览器，输入 http://服务器公网IP:18789，粘贴之前保存的访问令牌，能正常进入OpenClaw Web控制台，即为部署成功；
- 控制台可直观查看服务状态、配置技能、发送指令，新手可先熟悉界面布局。

方案二：Docker Compose部署（生产环境首选，稳定隔离）

遵循容器化部署最佳实践，通过Docker Compose实现环境隔离、数据持久化与快速升级，适配企业级生产需求，稳定性更强，适合长期运行。

基础环境配置（SSH远程连接服务器）：

# 1. 登录服务器（替换为你的公网IP）
ssh root@你的服务器公网IP

# 2. 安装Docker与Docker Compose（若已安装可跳过）
sudo apt update && sudo apt upgrade -y
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
sudo apt install docker-compose-plugin -y
sudo systemctl start docker && sudo systemctl enable docker

# 3. 验证Docker安装（显示版本号即为成功）
docker --version && docker compose version

创建配置与启动服务：

# 1. 创建项目目录（用于存储配置、日志与数据，实现持久化）
mkdir -p /opt/openclaw && cd /opt/openclaw

# 2. 编写docker-compose.yml文件（直接复制，无需修改）
cat > docker-compose.yml << EOF
version: "3.8"
services:
  openclaw:
    image: openclaw/openclaw:2026-latest  # 2026最新稳定版镜像
    container_name: openclaw
    ports:
      - "18789:18789"  # 映射核心端口
    volumes:
      - openclaw-data:/root/.openclaw  # 配置与数据持久化
      - /var/log/openclaw:/var/log/openclaw  # 日志持久化
      - /tmp:/tmp  # 挂载临时目录，支持文件操作
    restart: unless-stopped  # 异常自动重启
    command: ["openclaw", "gateway", "run"]
    network_mode: bridge
    environment:
      - TZ=Asia/Shanghai  # 时区设置（避免时间异常）
      - GATEWAY_MODE=remote  # 支持远程访问
      - GATEWAY_BIND=0.0.0.0:18789
volumes:
  openclaw-data:
EOF

# 3. 启动容器（后台运行）
docker compose up -d

# 4. 初始化配置（设置访问令牌，替换为你的高强度密码）
docker compose exec openclaw openclaw config set gateway.auth.token "your-secret-token"

# 5. 查看日志，确认启动成功（无报错即为正常）
docker compose logs -f

安全加固（可选，企业用户必做）：
- 在阿里云控制台“安全组”中，将18789端口访问来源限制为企业内网IP或个人常用IP，避免恶意访问；
- 定期更新Docker镜像，执行docker pull openclaw/openclaw:2026-latest && docker compose restart openclaw，修复安全漏洞。

（二）本地部署（Windows11+MacOS+Linux，隐私优先）

本地部署适合功能测试、数据隐私要求较高的场景，所有数据存储在本地设备，无需依赖云服务器，各系统部署流程略有差异，以下为详细步骤。

1. Windows11本地部署（兼容适配，新手易上手）

系统要求：Windows11 64位、8GB+内存、20GB+可用空间，关闭第三方杀毒软件（避免误删文件）

# 1. 管理员模式打开PowerShell，解决执行策略限制（避免命令无法执行）
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force

# 2. 安装核心依赖（Git、Python，若已安装可跳过）
winget install Git.Git -y
winget install Python.Python.3.10 -y
# Docker需手动下载安装：https://www.docker.com/products/docker-desktop/，安装后启动

# 3. 安装Node.js与pnpm（若已安装可跳过）
winget install OpenJS.NodeJS.LTS --version 22.2.0 -y
npm install -g pnpm

# 4. 克隆OpenClaw仓库（国内镜像加速，避免下载缓慢）
git clone https://gitee.com/openclaw/openclaw.git
cd openclaw

# 5. 安装项目依赖
pnpm install

# 6. 构建并启动服务
pnpm ui:build && pnpm build
node dist/cli.js onboard  # 交互式初始化配置（按默认选择即可）
node dist/cli.js gateway run --bind 0.0.0.0:18789

# 7. 生成访问令牌（登录WebUI用，复制保存）
node dist/cli.js token generate --admin

关键配置与避坑：

将C:\Users\你的用户名\.openclaw添加到Windows Defender排除列表，避免技能文件被误判为病毒；
访问方式：浏览器输入 http://localhost:18789，粘贴令牌登录；
若启动失败，检查18789端口是否被占用，执行netstat -ano | findstr 18789，终止占用进程后重新启动。

2. MacOS本地部署（体验最佳，官方推荐）

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

# 1. 安装Homebrew（国内镜像加速，若已安装可跳过）
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

# 2. 安装核心依赖（Git、Python、Docker）
brew install git python@3.10 node@22 docker --cask
open -a Docker  # 启动Docker，等待启动完成（Docker图标不再跳动）

# 3. 配置Node.js环境变量（避免命令无法识别）
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 4. 安装pnpm
npm install -g pnpm

# 5. 克隆OpenClaw仓库（国内镜像加速）
git clone https://gitee.com/openclaw/openclaw.git
cd openclaw

# 6. 安装项目依赖
pnpm install

# 7. 构建并启动服务（后台运行，不占用终端）
pnpm ui:build && pnpm build
node dist/cli.js onboard
nohup node dist/cli.js gateway run --bind 0.0.0.0:18789 > ~/.openclaw/logs/gateway.log 2>&1 &

# 8. 生成访问令牌（登录WebUI用，复制保存）
node dist/cli.js token generate --admin

M系列芯片避坑：若安装失败，执行arch -arm64 brew install node@22，指定ARM架构安装依赖；若Docker启动失败，检查MacOS系统版本是否符合要求（需MacOS 12+）。

3. Linux本地部署（Ubuntu 22.04 LTS，稳定性强）

系统要求：Ubuntu 22.04 LTS、8GB+内存、20GB+可用空间

# 1. 更新系统依赖（确保系统组件最新，避免依赖冲突）
sudo apt update && sudo apt upgrade -y

# 2. 安装核心工具与依赖
sudo apt install curl git python3-pip -y
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
npm install -g pnpm

# 3. 安装Docker（若已安装可跳过）
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
sudo systemctl start docker && sudo systemctl enable docker

# 4. 配置Swap空间（解决内存不足问题，必做）
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# 5. 克隆OpenClaw仓库（国内镜像加速）
git clone https://gitee.com/openclaw/openclaw.git
cd openclaw

# 6. 安装项目依赖
pnpm install

# 7. 构建并启动服务
pnpm ui:build && pnpm build
node dist/cli.js onboard
node dist/cli.js gateway run --bind 0.0.0.0:18789

# 8. 生成访问令牌（登录WebUI用，复制保存）
node dist/cli.js token generate --admin

访问方式：浏览器输入 http://localhost:18789，粘贴令牌登录；若需远程访问，需放行18789端口，执行sudo ufw allow 18789/tcp && sudo ufw enable。

三、阿里云百炼Coding Plan API配置（核心步骤，免费可用）

OpenClaw本身不具备大模型能力，需对接外部模型才能实现“意图解析、任务规划”的核心功能——简单来说，OpenClaw是“数字员工”的身体，而大模型是“数字员工”的大脑。阿里云百炼Coding Plan凭借免费额度、国内节点稳定性、与OpenClaw的无缝适配，成为普通人与企业的最优选择，新用户可领取90天免费调用额度，完全满足日常使用需求。

（一）API凭证获取步骤（免费，新手必看）

访问登录阿里云百炼大模型服务平台，完成实名认证（个人用户可通过支付宝刷脸即时生效，企业用户需上传资质审核）；
访问订阅阿里云百炼Coding Plan，进入服务订阅页面，选择适合的套餐（新用户可领取90天免费调用额度），完成订阅（RAM子账号需主账号授权）；
订阅完成后，进入百炼控制台“密钥管理”页面，点击“创建API Key”，获取专属API Key（格式为sk-sp-xxxxx，与普通百炼Key格式不同，需单独获取）；
记录专属Base URL：https://coding.dashscope.aliyuncs.com/v1（OpenAI兼容协议，必须使用该地址，否则无法抵扣免费额度）；
保存好API Key与Base URL，建议存储在加密记事本中，避免泄露。

（二）OpenClaw对接百炼Coding Plan API（全环境通用）

配置步骤全平台一致，只需修改配置文件并重启网关，所有命令可直接复制执行：

# 1. 编辑OpenClaw配置文件（不同系统打开方式不同）
# Windows11（PowerShell）
notepad $env:USERPROFILE\.openclaw\openclaw.json

# MacOS/Linux/阿里云
nano ~/.openclaw/openclaw.json

# 2. 添加百炼Coding Plan配置（替换为你的API Key，其他参数无需修改）
{
   
  "models": {
   
    "providers": {
   
      "bailian-coding": {
   
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "apiKey": "你的Coding Plan API Key",  # 替换为你获取的API Key
        "api": "openai-completions",
        "models": [
          {
   
            "id": "qwen3.5-coding",
            "name": "百炼Coding Plan Qwen3.5",
            "contextWindow": 32768,
            "maxTokens": 4096,
            "reasoning": false  // 国内模型必设，否则回复为空，新手必看！
          }
        ]
      }
    },
    "default": "bailian-coding/qwen3.5-coding"  # 设置百炼为默认模型
  },
  "tools": {
   
    "agentCommunication": {
   
      "enabled": true,
      "allowCrossAgent": true
    }
  }
}

# 3. 保存文件后，重启网关使配置生效（不同部署方式重启命令不同）
# 阿里云/Linux（脚本/源码部署）
openclaw gateway restart

# 阿里云/Linux（Docker部署）
docker compose restart openclaw

# MacOS
pkill -f openclaw && nohup node dist/cli.js gateway run --bind 0.0.0.0:18789 > ~/.openclaw/logs/gateway.log 2>&1 &

# Windows11（PowerShell）
Stop-Process -Name node -Force
node dist/cli.js gateway run --bind 0.0.0.0:18789

（三）API配置验证与避坑要点

1. 验证方法（快速确认配置成功）

打开OpenClaw Web控制台，输入自然语言指令：“帮我整理~/Downloads文件夹的文件，按文档、图片、视频分类，删除空文件夹”；
若OpenClaw返回“任务已执行，已创建分类文件夹，共整理XX个文件”，且本地/服务器对应文件夹已完成整理，即为配置成功；
若未返回结果或提示“模型不可用”，需检查配置是否正确，重启网关后再次尝试。

2. 避坑要点（新手必看，解决90%的API配置问题）

凭证混用：Coding Plan API Key前缀为sk-sp-，与普通百炼Key格式不同，混用会导致鉴权失败，提示“API Key无效”；
接口地址错误：必须使用专属Base URL（https://coding.dashscope.aliyuncs.com/v1），使用其他地址会无法抵扣免费额度，提示“额度不足”；
未设置reasoning：国内模型（包括百炼）必须添加"reasoning": false，否则模型无法正常响应，回复为空；
配置不生效：修改配置文件后，必须重启网关（Docker部署需重启容器），否则参数无法加载；
额度不足：若提示“百炼API额度不足”，登录百炼控制台查看剩余额度，领取免费套餐或充值，也可减少上下文长度，降低Token消耗。

四、核心技能安装与实战场景（落地即用）

部署与API配置完成后，需安装核心技能才能解锁OpenClaw的全部能力。新手无需盲目安装，优先选择安装量高、维护频繁的基础技能，先跑通1-2个场景，再逐步扩展。

（一）核心技能安装（全环境通用）

# 1. 安全类技能（必装，保障系统安全）
clawhub install skill-vetter  # 技能安全扫描器，检测第三方技能是否恶意

# 2. 办公自动化类（职场高频）
clawhub install file-manager  # 文件管理技能（整理、分类、格式转换）
clawhub install office-automation  # 办公自动化（生成报表、会议纪要）
clawhub install email-handler  # 邮件处理（分类、发送、回复）

# 3. 信息处理类（效率神器）
clawhub install web-scraper  # 网页抓取（搜集资料、监控数据）
clawhub install document-summarizer  # 文档总结（提炼要点、翻译）
clawhub install web-search  # 联网搜索（实时信息查询）

# 4. 通讯集成类（多渠道控制）
clawhub install feishu-integration  # 飞书集成（手机指挥OpenClaw）
clawhub install dingtalk-integration  # 钉钉集成（团队协作必备）

# 验证技能安装
openclaw skills list

（二）实战场景：让OpenClaw立刻干活

场景1：文件自动整理（最常用，节省手动时间）

# 发送自然语言指令（WebUI/飞书/钉钉直接输入）
“帮我整理~/Downloads文件夹的所有文件，按类型（文档、图片、视频、安装包）创建子文件夹，将对应文件移动到各文件夹，删除空文件夹，整理完成后告诉我结果”

# 执行结果
# 自动生成分类文件夹，返回整理报告，包含各文件夹文件数量与名称；
# 同时可直接查看对应文件夹，确认整理效果，全程无需手动操作。

场景2：办公自动化——会议纪要生成与邮件发送

# 1. 配置邮件账号（替换为你的邮箱信息）
openclaw config set skills.email-handler.smtpHost "smtp.163.com"  # 邮箱SMTP服务器
openclaw config set skills.email-handler.smtpPort 465  # SMTP端口
openclaw config set skills.email-handler.username "你的邮箱账号"
openclaw config set skills.email-handler.password "你的邮箱授权码"

# 2. 发送指令（WebUI/飞书/钉钉）
“将以下会议记录整理为结构化纪要（包含参会人、讨论内容、行动项、截止日期），生成Markdown文件并发送到team@example.com邮箱：
参会人：张三、李四、王五
讨论内容：1. OpenClaw部署进度：完成80% 2. 下周计划：完成测试与上线 3. 问题：服务器资源不足
行动项：张三负责测试（周五前），李四协调服务器（周三前），王五跟进API配置”

# 3. 执行结果
# 自动生成规范的会议纪要，保存到本地指定目录，并发送至目标邮箱，返回邮件发送成功回执。

场景3：信息处理——网页抓取与文档总结

# 发送指令（WebUI/飞书/钉钉）
“帮我抓取某科技网站首页的2026年AI智能体相关新闻，提取标题、链接与核心要点，生成Markdown文档并保存到桌面，同时总结300字核心内容发我”

# 执行结果
# 自动联网抓取新闻，生成结构化文档，同步返回总结内容，无需手动复制粘贴。

场景4：多渠道控制——飞书远程指挥

# 1. 配置飞书凭证（替换为你的飞书App ID与App Secret）
openclaw config set skills.feishu-integration.appId "你的飞书App ID"
openclaw config set skills.feishu-integration.appSecret "你的飞书App Secret"

# 2. 重启网关生效
openclaw gateway restart

# 3. 飞书发送指令
# 在飞书群@OpenClaw机器人，发送“帮我查看服务器当前CPU使用率，生成简易报告”，机器人自动执行并返回结果；
# 也可发送“帮我整理今天的行业资讯，总结3条核心信息”，机器人会自动联网搜索并返回摘要。

五、新手避坑小贴士与常见问题解答

（一）新手避坑小贴士（提前规避问题）

安全第一：首次使用先装skill-vetter安全技能，不随意安装未知第三方技能，避免恶意代码窃取数据；
模型选择：本地模型可完全断网使用，隐私性更强；云端模型（如百炼）响应更快，适合复杂任务，按需选择；
指令技巧：复杂任务拆分成简单指令，避免一次性下达过多要求，提升执行成功率；例如“先整理PDF文件，再生成报告”，而非“整理PDF并生成报告”；
数据备份：定期备份~/.openclaw目录（包含配置、技能、记忆数据），防止设备故障导致数据丢失；
版本更新：官方会持续修复漏洞、优化功能，定期执行openclaw update更新至最新版。

（二）常见问题解答（解决90%的新手问题）

1. 部署类问题

问题1：OpenClaw启动提示“Node.js版本过低”？
- 解决方案：执行node -v验证版本，确保≥22.0.0；Linux/MacOS用sudo npm install -g n && sudo n 22.2.0升级，Windows重新运行Node.js安装命令（winget install OpenJS.NodeJS.LTS --version 22.2.0 -y）；升级后重启网关。
问题2：Web控制台无法访问，提示“无法连接”或“端口超时”？
- 原因：端口被占用、服务未启动、防火墙/安全组未放行端口；
- 解决方案：
  ① 检查18789端口是否被占用（Windows：netstat -ano | findstr 18789；Linux/MacOS：lsof -i:18789），终止占用进程；
  ② 重启网关服务（openclaw gateway restart），确认服务状态为“running”；
  ③ 阿里云部署：检查安全组是否放行18789端口；本地部署：关闭防火墙或添加端口例外；
  ④ 确认网关绑定地址为0.0.0.0:18789，而非127.0.0.1（仅本地可访问）。
问题3：Docker部署后，容器启动失败，日志提示“权限不足”？
- 原因：挂载目录权限不足，Docker无法读写配置与日志文件；
- 解决方案：赋予挂载目录权限，执行sudo chmod -R 775 /opt/openclaw（阿里云/Linux），然后重启容器（docker compose restart openclaw）。
问题4：服务启动后，进程莫名消失，日志无报错？
- 原因：内存不足，未配置Swap空间，被系统OOM Killer终止；
- 解决方案：按部署步骤配置Swap空间（2GB及以上），若服务器/本地设备配置过低，升级至2vCPU+4GiB内存及以上；关闭冗余应用，释放内存。

2. API与模型类问题

问题1：百炼API调用提示“密钥无效”或“鉴权失败”？
- 解决方案：① 逐字符核对API Key，确保为sk-sp-xxxxx前缀格式，与普通百炼Key区分开；② 登录百炼控制台，确认密钥未过期、未被禁用；③ 重新创建密钥并更新配置文件；④ 检查Base URL是否正确，确保与密钥地域一致。
问题2：调用模型时，回复内容为空，无任何反馈？
- 原因：未在模型配置中添加"reasoning": false，国内模型不支持默认的思考模式；
- 解决方案：编辑openclaw.json，在models数组中添加"reasoning": false，重启网关生效；若仍为空，检查API Key是否正确，是否有剩余额度。
问题3：提示“百炼API额度不足”？
- 解决方案：① 登录百炼控制台，查看剩余免费额度，若额度耗尽，领取新的免费套餐或充值；② 减少上下文长度，避免不必要的历史对话携带，降低Token消耗；③ 优先使用轻量模型（如qwen3.5-coding），替代高性能模型；④ 定期清理对话历史，释放Token。

3. 技能与实战类问题

问题1：技能安装提示“依赖缺失”或“安装失败”？
- 解决方案：① 查看技能详情（openclaw skills info 技能名），确认缺失的依赖；② 安装依赖（Python库用pip3 install 依赖名）；③ 国内用户用清华源加速（pip3 install 依赖名 --index-url=https://pypi.tuna.tsinghua.edu.cn/simple）；④ 验证Node.js版本是否兼容。
问题2：飞书/钉钉无法指挥OpenClaw，机器人不响应？
- 解决方案：① 核对飞书/钉钉App ID与App Secret，确保配置正确；② 确保机器人已添加到群聊，且拥有发送消息的权限；③ 查看技能日志（openclaw skills logs feishu），排查报错；④ 重启网关，重新配置技能。
问题3：执行任务时，提示“权限不足，无法访问文件/文件夹”？
- 原因：OpenClaw运行账号无对应文件/文件夹的访问权限；
- 解决方案：① 赋予文件/文件夹权限（Linux/MacOS：chmod -R 775 文件夹路径）；② 以管理员身份运行OpenClaw（Windows：PowerShell管理员模式；Linux：sudo命令）。

六、总结

“养龙虾”的核心价值，是让OpenClaw成为24小时待命的“数字员工”，替你完成重复、繁琐的工作，让你聚焦更有价值的核心任务。2026年的OpenClaw已彻底降低门槛，通过阿里云+本地全平台部署、百炼免费API配置、模块化技能安装，零基础用户也能快速上手，无论是个人办公、生活服务，还是企业团队协作，都能大幅提升效率。

本文整合的2026年最新全流程指南，覆盖了OpenClaw的核心认知、全平台部署、百炼API配置、实战场景与常见问题解答，所有代码可直接复制执行，全程保姆级指导，新手可按自身需求选择部署方式，从简单场景入手，逐步扩展功能。

核心要点总结，帮助你快速掌握关键信息：

定位清晰：OpenClaw是“任务执行者”，不是“聊天工具”，聚焦流程化、重复性任务，避开复杂决策与人际沟通类工作；
部署选择：个人测试选本地部署（隐私优先），长期运行/团队共享选阿里云部署（稳定优先），企业生产环境优先Docker容器部署；
配置关键：Node.js版本≥22.0.0，百炼API需正确配置凭证与Base URL，国内模型必须添加reasoning: false，修改配置后需重启网关；
技能选择：新手优先安装安全、文件管理、办公自动化、信息处理类核心技能，覆盖90%高频场景；
避坑核心：安全第一（慎用第三方技能）、指令简化（复杂任务拆分）、定期备份（防止数据丢失）、及时更新（修复漏洞）。

通过本文的教程，你可轻松“养熟”OpenClaw，让这个“数字员工”成为你工作与生活的得力助手，真正实现“解放双手，效率倍增”。

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

小白都能看懂的“养龙虾”教程：OpenClaw保姆级部署（阿里云+Windows/Mac/Linux）+ 免费大模型接入+全场景落地指南