新手零门槛上手：OpenClaw(Clawdbot)阿里云/本地部署（MacOS/Linux/Windows11）+百炼API+Slack快速接入攻略-阿里云开发者社区

OpenClaw（前身为Clawdbot、Moltbot）作为一款开源AI代理与自动化工具框架，凭借“自然语言驱动、零代码操作、多平台适配、可扩展技能”的核心优势，成为2026年零基础用户入门AI自动化工具的首选。其核心价值在于无需掌握专业编程技能，仅通过口语化指令，即可完成文档处理、跨工具协同、数据统计、任务自动化等各类重复性工作，同时支持快速接入Slack等第三方协作工具，进一步拓展使用场景，适配个人办公、轻量团队协作等多种需求。

但零基础用户在部署与使用过程中，往往面临诸多难题：阿里云部署流程不熟悉、本地部署依赖缺失、阿里云百炼API配置混乱、Slack接入失败，甚至因操作不当导致服务启动异常、免费额度浪费。本文基于提示参考文章核心逻辑，结合2026年阿里云官方最新实操规范、OpenClaw社区踩坑经验及全网搜索资料，详细拆解2026年新手零基础OpenClaw(Clawdbot)全平台部署流程（阿里云极速部署+MacOS/Linux/Windows本地部署），补充阿里云百炼免费大模型API配置步骤、Slack快速接入方法，梳理全流程避坑要点，所有代码命令可直接复制执行，助力零基础、零技术用户快速完成部署与配置，轻松解锁AI自动化与跨平台协作能力。阿里云上OpenClaw极速一键部署最简单，步骤详情访问阿里云OpenClaw一键部署专题页面 了解。

一、核心认知：部署与接入前必懂的5个关键要点

（一）OpenClaw(Clawdbot)核心定位与运行逻辑

OpenClaw前身为Clawdbot、Moltbot，历经多版本迭代后统一命名，本质是一款开源AI任务执行框架，自身不具备独立的大语言模型推理能力，需对接阿里云百炼等大模型平台，通过API授权调用通义千问系列模型，才能实现自然语言理解与任务执行的协同，其运行逻辑可简化为“三步闭环”：搭建运行载体（阿里云服务器或本地设备）→ 配置大模型API（解锁智能推理能力）→ 接入第三方工具（如Slack，拓展使用场景），三者协同发力，才能充分发挥OpenClaw的核心价值。

截至2026年3月，OpenClaw已更新至v2026.1.30版本，优化了阿里云部署适配性、本地多系统兼容性，同时完善了Slack接入逻辑，支持Socket模式与HTTP模式双接入方式，大幅降低了零基础用户的部署与接入门槛，最快可实现5分钟极速部署、10分钟完成Slack接入。

（二）部署方案选型对比（零基础适配版）

2026年OpenClaw部署主要分为阿里云极速部署与本地部署两种方式，零基础用户可根据自身使用需求、设备条件选择，无需追求高配置，贴合使用场景即可。结合参考资料与2026年最新适配情况，具体对比如下，清晰区分优势与适用场景，方便新手快速选型：

部署方案	核心优势	适用场景	配置要求	维护成本	适配性
阿里云极速部署	零本地配置、官方预置镜像、15分钟内完成部署、7×24小时不间断运行、多设备访问、网络稳定，无需担心本地设备关机断网，适配Slack接入	长期使用、团队协作、定时自动化任务、需要跨设备访问、快速接入Slack	最低2vCPU+2GiB内存+40GiB ESSD，个人使用足够，多技能并发可升级至4vCPU+4GiB内存	极低（阿里云自带运维支持，可一键备份/重置，Web终端可直接操作，无需手动维护环境）	支持所有OpenClaw技能，完美适配Slack接入，无网络限制
本地部署（MacOS/Linux/Windows）	零服务器费用、数据隐私可控、操作便捷、快速验证功能，适合短期测试	短期测试、个人轻量使用、隐私敏感场景，无需7×24小时运行	设备内存≥4GiB，需安装Node.js 22.x及以上版本、Git等基础依赖，预留10GB以上存储空间	中（需自行处理依赖冲突、版本升级与端口占用问题，部分复杂技能适配较差）	支持轻量办公、写作类Skills，可接入Slack，复杂DevOps类技能适配有限

（三）前置准备（全平台通用，避免部署中断）

无论选择哪种部署方案，零基础用户需提前完成以下5项基础准备，重点做好核心凭证的保存，避免后续操作卡顿、报错，所有准备工作均简单易懂，无需专业技术储备：

账号准备：注册阿里云账号 并完成实名认证（个人用户支付宝刷脸验证，即时通过；企业用户需上传资质，审核1-3个工作日），未实名认证无法购买阿里云服务器、开通百炼服务及获取API密钥，这是部署与API配置的前提条件。
工具准备：远程连接工具（FinalShell、Xshell，用于阿里云服务器进阶配置）、文本编辑器（记录公网IP、API密钥、Slack Token等敏感信息）、Chrome/Edge浏览器（访问控制台、阿里云百炼平台及Slack官网），本地部署需额外准备Git（部分Skills安装与Slack接入必需）。
环境准备：阿里云部署无需手动配置环境（官方提供OpenClaw专属预置镜像，已集成所有依赖）；本地部署需提前确认设备内存≥4GiB，预留10GB以上存储空间，Windows用户需开启WSL2（部分依赖与技能适配需要），MacOS/Linux用户无需额外配置系统环境。
凭证准备：访问登录阿里云百炼大模型服务平台，创建并保存API-Key（仅创建时可完整查看，后续无法找回），新用户可领取90天免费模型调用额度，足够前期测试与日常使用，超出额度或期限将产生费用，建议开启消费限额功能避免超额计费；提前注册Slack账号，创建工作区（用于后续接入OpenClaw）。
认知准备：明确OpenClaw运行依赖Node.js（22.x及以上版本），阿里云百炼API是解锁智能推理的核心，Slack接入需获取App Token与Bot Token，三者缺一不可；同时了解OpenClaw核心概念，如Gateway（核心服务进程）、Skill（功能扩展模块）、Workspace（工作目录），避免因认知模糊导致操作失误。

（四）Slack接入核心认知（必懂，避免接入失败）

Slack作为主流协作工具，与OpenClaw对接后，可实现“自然语言指令+协作场景”的深度融合，用户可直接在Slack聊天框中发送指令，让OpenClaw完成任务并返回结果，无需切换平台。2026年OpenClaw支持Socket模式与HTTP模式两种接入方式，零基础用户优先选择Socket模式（操作简单、无需配置公网回调地址），进阶用户可选择HTTP模式（支持自定义配置，适配复杂协作场景）。

Slack接入的核心是获取App Token与Bot Token，这两个凭证是OpenClaw与Slack建立连接的关键，需妥善保存，避免泄露；同时需订阅必要的Bot事件，确保OpenClaw能正常接收、响应Slack中的指令，否则会出现接入后无法使用的问题。

（五）Skills核心认知（补充，提升使用价值）

Skills是OpenClaw的功能扩展载体，本质是为特定任务设计的模块化插件，截至2026年3月，Awesome OpenClaw Skills仓库已收录数千款技能，覆盖办公、开发、调研、文案等30余个分类，无需手动编写脚本，按需加载、即用即走。零基础用户部署完成后，可优先安装高频基础技能，进一步提升自动化效率，且所有技能均支持在Slack中直接调用，适配协作场景需求。

二、2026新手零基础阿里云极速部署流程（零技术首选，15分钟搞定）

阿里云针对OpenClaw推出2026专属“极速部署”方案，提供官方预置镜像，已预装Node.js、Docker、OpenClaw核心程序、所有依赖及Slack接入所需组件，无需手动配置环境、编写复杂命令，全程可视化操作+简单命令，零基础用户15分钟内可完成部署，重点注意端口放行、API配置与Slack接入步骤。

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

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

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

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

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

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

（一）步骤1：阿里云服务器实例创建与配置（极速部署核心）

访问阿里云轻量应用服务器控制台，点击“创建实例”，按以下零基础适配配置选择（无需修改，直接套用，降低配置复杂度，避免操作失误）：
- 地域选择：优先选择中国香港、新加坡、美国弗吉尼亚（免ICP备案，购买后可直接使用，无国内网络限制，支持Slack正常接入与联网技能调用）；国内用户若选择华东1（杭州）、华北2（北京）等国内地域，需完成ICP备案后才能正常访问，且Slack接入可能受网络限制，不推荐零基础用户选择。
- 镜像选择：切换至“应用镜像”，搜索并选择“OpenClaw（Clawdbot）专属镜像”（2026年默认版本为v2026.1.25，基于Alibaba Cloud Linux 3.2104 LTS 64位系统，已预装Node.js 22、Docker 20.10.x、OpenClaw核心程序及Slack接入组件，无需手动安装任何依赖）。
- 实例规格：新手首选2vCPU+2GiB内存+40GiB ESSD+3Mbps带宽（个人使用足够，多技能并发、团队协作可升级至4vCPU+4GiB内存）。
- 付费类型：按需付费（短期测试，按小时计费，适合新手测试部署与Slack接入）或包年包月（长期使用，性价比更高）。
- 登录密码：设置强密码（含大小写字母+数字+特殊符号），妥善保存，用于后续远程连接服务器。
确认订单并支付，等待1-3分钟，实例状态变为“运行中”，记录服务器公网IP（如47.xx.xx.xx），后续访问控制台、配置API、Slack接入均需用到，建议截图或记录在文本编辑器中，避免遗忘。

（二）步骤2：服务器连接与基础环境验证（必做，避免后续报错）

两种连接方式（零基础用户优先选择Web终端，无需安装额外工具，操作更简单）：
- 方式1：Web终端连接（新手首选）：进入服务器实例详情页，点击“远程连接”→“Web终端”，输入创建实例时设置的登录密码，即可进入终端界面，无需额外配置。
- 方式2：本地SSH工具连接（进阶用户）：打开FinalShell/Xshell，输入服务器公网IP、用户名（默认root）、密码，点击连接，成功后进入终端界面，适合后续进阶配置。

基础环境验证（必做，确认依赖与服务正常，直接复制以下命令执行，无需修改）：

# 查看系统内核版本（正常输出为5.10.x-aliyun.x86_64）
uname -r
# 查看Docker版本（正常输出为20.10.x+）
docker -v
# 查看Node.js版本（正常输出为v22.x.x，OpenClaw 2026最优适配版本）
node --version
# 查看OpenClaw服务状态（正常输出为active(running)，说明服务已自动启动）
systemctl status openclaw
# 查看Slack接入组件状态（正常输出为active(running)，确保后续接入正常）
systemctl status openclaw-slack

若OpenClaw或Slack接入组件状态显示“inactive”，执行以下命令启动服务，并设置开机自启（避免服务器重启后服务中断）：

# 启动OpenClaw核心服务
systemctl start openclaw
# 启动Slack接入组件
systemctl start openclaw-slack
# 设置开机自启
systemctl enable openclaw
systemctl enable openclaw-slack

（三）步骤3：端口放行（关键步骤，新手必做，否则无法访问与接入）

端口未放行会导致无法访问OpenClaw控制台、API调用失败、Slack接入无响应，这是零基础用户最易踩坑的环节，操作如下（两种方式可选，新手优先图形化操作，零命令）：

1. 图形化操作（新手首选，零命令）

进入服务器实例详情页，点击左侧“防火墙”→“添加规则”，依次放行以下4个核心端口，授权对象按要求设置，提升安全性，避免全网访问导致的安全风险：

22端口（远程连接专用）：协议选择TCP，授权对象填写“个人IP地址”（仅允许自己的设备连接，降低安全风险）；
18789端口（OpenClaw控制台与服务通信专用）：协议选择TCP，授权对象填写“个人IP地址”；
443端口（API通信专用）：协议选择TCP，授权对象填写“0.0.0.0/0”（确保阿里云百炼API正常调用，无地域限制）；
3000端口（Slack接入专用，Socket模式与HTTP模式均需用到）：协议选择TCP，授权对象填写“0.0.0.0/0”（确保与Slack服务器正常通信）；
保存规则后，刷新页面，确认所有端口状态为“已放行”，否则后续无法正常操作。

2. 命令行操作（进阶用户，快速放行）

在服务器终端执行以下命令，一键放行核心端口，适用于熟悉Linux命令的用户，直接复制执行即可：

# 放行核心端口（22远程连接、18789控制台、443 API、3000 Slack接入）
firewall-cmd --add-port=22/tcp --permanent
firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --add-port=443/tcp --permanent
firewall-cmd --add-port=3000/tcp --permanent
# 重启防火墙，使端口配置生效
firewall-cmd --reload
# 验证端口放行状态（输出4个端口即为成功）
firewall-cmd --list-ports | grep -E "22|18789|443|3000"

（四）步骤4：阿里云百炼免费API配置（图形化+命令行双模式，新手首选图形化）

OpenClaw需配置阿里云百炼API才能实现智能推理，零基础用户优先选择图形化模式，操作简单、零命令；进阶用户可选择命令行模式，支持自定义模型参数（如temperature、maxTokens），两种方式均详细拆解，新手可按需选择。

1. 图形化模式（新手首选，零命令）

访问阿里云百炼大模型控制台（https://dashscope.aliyuncs.com/），使用部署OpenClaw的同一阿里云账号登录；
进入“密钥管理”页面，点击“创建API-Key”，系统自动生成一组API-Key（含Access Key ID与Access Key Secret），点击“复制”将两组密钥保存至文本编辑器（仅显示一次，立即保存，避免丢失，后续无法找回）；
打开浏览器，输入http://服务器公网IP:18789，进入OpenClaw控制台（无需登录，直接访问）；
在控制台左侧导航栏找到“配置中心”→“大模型配置”，切换至“阿里云百炼”标签页，粘贴已复制的Access Key ID与Access Key Secret；
选择默认大模型（推荐通义千问3.5 Turbo，免费额度充足，适配所有技能与Slack接入场景），点击“测试连接”，提示“百炼API连接成功”即完成配置；
点击“保存配置”→“重启服务”，使API配置生效（重启耗时约30秒，期间页面可能短暂无法访问，耐心等待即可）。

2. 命令行模式（进阶用户，自定义配置）

若需自定义模型参数（如严谨场景temperature设0.6-0.7，创意场景设0.8-0.9），可在服务器终端执行以下命令（直接复制执行，替换为你的实际API-Key）：

# 1. 进入OpenClaw配置目录
cd ~/.openclaw
# 2. 编辑配置文件（nano编辑器，新手可直接复制内容替换）
nano config.json
# 3. 粘贴以下内容（替换为你的百炼API-Key，按Ctrl+O保存，Ctrl+X退出）
{
   
  "model": {
   
    "provider": "bailian",
    "apiKey": "你的百炼API-Key",
    "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", // 华北2（北京）地域，其他地域需对应修改
    "defaultModel": "bailian/qwen3.5-turbo",
    "parameters": {
   
      "temperature": 0.7,
      "maxTokens": 2048
    }
  },
  "skills": {
   
    "autoLoad": true
  },
  "channels": {
   
    "slack": {
   
      "enabled": false // 暂不开启，后续单独配置Slack
    }
  }
}
# 4. 重启OpenClaw服务，使配置生效
systemctl restart openclaw
# 5. 验证配置（查看API-Key是否配置成功，输出你的API-Key即为成功）
openclaw config get models.providers.bailian.apiKey
# 6. 测试大模型调用（发送测试指令，确认正常响应）
openclaw chat "介绍一下你自己，说明你的核心功能"

说明：不同地域的baseUrl需对应修改，新加坡地域为https://dashscope-intl.aliyuncs.com/compatible-mode/v1，美国弗吉尼亚地域为https://dashscope-us.aliyuncs.com/compatible-mode/v1，配置时需确保baseUrl与API-Key归属于同一地域，否则会导致连接失败。

（五）步骤5：Slack快速接入（零基础首选Socket模式，10分钟搞定）

Slack接入分为Socket模式与HTTP模式，零基础用户优先选择Socket模式，无需配置公网回调地址，操作更简单，全程图形化+简单命令，直接按步骤操作即可完成接入。

1. Slack App创建与Token获取（核心步骤）

访问Slack官网（https://slack.com/），登录已注册的Slack账号，进入“Slack App Console”（https://api.slack.com/apps）；
点击“Create New App”，选择“From scratch”，输入App名称（如“OpenClaw-Bot”），选择需要接入的Slack工作区，点击“Create App”；
开启Socket模式：在左侧导航栏找到“Socket Mode”，点击“Enable Socket Mode”，按提示确认开启，系统会自动生成App Token（格式为xapp-xxx），点击“Copy”保存至文本编辑器（后续配置需要）；
获取Bot Token：在左侧导航栏找到“OAuth & Permissions”，向下滑动至“Scopes”，添加以下Bot权限（确保OpenClaw能正常接收、响应指令）：
- chat:write（发送消息权限）
- app_mentions:read（接收@提及消息权限）
- channels:history（读取频道历史消息权限）
- groups:history（读取私有频道历史消息权限）
- im:history（读取私聊历史消息权限）
点击“Install to Workspace”，授权后，页面会生成Bot Token（格式为xoxb-xxx），点击“Copy”保存至文本编辑器（与App Token一同保存，避免混淆）；
订阅Bot事件：在左侧导航栏找到“Event Subscriptions”，开启“Enable Events”，在“Bot Events”中添加以下事件（确保OpenClaw能接收Slack中的各类指令）：
- app_mention（@提及事件）
- message.channels（频道消息事件）
- message.groups（私有频道消息事件）
- message.im（私聊消息事件）
- reaction_added（添加表情反应事件）
点击“Save Changes”，完成Slack App配置与Token获取。

2. OpenClaw中配置Slack（Socket模式，零基础首选）

回到阿里云服务器Web终端，执行以下命令，编辑OpenClaw配置文件，添加Slack Token：

# 进入OpenClaw配置目录
cd ~/.openclaw
# 编辑配置文件
nano config.json
# 粘贴以下Slack配置内容（替换为你的App Token与Bot Token，添加在channels字段中）
"channels": {
     
  "slack": {
     
    "enabled": true,
    "mode": "socket", // 选择Socket模式，零基础首选
    "appToken": "你的Slack App Token（xapp-xxx）",
    "botToken": "你的Slack Bot Token（xoxb-xxx）"
  }
}

完整配置文件示例（结合之前的API配置）：

{
     
  "model": {
     
    "provider": "bailian",
    "apiKey": "你的百炼API-Key",
    "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
    "defaultModel": "bailian/qwen3.5-turbo",
    "parameters": {
     
      "temperature": 0.7,
      "maxTokens": 2048
    }
  },
  "skills": {
     
    "autoLoad": true
  },
  "channels": {
     
    "slack": {
     
      "enabled": true,
      "mode": "socket",
      "appToken": "xapp-xxxxxx",
      "botToken": "xoxb-xxxxxx"
    }
  }
}

按Ctrl+O保存，Ctrl+X退出编辑器，执行以下命令重启OpenClaw与Slack接入组件，使配置生效：

# 重启OpenClaw核心服务
systemctl restart openclaw
# 重启Slack接入组件
systemctl restart openclaw-slack
# 查看Slack接入状态（输出“connected”即为接入成功）
openclaw slack status

3. Slack接入验证（必做，确认能正常使用）

打开Slack客户端，进入之前选择的工作区，在频道中@创建的Slack App（如@OpenClaw-Bot），发送测试指令：“介绍一下你自己”；
若Slack App能正常回复，包含“OpenClaw、AI自动化、Slack接入”等内容，说明接入成功；
进一步测试技能调用：发送指令“帮我写一篇100字的工作小结”，若能正常生成小结并返回，说明OpenClaw、百炼API、Slack三者协同正常，阿里云部署与Slack接入全部完成。

4. HTTP模式接入（进阶用户，可选）

若需自定义配置，可选择HTTP模式接入，步骤如下（直接复制命令执行）：

在Slack App Console中，关闭Socket模式，开启“Event Subscriptions”，在“Request URL”中输入http://服务器公网IP:3000/slack/events；
复制Slack App的“Signing Secret”（在“Basic Information”页面），保存至文本编辑器；

编辑OpenClaw配置文件，修改Slack配置：

cd ~/.openclaw
nano config.json

替换Slack配置内容：

"channels": {
     
  "slack": {
     
    "enabled": true,
    "mode": "http",
    "botToken": "你的Slack Bot Token（xoxb-xxx）",
    "signingSecret": "你的Slack Signing Secret",
    "webhookPath": "/slack/events"
  }
}

重启服务，验证接入即可：

systemctl restart openclaw openclaw-slack

（六）步骤6：基础Skills安装（新手入门版，提升使用价值）

集成Skills是解锁OpenClaw实操功能的关键，零基础用户优先安装3个高频基础技能（无需复杂配置，直接可用，且支持在Slack中调用），步骤如下（两种方式可选，均支持一键安装）：

1. 控制台安装（新手首选，图形化操作）

打开OpenClaw控制台（http://服务器公网IP:18789），进入“技能市场”；
搜索以下3个社区高星技能（适配性强、无安全风险，支持Slack调用）：
- file-manager（文件管理，批量重命名、分类、删除）；
- doc-coauthoring（文档协作，结构化撰写报告、文案、工作小结）；
- skill-vetter（安全审计，扫描已安装技能的安全风险，避免恶意技能）；
点击每个技能的“安装”按钮，等待1-2分钟，技能状态变为“已启用”，即完成安装。

2. 命令行安装（进阶用户，快速高效）

在服务器终端直接复制以下命令，一键安装3个高频技能，全流程自动完成，无需手动操作：

# 安装file-manager、doc-coauthoring、skill-vetter技能
npx clawhub@latest install file-manager doc-coauthoring skill-vetter
# 验证技能安装状态（显示3个技能状态均为ready即为成功）
openclaw skills list --status ready
# 若技能状态显示failed，执行以下命令重新安装
npx clawhub@latest uninstall file-manager doc-coauthoring skill-vetter
npx clawhub@latest install file-manager doc-coauthoring skill-vetter

3. 技能实战验证（Slack中调用，必做）

在Slack频道中@OpenClaw-Bot，发送以下指令，测试技能功能：

测试file-manager：“@OpenClaw-Bot 用file-manager整理服务器/home目录下的文件，按文档、图片、其他类型分类”；
测试doc-coauthoring：“@OpenClaw-Bot 用doc-coauthoring写一篇100字的个人工作小结，突出核心工作与成果”；
测试skill-vetter：“@OpenClaw-Bot 用skill-vetter扫描当前已安装的所有技能，排查安全风险”。
若均能正常返回执行结果，说明技能集成成功，且支持Slack调用，阿里云部署全流程完成。

三、2026新手零基础本地部署流程（MacOS/Linux/Windows全覆盖）

本地部署适合短期测试、个人轻量使用，零服务器费用，数据隐私可控，核心难点是依赖安装与版本适配，零基础用户严格按步骤操作，可避免90%的报错。以下流程覆盖主流操作系统，所有命令可直接复制执行，重点注意版本适配、环境变量配置与Slack接入，同时补充阿里云百炼API配置步骤，确保与阿里云部署功能一致。

（一）前置依赖安装（核心：Node.js+Git，全系统通用，必做）

OpenClaw运行依赖Node.js（22.x及以上版本，2026年最优适配）与Git（部分Skills安装与Slack接入必需），不同系统安装步骤如下，零基础用户需严格按系统类型操作，避免版本不兼容导致报错，Windows用户需额外开启WSL2。

1. Windows 10/11系统（管理员模式操作，必看）

开启WSL2（Linux子系统，部分依赖与Slack接入必需）：

# 以管理员身份打开PowerShell，执行命令开启WSL2
wsl --install
# 重启电脑，等待WSL2自动安装完成（默认安装Ubuntu系统）
# 重启后启动Ubuntu，设置用户名和密码，完成初始化

安装Node.js（22.x稳定版，国内镜像加速，避免下载超时）：

# 下载Node.js安装包（国内镜像，速度更快）
iwr -useb https://npmmirror.com/mirrors/node/v22.10.0/node-v22.10.0-x64.msi -OutFile node-install.msi
# 安装Node.js，等待安装完成（默认下一步即可，勾选“Add to PATH”）
Start-Process .\node-install.msi -Wait

安装Git（Skills安装与Slack接入必需，国内镜像加速）：

# 下载Git安装包
iwr -useb https://github.com/git-for-windows/git/releases/download/v2.45.0/Git-2.45.0-64-bit.exe -OutFile git-install.exe
# 安装Git，等待安装完成（默认下一步即可，勾选“添加Git到系统环境变量”）
Start-Process .\git-install.exe -Wait

配置npm国内镜像（解决安装OpenClaw与Skills超时问题，关键步骤）：
```
npm config set registry https://registry.npmmirror.com
```

验证安装（必做，确认版本达标，避免后续报错）：

node --version  # 需显示v22.x.x
npm --version   # 需显示v10.x.x及以上
git --version   # 需显示v2.40.x及以上

解决中文乱码问题（新手常见坑，终端输入中文乱码可执行）：
```
chcp 65001  # 设置终端编码为UTF-8
```

2. MacOS 12+系统

安装Homebrew（已安装可跳过，依赖管理工具，简化后续安装）：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装Node.js、Git并配置国内镜像（避免版本冲突与下载超时）：

# 安装Node.js 22.x与Git（Homebrew自动适配最新稳定版）
brew install node@22 git
# 配置环境变量，避免Node.js版本冲突（适配MacOS zsh终端）
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
# 生效环境变量
source ~/.zshrc
# 配置npm国内镜像，解决安装超时问题
npm config set registry https://registry.npmmirror.com

验证安装（必做，确认版本达标）：

node --version && npm --version && git --version

3. Linux（Ubuntu 20.04+系统）

安装Node.js、Git并配置国内镜像（直接复制执行，无需手动干预）：

# 安装Node.js 22.x（国内源，避免下载超时）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
sudo apt install -y nodejs git
# 配置npm国内镜像
npm config set registry https://registry.npmmirror.com

验证安装（必做，确认版本达标）：

node --version && npm --version && git --version

解决权限问题（避免后续安装OpenClaw与Skills时提示权限不足）：
```
sudo chmod -R 777 /usr/local/lib/node_modules
```

（二）OpenClaw核心安装与初始化（全系统通用）

全局安装OpenClaw（国内汉化版，适配中文指令，零基础首选，全系统通用命令）：

# Windows/MacOS/Linux通用命令，安装最新版国内汉化版
npm install -g @qingchencloud/openclaw-zh@latest

验证安装（必做，确认版本达标，若版本过低需升级）：

openclaw --version  # 需显示2026.x.x及以上版本
# 若版本过低，执行以下命令升级
npm update -g @qingchencloud/openclaw-zh

初始化工作空间（存储配置、Skills与数据，全系统通用）：

# 创建OpenClaw工作目录（用于存储配置、技能与数据，建议放在非系统盘）
mkdir ~/OpenClaw-Workspace && cd ~/OpenClaw-Workspace
# 初始化配置，按提示选择默认值（零基础用户无需修改，直接按回车即可）
openclaw init

启动Gateway服务（OpenClaw核心服务，必做，两种启动方式可选）：

# 方式1：前台启动（测试用，关闭终端后服务停止，适合零基础用户测试）
openclaw gateway start
# 方式2：后台启动（推荐，支持关闭终端后持续运行）
# Windows（PowerShell）：Start-Job -ScriptBlock {openclaw gateway start}
# MacOS/Linux：nohup openclaw gateway start &

访问控制台（验证基础部署成功）：
打开浏览器，输入http://localhost:18789，无需登录直接进入OpenClaw控制台，本地基础部署完成。若无法访问，检查Gateway服务是否启动，或端口是否被占用。

（三）阿里云百炼免费API配置（本地部署通用，与阿里云部署一致）

本地部署配置百炼API与阿里云部署命令行模式一致，步骤如下（直接复制执行，适配所有本地系统）：

进入OpenClaw配置目录（全系统通用）：
```
cd ~/.openclaw
```

编辑配置文件（添加百炼API信息，不同系统编辑方式不同）：

# Windows（PowerShell）：用记事本编辑
notepad config.json
# MacOS/Linux：用nano编辑
nano config.json

粘贴以下内容（替换为你的百炼API-Key，保存退出，注意地域对应的baseUrl）：

{
     
  "model": {
     
    "provider": "bailian",
    "apiKey": "你的百炼API-Key",
    "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", // 华北2（北京）地域，可根据自身地域修改
    "defaultModel": "bailian/qwen3.5-turbo",
    "parameters": {
     
      "temperature": 0.7,
      "maxTokens": 2048
    }
  },
  "skills": {
     
    "autoLoad": true
  },
  "channels": {
     
    "slack": {
     
      "enabled": false // 暂不开启，后续单独配置Slack
    }
  }
}

重启Gateway服务，使API配置生效（全系统通用）：
```
openclaw gateway restart
```
验证配置（必做，确认大模型调用正常）：
```
# 发送测试指令，确认OpenClaw能正常调用百炼大模型
openclaw chat "介绍一下你自己，说明你的核心功能"
```
若返回包含“OpenClaw、技能集成、自动化任务、阿里云百炼”等内容的回复，说明API配置成功；若提示连接失败，检查API-Key是否正确、网络是否通畅，或baseUrl是否与地域匹配。

（四）Slack快速接入（本地部署通用，首选Socket模式）

本地部署Slack接入与阿里云部署步骤基本一致，优先选择Socket模式（无需配置公网回调地址，适合本地环境），步骤如下（全系统通用）：

1. Slack App创建与Token获取（与阿里云部署一致，可复用之前创建的App）

访问Slack官网，登录账号，进入“Slack App Console”，创建App（或复用之前在阿里云部署时创建的App）；
开启Socket模式，获取App Token（xapp-xxx）；
添加Bot权限，获取Bot Token（xoxb-xxx）；
订阅Bot事件，保存配置（具体步骤参考阿里云部署中的Slack App创建部分）。

2. OpenClaw中配置Slack（Socket模式，全系统通用）

进入OpenClaw配置目录，编辑配置文件：

cd ~/.openclaw
# Windows：notepad config.json；MacOS/Linux：nano config.json
nano config.json

粘贴以下Slack配置内容（替换为你的App Token与Bot Token）：

"channels": {
     
  "slack": {
     
    "enabled": true,
    "mode": "socket",
    "appToken": "你的Slack App Token（xapp-xxx）",
    "botToken": "你的Slack Bot Token（xoxb-xxx）"
  }
}

保存退出，重启Gateway服务，使配置生效：

openclaw gateway restart
# 查看Slack接入状态（输出“connected”即为接入成功）
openclaw slack status

3. 接入验证（必做）

打开Slack客户端，进入工作区，@Slack App发送测试指令，若能正常响应，说明Slack接入成功；同时测试技能调用，确认技能能在Slack中正常使用，本地部署与Slack接入完成。

（五）Skills集成（本地部署版，全系统通用）

本地部署支持两种Skills安装方式，零基础用户优先选择命令行安装（简单快捷，避免图形化操作报错），步骤如下（全系统通用）：

安装3个高频基础技能（直接复制执行，全系统通用）：

# 安装文件管理、文档协作、安全审计技能，全流程自动完成
npx clawhub@latest install file-manager doc-coauthoring skill-vetter

验证技能安装状态（必做，确认安装成功）：

openclaw skills list --status ready

若3个技能状态均为“ready”，说明安装成功；若显示“failed”，执行以下命令重新安装（解决网络超时或依赖缺失问题）：

# 先卸载失败的技能
npx clawhub@latest uninstall file-manager doc-coauthoring skill-vetter
# 重新安装
npx clawhub@latest install file-manager doc-coauthoring skill-vetter

技能实战验证（Slack中调用，必做）：
在Slack频道中@OpenClaw-Bot，发送以下指令，测试技能功能：
- 测试file-manager：“@OpenClaw-Bot 用file-manager整理我的桌面文件，按文档、图片、压缩包分类”；
- 测试doc-coauthoring：“@OpenClaw-Bot 用doc-coauthoring写一篇100字的学习小结，突出学习内容与收获”；
- 测试skill-vetter：“@OpenClaw-Bot 用skill-vetter扫描当前已安装的所有技能，排查安全风险，生成扫描报告”。
  若均能正常返回执行结果，说明技能集成成功，本地部署全流程完成。

四、全流程避坑指南（零基础必看，规避90%报错）

结合2026年OpenClaw社区踩坑经验、阿里云官方文档及全网搜索资料，梳理部署、API配置、Slack接入、Skills集成四大环节的常见坑点与解决方案，零基础用户可直接对照排查，避免走弯路，节省部署时间。

（一）部署环节避坑（最易出错，重点关注）

阿里云部署坑点：
- 坑点1：实例创建后无法连接Web终端/SSH → 解决方案：检查实例状态是否为“运行中”，网络带宽是否≥3Mbps，重启实例后重新连接；若SSH连接失败，检查22端口是否放行，或密码是否正确（可在阿里云控制台重置密码）。
- 坑点2：OpenClaw服务状态异常（inactive） → 解决方案：执行systemctl start openclaw启动服务，若启动失败，执行openclaw logs --follow查看日志，排查依赖缺失问题，或重启服务器重试；若Slack接入组件异常，执行systemctl restart openclaw-slack。
- 坑点3：端口放行后仍无法访问控制台 → 解决方案：确认公网IP是否正确，18789端口是否放行，重新生成访问Token（执行openclaw token generate），拼接访问地址http://公网IP:18789/?token=你的Token重试；若仍无法访问，关闭服务器防火墙重试。
- 坑点4：选择国内地域实例，Slack接入失败 → 解决方案：国内地域需完成ICP备案，且Slack接入可能受网络限制，零基础用户优先选择中国香港、新加坡等免备案地域。
本地部署坑点：
- 坑点1：Windows用户未开启WSL2，安装依赖报错 → 解决方案：按步骤开启WSL2，重启电脑后重新安装依赖，确保WSL2正常运行。
- 坑点2：安装OpenClaw提示“git not found” → 解决方案：重新安装Git，重启终端，或手动将Git路径添加到系统环境变量（Windows：右键“此电脑”→属性→高级系统设置→环境变量→Path，添加Git安装路径；MacOS/Linux：执行echo 'export PATH="/usr/local/git/bin:$PATH"' >> ~/.zshrc，生效环境变量）。
- 坑点3：启动Gateway服务提示“EADDRINUSE”（端口被占用） → 解决方案：查找占用18789端口的进程并关闭，命令如下：
```
# Windows（PowerShell）：查找并关闭占用端口的进程
netstat -ano | findstr 18789
taskkill /f /pid 进程ID
# MacOS/Linux：查找并关闭占用端口的进程
lsof -i:18789
kill -9 进程ID
```
- 坑点4：Node.js版本过低（低于22.x） → 解决方案：用nvm管理Node版本，执行以下命令升级（全系统通用）：
```
# 安装nvm（Node.js版本管理工具）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 安装Node.js 22.x并切换
nvm install 22
nvm use 22
```
- 坑点5：启动服务卡在“wake up my friend” → 解决方案：运行openclaw doctor诊断网络与依赖，确保网络通畅，依赖版本达标；若仍无法解决，重新初始化工作空间（openclaw init --force），重启服务。

（二）阿里云百炼API配置避坑

坑点1：API-Key丢失 → 解决方案：重新进入百炼控制台“密钥管理”，创建新的API-Key，替换配置文件中的旧密钥，重启服务（阿里云：systemctl restart openclaw；本地：openclaw gateway restart）。
坑点2：API调用提示“429错误”（额度超限） → 解决方案：用openclaw model quota查看剩余额度，关闭无意义的高频调用，或等待次日额度重置（免费额度每日刷新）；新用户可前往百炼控制台领取免费额度，有效期90天。
坑点3：API连接失败（提示“invalid api key”或“connection timeout”） → 解决方案：① 检查API-Key字符是否完整（避免多输、少输或空格）；② 确认baseUrl与API-Key归属于同一地域；③ 检查网络是否通畅，国内部署无需配置代理；④ 重启服务，重新测试连接。

坑点4：硬编码API-Key导致安全风险 → 解决方案：通过环境变量配置API-Key，避免写入配置文件，命令如下：

# Linux/MacOS/阿里云服务器
export BAILIAN_API_KEY="你的百炼API-Key"
# Windows（PowerShell）
$env:BAILIAN_API_KEY="你的百炼API-Key"

（三）Slack接入避坑（零基础最易出错，重点排查）

坑点1：Slack App Token/Bot Token填写错误，接入失败 → 解决方案：重新复制Token，确认无多输、少输或空格，区分App Token（xapp-xxx）与Bot Token（xoxb-xxx），不要混淆，修改配置后重启服务。
坑点2：未订阅Bot事件，无法接收Slack指令 → 解决方案：重新进入Slack App Console，在“Event Subscriptions”中添加所需Bot事件，保存更改后，重启OpenClaw Slack接入组件。
坑点3：Socket模式开启失败，提示“invalid app token” → 解决方案：检查App Token是否正确，确认Socket模式已在Slack App中开启，若仍失败，重新创建Slack App，获取新的Token。
坑点4：HTTP模式接入，Request URL验证失败 → 解决方案：确认服务器公网IP正确，3000端口已放行，Slack App中的Request URL填写正确（http://公网IP:3000/slack/events），关闭防火墙重试。
坑点5：Slack中@Bot无响应 → 解决方案：检查Slack接入状态（openclaw slack status），确认显示“connected”；检查Bot Token权限是否完整，重启Slack接入组件与OpenClaw服务。

（四）Skills集成避坑

坑点1：技能安装失败（提示“network timeout”） → 解决方案：检查网络通畅性，配置npm国内镜像（npm config set registry https://registry.npmmirror.com），或通过Git克隆方式安装（以skill-vetter为例）：
```
git clone https://github.com/smartchainark/skill-security-audit.git ~/.openclaw/skills/skill-vetter
```
坑点2：技能安装后无法启用（状态为failed） → 解决方案：运行openclaw skills scan扫描技能安全风险，若提示“高风险”，卸载该技能，更换社区高星技能；若提示“依赖缺失”，执行npx clawhub@latest install 技能名称 --force强制安装依赖。
坑点3：多技能冲突（服务卡顿、报错） → 解决方案：避免同时安装过多技能，优先保留5-8个高频技能，定期清理30天未使用的技能，命令如下：
```
# 查看30天未使用的技能
openclaw skills list --unused 30
# 卸载无用技能
npx clawhub@latest uninstall 技能名称
```
坑点4：技能无法在Slack中调用 → 解决方案：检查Slack接入是否成功，技能状态是否为“ready”，重启OpenClaw服务与Slack接入组件，重新测试调用。

（五）通用避坑要点

所有操作优先以管理员模式执行（Windows），避免权限不足导致安装、启动失败；
配置文件修改后，必须重启对应的服务（OpenClaw核心服务、Slack接入组件），否则配置不生效；
定期备份配置文件（~/.openclaw/config.json），避免误操作导致配置丢失；
生产环境使用稳定版OpenClaw，避免追beta版本，减少报错概率；
遇到无法解决的报错，优先运行openclaw logs --follow查看实时日志，或openclaw doctor诊断问题，也可参考OpenClaw官方文档排查故障；
阿里云用户需关注实例额度与欠费情况，避免欠费导致服务中断；本地用户需及时升级依赖与版本，确保与Slack、百炼API适配；
敏感凭证（API-Key、Slack Token）需妥善保存，避免泄露，若怀疑泄露，立即重置凭证并更新配置。

五、实战场景演示（零基础上手，快速提效）

结合2026年零基础用户常见使用场景，演示OpenClaw在阿里云/本地部署后，通过Slack调用技能完成实际任务，所有命令可直接复制执行，帮助用户快速上手，感受AI自动化与跨平台协作的便捷性。

（一）场景1：个人办公（Slack中调用技能，高效处理工作）

安装所需技能（全系统通用）：

npx clawhub@latest install file-manager doc-coauthoring schedule-manager

在Slack中发送指令（@OpenClaw-Bot）：

@OpenClaw-Bot 用file-manager整理我的下载文件夹，按文档、图片、压缩包分类；用doc-coauthoring写一篇月度工作小结，突出核心成果与下月计划；用schedule-manager帮我创建下周工作计划，每天9点提醒我处理核心任务。

执行效果：OpenClaw自动完成文件整理、工作总结撰写、工作计划创建，所有结果实时返回至Slack，无需切换平台，将原本1小时的工作压缩至10分钟，大幅提升办公效率。

（二）场景2：团队协作（Slack中协同完成任务）