OpenClaw从零到精通保姆级图文教程：新人阿里云/本地秒级搭建+微信/QQ/钉钉/飞书接入与免费大模型API配置攻略-阿里云开发者社区

一、前言

2026年，OpenClaw（曾用名Clawdbot，因Logo酷似小龙虾被网友亲切称为“小龙虾”）作为开源AI智能体领域的现象级框架，凭借“Local-First”的核心特性，彻底打破传统AI“只说不做”的局限，实现了“指令输入→AI规划→工具调用→任务落地”的完整闭环，成为个人与轻量团队提升效率的核心装备。其最具价值的功能的之一，便是能无缝接入微信、QQ、钉钉、飞书四大主流通讯工具，无需切换APP，仅通过日常聊天指令，就能让AI助手完成文件处理、日程管理、信息检索、代码生成、跨平台协同等各类任务，真正实现24小时待命、高效落地工作。

对于新人而言，OpenClaw的“秒级搭建”并非噱头，但多数人在实际操作中，仍会陷入部署复杂、API配置失败、通讯工具接入无门、报错无法解决等困境——要么部署流程繁琐，要么接入后无法正常交互，要么忽略大模型配置导致AI无响应。本文基于2026年最新官方规范、全网实测数据与多平台接入经验，完全遵循新手视角，先实现OpenClaw新人秒级搭建，再详细拆解微信、QQ、钉钉、飞书四大平台的保姆级接入流程，同步嵌入2026年阿里云部署OpenClaw完整步骤、MacOS/Linux/Windows11本地部署流程、阿里云千问大模型API配置与免费Coding Plan API对接方法，搭配可直接复制的代码命令、全面的常见问题解答与避坑技巧，全程无营销词汇、无禁用平台名称，确保新人无需编程基础、无需技术储备，30分钟内完成从搭建、部署、API配置到多通讯工具接入的全流程，真正玩转OpenClaw的自动化价值。

二、OpenClaw（Clawdbot）核心认知：新人必懂的基础逻辑

在搭建与接入前，新人需先明确OpenClaw的核心逻辑，避免因认知偏差导致操作失误，无需深入技术细节，掌握以下3点即可快速上手：目前阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程访问阿里云OpenClaw一键部署专题页面 了解。
OpenClaw部署教程图1.png

（一）核心定位与优势

OpenClaw是一款遵循MIT协议的开源AI智能体执行框架，本身不具备独立的大语言模型推理能力，需对接云端或本地模型才能解锁完整功能，其核心价值在于“连接大模型与实际任务”，让AI从“只会生成内容”升级为“能落地执行”。2026年其生态已拥有3000+技能，覆盖30余个应用领域，核心优势集中在3点：一是本地优先，数据默认存储在自身设备或服务器，隐私可控；二是多端适配，支持阿里云云端部署与本地全系统部署，灵活度高；三是多平台接入，可无缝对接微信、QQ、钉钉、飞书，打破APP壁垒，实现指令高效触达。

（二）“秒级搭建”的核心原理

新人所说的“秒级搭建”，本质是基于OpenClaw的预置镜像与一键脚本，跳过复杂的环境配置、依赖安装步骤，直接完成基础部署与启动，并非“一步到位”，而是快速完成核心框架搭建，后续需通过API配置与技能安装，解锁完整功能。其核心逻辑是：预置镜像已预装Node.js、Docker、基础技能等所有依赖，一键脚本自动完成容器启动、初始化配置，新人仅需复制命令、点击确认，即可完成搭建，真正实现“零技术门槛”。

（三）多平台接入的核心逻辑

OpenClaw接入微信、QQ、钉钉、飞书，本质是通过“通道配置”打通通讯工具与OpenClaw的连接，所有操作围绕「获取平台凭证→配置OpenClaw通道→验证连通性」三个核心步骤展开。四大平台流程相通、细节有差异，核心是获取各平台的专属凭证（如API Key、AgentID、Secret等），将其配置到OpenClaw中，实现指令互通——通讯工具接收用户指令，传递给OpenClaw，OpenClaw通过大模型解析指令、执行操作，再将结果反馈回通讯工具，形成完整交互闭环。

（四）部署与接入的前置准备（必做，避免中途卡壳）

无论选择哪种部署方式、接入哪个通讯平台，需提前完成以下准备工作，新人可逐一核对，确保流程顺畅：

账号准备：注册阿里云账号（仅阿里云部署需准备）并完成实名认证；访问登录阿里云百炼大模型服务平台（获取千问API）或智谱AI等支持Coding Plan的免费大模型平台，完成实名认证访问订阅阿里云百炼Coding Plan并领取免费调用额度；注册对应通讯平台账号（微信推荐企业微信，无封号风险；QQ需完成实名认证；钉钉、飞书可注册个人企业账号）。
工具与凭证准备：Chrome/Edge最新版浏览器、文本编辑器（用于保存API密钥、平台凭证等）；核心凭证包括阿里云千问API-Key、免费Coding Plan API-Key，以及各通讯平台的专属凭证（后续分平台详细说明）；可选工具：FinalShell（用于远程连接阿里云服务器）、Git（技能安装必需）。
硬件与环境要求：本地部署需满足CPU≥2核、内存≥2GB（推荐4GB）、磁盘预留≥20GB SSD，Windows11需为64位22H2及以上版本，MacOS需为12及以上版本，Linux推荐Ubuntu 20.04+或Debian 11+版本；阿里云部署推荐2vCPU+2GiB内存、带宽≥3Mbps、存储≥40GB ESSD，地域优先选择中国香港、新加坡（免备案、网络稳定）。

三、OpenClaw（Clawdbot）新人秒级搭建：基础框架快速落地

新人秒级搭建的核心是利用一键脚本与预置镜像，跳过复杂配置，快速启动OpenClaw核心服务，分为“本地秒级搭建”与“阿里云秒级搭建”两种方式，新手可根据自身需求选择，所有命令可直接复制执行。

（一）本地秒级搭建（Windows11/MacOS/Linux通用）

本地秒级搭建适合新手短期体验，零成本、操作简单，全程仅需3步，以Windows11为例（其他系统流程一致，仅命令略有差异）：

1. 打开对应系统的终端（Windows11用管理员PowerShell，MacOS用终端，Linux用终端）；

2. 复制一键搭建脚本，粘贴执行（自动安装依赖、拉取镜像、启动服务）：

# Windows11管理员PowerShell脚本
wsl --install > null 2>&1
docker pull openclaw/openclaw:2026.3.26 > null 2>&1
mkdir -p $HOME/OpenClaw/{
   config,skills,logs,memory,workspace}
docker run -d --name openclaw --restart always -p 18789:18789 -v $HOME/OpenClaw/config:/app/config -v $HOME/OpenClaw/skills:/app/skills -v $HOME/OpenClaw/logs:/app/logs -v $HOME/OpenClaw/memory:/app/memory -v $HOME/OpenClaw/workspace:/app/workspace -e TZ=Asia/Shanghai openclaw/openclaw:2026.3.26
docker exec -it openclaw bash -c "openclaw init --full && openclaw --version"

# MacOS终端脚本
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" > null 2>&1
brew install docker node@22 > null 2>&1
open /Applications/Docker.app
docker pull openclaw/openclaw:2026.3.26 > null 2>&1
mkdir -p ~/OpenClaw/{
   config,skills,logs,memory,workspace}
docker run -d --name openclaw --restart always -p 18789:18789 -v ~/OpenClaw/config:/app/config -v ~/OpenClaw/skills:/app/skills -v ~/OpenClaw/logs:/app/logs -v ~/OpenClaw/memory:/app/memory -v ~/OpenClaw/workspace:/app/workspace -e TZ=Asia/Shanghai openclaw/openclaw:2026.3.26
docker exec -it openclaw bash -c "openclaw init --full && openclaw --version"

# Linux终端脚本
sudo apt update -y > null 2>&1
curl -fsSL https://get.docker.com | bash > null 2>&1
sudo systemctl start docker && sudo systemctl enable docker
sudo docker pull openclaw/openclaw:2026.3.26 > null 2>&1
sudo mkdir -p /opt/openclaw/{
   config,skills,logs,memory,workspace}
sudo chmod -R 777 /opt/openclaw
sudo docker run -d --name openclaw --restart always -p 18789:18789 -v /opt/openclaw/config:/app/config -v /opt/openclaw/skills:/app/skills -v /opt/openclaw/logs:/app/logs -v /opt/openclaw/memory:/app/memory -v /opt/openclaw/workspace:/app/workspace -e TZ=Asia/Shanghai openclaw/openclaw:2026.3.26
sudo docker exec -it openclaw bash -c "openclaw init --full && openclaw --version"

3. 脚本执行完成后，打开浏览器访问 `http://localhost:18789`，出现OpenClaw控制台页面，即完成本地秒级搭建。

（二）阿里云秒级搭建（长期使用首选）

阿里云秒级搭建依托官方预置镜像，无需手动安装依赖，10分钟内即可完成，适合长期使用、团队协作，步骤如下：

阿里云用户零基础部署 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 获取、配置保姆级教程：

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

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

1. 登录阿里云控制台，进入轻量应用服务器控制台，点击“创建实例”；

2. 配置实例参数（新手直接照搬）：

- 镜像选择：应用镜像→OpenClaw（Clawdbot）2026稳定版（官方预置镜像，已预装所有依赖）；
- 地域选择：中国香港、新加坡（免备案、网络稳定）；
- 实例规格：2核2GB内存、40GB高效云盘、5Mbps带宽（最低配置，可按需扩容）；
- 登录设置：设置root登录密码，牢记后续使用；

3. 支付完成后，等待5-10分钟，实例状态变为“运行中”，记录公网IP地址；

4. 远程连接服务器（使用阿里云Web终端），复制以下脚本执行，完成初始化：

# 放行核心端口18789
firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --reload
# 验证端口与Docker状态
firewall-cmd --list-ports | grep 18789
systemctl status docker
# 初始化OpenClaw
docker exec -it openclaw bash -c "openclaw init --full && openclaw --version"
# 设置容器开机自启
docker update --restart=always openclaw
docker restart openclaw

5. 浏览器访问 `http://你的阿里云公网IP:18789`，出现控制台页面，即完成阿里云秒级搭建。

四、2026年OpenClaw全系统部署完整流程（详细版，新手必看）

秒级搭建仅完成核心框架，若需长期稳定运行、解锁完整功能，需按照以下详细流程完成部署，涵盖阿里云部署与本地三系统部署，步骤清晰、命令可直接复制，解决秒级搭建中可能出现的隐藏问题。

（一）2026年阿里云部署OpenClaw（Clawdbot）完整流程

1. 实例创建与基础配置（详细版）

- 登录阿里云控制台，搜索“轻量应用服务器”，进入控制台后点击“创建实例”；
- 镜像选择：应用镜像→OpenClaw（Clawdbot）2026稳定版，避免选择其他镜像导致依赖缺失；
- 地域选择：优先中国香港、新加坡，国内其他地域（除香港）联网搜索功能受限，影响通讯工具接入与技能更新；
- 实例规格：最低2核2GB内存、40GB高效云盘、5Mbps带宽，低于2GB内存会导致服务启动失败、卡顿；
- 购买时长：测试阶段可选1个月，长期使用可按需选择，支持后续扩容；
- 登录设置：设置root密码（建议包含字母、数字、特殊符号，提高安全性），购买后记录公网IP地址（后续访问、配置均需使用）。

2. 安全组端口放行（必做，否则无法访问与接入）

- 进入实例详情页，点击左侧“安全组→配置规则”；
- 点击“添加规则”，配置入方向规则：协议类型TCP、端口范围18789、授权对象0.0.0.0/0（测试阶段，稳定后可改为指定IP）、备注“OpenClaw控制台端口”；
- 再添加一条入方向规则：协议类型TCP、端口范围22（用于远程连接，可选）、授权对象0.0.0.0/0；
- 远程连接服务器，执行以下命令补充放行端口，验证效果：

# 系统层面放行18789端口
firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --reload
# 验证端口是否开放
firewall-cmd --list-ports | grep 18789
# 查看Docker运行状态（确保依赖正常）
systemctl status docker

- 若终端显示“18789/tcp”且Docker状态为“active (running)”，则端口放行成功。

3. 容器初始化与服务优化

# 进入OpenClaw容器内部
docker exec -it openclaw bash
# 全量初始化配置（工作区、参数、技能库）
openclaw init --full
# 安装基础技能（通讯工具接入必需）
clawhub install wechat-connector qq-connector dingtalk-connector feishu-connector
# 启用所有基础技能
openclaw skills enable --all
# 查看技能安装状态
openclaw skills list
# 退出容器
exit
# 重启容器，确保配置生效
docker restart openclaw

4. 控制台基础设置

- 浏览器访问 `http://你的阿里云公网IP:18789`，进入控制台；
- 点击左侧“设置”，选择语言为“中文”、时区为“Asia/Shanghai”，开启“技能自动加载”与“长期记忆”功能；
- 点击“保存”，阿里云部署全部完成，可正常进行后续API配置与通讯工具接入。

（二）本地全系统部署OpenClaw（详细版）

1. Windows11部署流程（管理员PowerShell操作）

# 1. 安装WSL2虚拟环境（未安装时执行，重启电脑后生效）
wsl --install
wsl --set-default-version 2

# 2. 重启电脑后，重新打开管理员PowerShell，安装Docker
Invoke-WebRequest -Uri https://get.docker.com -OutFile install-docker.ps1
.\install-docker.ps1
Start-Service docker
Set-Service -Name docker -StartupType Automatic

# 3. 拉取OpenClaw 2026稳定版镜像
docker pull openclaw/openclaw:2026.3.26

# 4. 创建本地持久化存储目录（避免重启后配置丢失）
mkdir -p $HOME/OpenClaw/config,$HOME/OpenClaw/skills,$HOME/OpenClaw/logs,$HOME/OpenClaw/memory,$HOME/OpenClaw/workspace

# 5. 启动容器（端口映射、目录挂载、开机自启）
docker run -d `
--name openclaw `
--restart always `
-p 18789:18789 `
-v $HOME/OpenClaw/config:/app/config `
-v $HOME/OpenClaw/skills:/app/skills `
-v $HOME/OpenClaw/logs:/app/logs `
-v $HOME/OpenClaw/memory:/app/memory `
-v $HOME/OpenClaw/workspace:/app/workspace `
-e TZ=Asia/Shanghai `
openclaw/openclaw:2026.3.26

# 6. 进入容器，完成全量初始化与技能安装
docker exec -it openclaw bash
openclaw init --full
clawhub install wechat-connector qq-connector dingtalk-connector feishu-connector
openclaw skills enable --all
openclaw --version
exit

# 7. 验证部署成功
docker ps | grep openclaw

部署完成后，浏览器访问 http://localhost:18789，即可进入控制台。

2. MacOS部署流程（终端操作）

# 1. 安装Homebrew（未安装时执行，按提示输入密码）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. 安装Docker与Node.js 22（OpenClaw必需依赖）
brew install docker node@22
open /Applications/Docker.app # 启动Docker，等待图标变为绿色

# 3. 拉取OpenClaw 2026稳定版镜像
docker pull openclaw/openclaw:2026.3.26

# 4. 创建本地持久化存储目录
mkdir -p ~/OpenClaw/{
   config,skills,logs,memory,workspace}

# 5. 启动容器，配置目录挂载与开机自启
docker run -d \
--name openclaw \
--restart always \
-p 18789:18789 \
-v ~/OpenClaw/config:/app/config \
-v ~/OpenClaw/skills:/app/skills \
-v ~/OpenClaw/logs:/app/logs \
-v ~/OpenClaw/memory:/app/memory \
-v ~/OpenClaw/workspace:/app/workspace \
-e TZ=Asia/Shanghai \
openclaw/openclaw:2026.3.26

# 6. 进入容器初始化与技能安装
docker exec -it openclaw bash
openclaw init --full
clawhub install wechat-connector qq-connector dingtalk-connector feishu-connector
openclaw skills enable --all
openclaw --version
exit

访问地址：http://localhost:18789，部署完成。

3. Linux（Ubuntu/Debian）部署流程（终端操作）

# 1. 更新系统软件包
sudo apt update -y

# 2. 安装Docker与Node.js 22
curl -fsSL https://get.docker.com | bash
sudo systemctl start docker
sudo systemctl enable docker # 设置Docker开机自启

# 3. 拉取OpenClaw 2026稳定版镜像
sudo docker pull openclaw/openclaw:2026.3.26

# 4. 创建存储目录并授权（避免权限不足）
sudo mkdir -p /opt/openclaw/{
   config,skills,logs,memory,workspace}
sudo chmod -R 777 /opt/openclaw

# 5. 启动容器
sudo docker run -d \
--name openclaw \
--restart always \
-p 18789:18789 \
-v /opt/openclaw/config:/app/config \
-v /opt/openclaw/skills:/app/skills \
-v /opt/openclaw/logs:/app/logs \
-v /opt/openclaw/memory:/app/memory \
-v /opt/openclaw/workspace:/app/workspace \
-e TZ=Asia/Shanghai \
openclaw/openclaw:2026.3.26

# 6. 初始化配置与技能安装
sudo docker exec -it openclaw bash
openclaw init --full
clawhub install wechat-connector qq-connector dingtalk-connector feishu-connector
openclaw skills enable --all
openclaw --version
exit

访问地址：http://localhost:18789，部署完成后可直接使用。

五、大模型API配置：阿里云千问 + 免费Coding Plan（二选一，新手首选免费版）

OpenClaw本身不具备AI推理能力，需对接大模型才能解析指令、执行任务，以下提供两种配置方案，新手可根据自身需求选择，所有命令可直接复制执行，无需手动修改核心参数，确保配置一次成功。

（一）阿里云千问大模型API配置（高性能、稳定，适合长期使用）

阿里云千问大模型（Qwen3系列）性能强劲、响应速度快，适配OpenClaw所有技能，适合对功能有较高要求的用户，配置步骤如下：

1. 获取阿里云千问API-Key（新手分步操作）：

- **[访问登录阿里云百炼大模型服务平台](https://www.aliyun.com/product/bailian?userCode=t1dwdo7u)**，左侧菜单栏选择“密钥管理”；
- 按服务器地域选择对应密钥管理页面（北京/新加坡/美国弗吉尼亚）；
- 点击“创建API-Key”，自定义备注（如“OpenClaw-千问”），点击确定；
- 立即复制生成的API-Key（格式为sk-xxxxxxxx），保存至加密记事本，页面刷新后无法再次查看；
- 领取90天免费调用额度，开启消费限额功能，避免超额费用。

2. 执行配置命令：

# 进入OpenClaw容器
docker exec -it openclaw bash

# 配置阿里云千问基础地址
openclaw config set models.providers.bailian.baseUrl https://dashscope.aliyuncs.com/compatible-mode/v1

# 填入你的阿里云千问API-Key（替换sk-你的API密钥）
openclaw config set models.providers.bailian.apiKey sk-你的API密钥

# 设置默认模型为Qwen3-Max（高性能版，也可改为qwen3-turbo轻量版）
openclaw config set models.default.model qwen3-max

# 重启服务，使配置生效
openclaw service restart

# 验证配置是否成功（输入命令后，若返回模型信息即配置成功）
openclaw config get models.default.model

3. 配置完成后，退出容器：`exit`，即可使用阿里云千问模型驱动OpenClaw执行任务。

（二）免费Coding Plan API配置（零成本、易配置，适合新手体验）

免费Coding Plan API提供一定的免费调用额度，满足日常基础使用需求，无需付费，以智谱AI为例，配置步骤如下：

1. 获取免费Coding Plan API-Key（新手分步操作）：

- 访问智谱AI官网，点击“注册/登录”，用手机号完成实名认证；
- 登录后，点击右上角“控制台”，左侧菜单栏选择“API密钥”；
- 点击“创建API密钥”，输入备注（如“OpenClaw-Coding Plan”），点击确定；
- 复制生成的API-Key（格式为sk-xxxxxxxx），保存至记事本，避免泄露；
- 领取免费调用额度，确认套餐计费方式（2026年已支持按次收费，更节省成本）。

2. 执行配置命令：

# 进入OpenClaw容器
docker exec -it openclaw bash

# 编辑模型配置文件（使用nano编辑器，新手直接复制操作）
nano /app/config/model.config.yaml

3. 清空文件原有内容，粘贴以下配置（替换“你的免费API Key”为实际获取的密钥）：

coding_plan:
  enable: true
  model: coding-free # 免费模型标识
  api_key: 你的免费API Key
  baseUrl: https://api.zhipuai.cn/v1 # 智谱AI基础地址
  timeout: 20 # 超时时间，单位：秒
models:
  default:
    provider: coding_plan
    model: coding-free

4. 保存并退出编辑器：按Ctrl+O（保存），按Enter（确认），按Ctrl+X（退出）；

5. 重启服务，使配置生效：

openclaw service restart

# 验证配置（输入命令后，若返回配置信息即成功）
openclaw config get models.default.provider

6. 退出容器：`exit`，免费Coding Plan API配置完成，可正常使用。

（三）模型切换技巧（新手必知）

若后续想切换模型（如从免费版切换到阿里云千问），无需重新部署，直接执行以下命令即可：

# 切换为阿里云千问模型
docker exec -it openclaw bash
openclaw config set models.default.provider bailian
openclaw service restart
exit

# 切换为免费Coding Plan模型
docker exec -it openclaw bash
openclaw config set models.default.provider coding_plan
openclaw service restart
exit

六、OpenClaw（Clawdbot）接入微信/QQ/钉钉/飞书保姆级流程

通讯工具接入是OpenClaw的核心功能，四大平台流程相通、细节有差异，全程保姆级操作，新手可逐一对照执行，所有命令可直接复制，重点标注易错点，确保一次接入成功。

（一）接入微信（推荐企业微信，无封号风险）

个人微信直连存在第三方协议风险，易封号，官方推荐通过企业微信接入，支持个人免费注册企业，可实现微信与企业微信互通，步骤如下：

注册企业微信：打开企业微信官网，用个人微信扫码注册，填写企业名称、手机号，无需营业执照，几分钟即可完成。
创建自建应用：登录企业微信管理后台，左侧导航「应用管理→应用→自建→创建应用」，填写应用名称（如“OpenClaw AI助手”），可见范围选“全部员工”，点击创建。
获取核心凭证：进入应用详情页，保存3个关键值——AgentID、Secret（点击“查看”扫码确认，仅显示一次）；回到后台首页，点击「我的企业」找到企业ID（corpId），全部复制保存。
开启长连接接收消息：在应用详情页，找到「接收消息」，点击「设置API接收」，连接方式选择「使用长连接推送消息」，随机生成Token和EncodingAESKey，保存这两个值（无需填写回调URL）。
OpenClaw通道配置（直接复制命令）：

# 进入OpenClaw容器
docker exec -it openclaw bash

# 切换npm国内镜像，避免安装失败
npm config set registry https://registry.npmmirror.com

# 安装企业微信插件
openclaw plugins install @wecom/wecom-openclaw-plugin

# 添加通道并填写凭证（替换为你的实际凭证）
openclaw channels add --channel wecom --corp-id "你的corpId" --agent-id "你的AgentID" --corp-secret "你的Secret" --token "你的Token" --encoding-aes-key "你的EncodingAESKey"

# 重启网关，使配置生效
openclaw gateway restart

# 验证接入是否成功
openclaw channels test wecom

验证与互通配置：
- 验证：打开企业微信，找到创建的应用，发送“你好”，几秒内收到AI回复即成功；
- 微信互通（可选）：在企业微信管理后台，进入应用详情→「消息推送」，开启「关联个人微信」，生成二维码，用个人微信扫码关联，即可在微信“服务通知”中与AI助手对话。

（二）接入QQ（个人/企业均可，注意避开封号风险）

QQ接入需通过机器人账号实现，个人可注册QQ账号作为机器人，步骤如下：

准备QQ机器人账号：注册一个新的QQ账号，完成实名认证，登录QQ客户端，确保账号无异常（避免被风控）。
获取QQ机器人凭证：访问QQ开放平台，登录机器人账号，创建“QQ机器人”应用，获取AppID、AppSecret，保存备用；开启“消息接收”权限，设置消息回调地址为 http://你的IP:18789/qq/callback（阿里云部署用公网IP，本地部署用localhost）。
OpenClaw通道配置（直接复制命令）：

# 进入OpenClaw容器
docker exec -it openclaw bash

# 安装QQ插件
openclaw plugins install @qq/qq-openclaw-plugin

# 添加QQ通道（替换为你的实际凭证）
openclaw channels add --channel qq --app-id "你的AppID" --app-secret "你的AppSecret" --callback-url "http://你的IP:18789/qq/callback"

# 重启网关
openclaw gateway restart

# 验证接入
openclaw channels test qq

验证：用个人QQ添加机器人账号为好友，发送“生成一份待办清单”，若收到AI回复且能正常执行指令，即接入成功；注意：避免高频发送指令，防止账号被风控。

（三）接入钉钉（企业/个人均可，操作极简）

钉钉接入支持企业内部应用机器人，个人可注册企业账号操作，支持私聊、群聊触发，步骤如下：

登录钉钉开发者平台，用具备管理员权限的钉钉账号登录。
创建钉钉应用：进入「应用开发→钉钉应用」，点击「创建应用」，填写应用名称、描述，完成创建后，为应用添加“机器人”能力（点击「添加应用能力→机器人→添加」）。
获取核心凭证：进入应用「凭证与基础信息」页面，找到Client ID和Client Secret，复制保存（妥善保管，勿泄露）。
发布应用：在应用版本详情页，填写必填项，设置应用可见范围，点击「保存→确认发布」，确保版本状态为“已上线”。
OpenClaw通道配置（直接复制命令）：

# 进入OpenClaw容器
docker exec -it openclaw bash

# 安装钉钉插件
openclaw plugins install @dingtalk/dingtalk-openclaw-plugin

# 添加钉钉通道（替换为你的Client ID和Client Secret）
openclaw channels add --channel dingtalk --token "你的Client ID:你的Client Secret"

# 重启网关
openclaw gateway restart

# 验证接入
openclaw channels test dingtalk

验证：在钉钉中搜索应用名称，添加后发送指令（如“生成一份会议纪要”），能正常回复即成功；也可将机器人添加到群聊，通过@机器人触发交互。

（四）接入飞书（两种方式，新手选快捷配置）

飞书支持快捷配置（扫码授权）和手动配置（创建应用），新手优先选快捷配置，无需手动填写复杂凭证，步骤如下：

方式1：快捷配置（推荐，10分钟搞定）

登录部署OpenClaw的服务器（阿里云部署用Web终端，本地部署用对应终端）；
执行以下命令，进入飞书快捷配置：

# 进入OpenClaw容器
docker exec -it openclaw bash

# 安装飞书插件
openclaw plugins install @feishu/feishu-openclaw-plugin

# 启动飞书快捷配置
openclaw channels add --channel feishu --quick-auth

终端会生成一个二维码，用飞书APP扫描弹出的二维码，在飞书内点击「继续授权登录」；
返回终端，点击「我已完成扫码」，系统自动完成配置，提示“配置成功”；
重启网关：openclaw gateway restart，验证接入：openclaw channels test feishu。

方式2：手动配置（备用，适合无法扫码的场景）

登录飞书开发者平台，创建“企业应用”，获取AppID、AppSecret，保存备用；
开启“消息接收”权限，设置回调地址为 http://你的IP:18789/feishu/callback；
执行以下命令配置通道：

docker exec -it openclaw bash
openclaw channels add --channel feishu --app-id "你的AppID" --app-secret "你的AppSecret" --callback-url "http://你的IP:18789/feishu/callback"
openclaw gateway restart
openclaw channels test feishu

验证：在飞书内搜索应用名称，发送指令，能正常回复即接入成功。

七、OpenClaw常用运维与接入命令（新手速查，直接复制）

整理部署、API配置、通讯接入常用命令，新手可收藏备用，快速解决启动、重启、技能管理、接入验证等问题：

# 1. 查看OpenClaw版本
openclaw --version

# 2. 查看容器运行状态
docker ps | grep openclaw

# 3. 启动/停止/重启OpenClaw容器
docker start openclaw
docker stop openclaw
docker restart openclaw

# 4. 进入容器（修改配置、排查问题常用）
docker exec -it openclaw bash

# 5. 重启OpenClaw服务与网关
openclaw service restart
openclaw gateway restart

# 6. 查看运行日志（排查故障常用）
openclaw logs
openclaw logs --channel 通道名称（wecom/qq/dingtalk/feishu）

# 7. 安装/卸载通讯工具插件
openclaw plugins install 插件名称
openclaw plugins uninstall 插件名称

# 8. 查看已添加的通讯通道
openclaw channels list

# 9. 测试通讯通道连接
openclaw channels test 通道名称

# 10. 删除无用通道
openclaw channels delete 通道名称

# 11. 安装基础技能
clawhub install skill-vetter file-manager web-search-lite doc-parser

# 12. 清理缓存（解决卡顿、技能加载失败问题）
openclaw cache clean

# 13. 备份配置文件（避免配置丢失）
docker cp openclaw:/app/config ~/OpenClaw/backup

# 14. 恢复配置文件（配置出错时使用）
docker cp ~/OpenClaw/backup openclaw:/app/config
docker restart openclaw

八、常见问题解答（FAQ）：90%新手会遇到的问题及解决方案

1. 部署后无法访问Web控制台（http://ip:18789 无法打开）

核心原因：端口未放行、容器未启动、IP地址错误、防火墙拦截；
解决方案：
1. 阿里云部署：重新检查安全组规则，确保18789端口入方向放行；
2. 本地部署：关闭防火墙/杀毒软件，避免拦截端口；
3. 确认容器运行：执行 docker ps | grep openclaw，若未运行，执行 docker start openclaw；
4. 核对IP地址：阿里云部署用公网IP，本地部署用localhost，避免输入错误；
5. 端口占用解决：执行 lsof -i :18789（Mac/Linux）或 netstat -ano | findstr :18789（Windows），找到占用进程PID，执行 kill -9 PID（Mac/Linux）或 taskkill /F /PID 进程ID（Windows）释放端口。

2. 大模型API调用失败、无响应，或提示“认证失败”

核心原因：API Key错误、BaseURL错误、额度不足、网络问题；
解决方案：
1. 核对API Key：确保无多余空格、换行，重新复制粘贴；
2. 检查BaseURL：阿里云千问为 https://dashscope.aliyuncs.com/compatible-mode/v1，智谱AI为 https://api.zhipuai.cn/v1；
3. 检查额度：登录对应大模型平台，确认免费额度未过期、未用完；
4. 测试网络：执行 ping dashscope.aliyuncs.com（千问）或 ping api.zhipuai.cn（智谱），确保网络通畅；
5. 重启服务：执行 docker exec -it openclaw bash，再执行 openclaw service restart。

3. 通讯工具接入后，发送指令无响应

核心原因：通道配置错误、凭证泄露或过期、插件未安装、端口未放行；
解决方案：
1. 核对通道凭证：重新检查各平台的凭证（AgentID、Secret、AppID等），确保填写正确；
2. 检查插件安装：执行 openclaw plugins list，确认对应通讯平台插件已安装；
3. 测试通道连接：执行 openclaw channels test 通道名称，查看是否提示“连接成功”；
4. 检查回调地址：确保回调地址填写正确，阿里云部署用公网IP，本地部署需配置端口映射；
5. 重启网关：执行 docker exec -it openclaw bash，再执行 openclaw gateway restart。

4. 服务启动后自动停止、卡顿，或内存占用过高

核心原因：内存不足、权限不足、配置文件损坏；
解决方案：
1. 升级配置：阿里云服务器升级至2核4GB，本地设备关闭其他占用内存的程序；
2. 检查权限：本地部署确保目录权限为777，阿里云部署用root用户执行命令；
3. 重新初始化：执行 docker exec -it openclaw bash，再执行 openclaw init --full，重启容器；
4. 关闭闲置技能与通道：执行 openclaw skills disable 技能名、openclaw channels delete 通道名称，减少资源消耗；
5. Linux应急方案：配置Swap分区，执行 sudo fallocate -l 2G /swapfile && sudo chmod 600 /swapfile && sudo mkswap /swapfile && sudo swapon /swapfile，并在/etc/fstab中添加 /swapfile swap swap defaults 0 0 实现开机自启。

5. 本地部署重启电脑后，配置丢失、技能消失

核心原因：未创建持久化存储目录，或目录挂载错误；
解决方案：
1. 重新执行对应系统的部署命令，确保创建了存储目录并完成挂载；
2. 启动容器时必须添加 --restart always 参数，确保开机自启；
3. 定期备份配置文件（参考常用运维命令第13条），避免配置丢失。

6. 插件安装失败、网络超时，或提示“依赖缺失”

核心原因：网络问题、Node.js版本过低、npm镜像异常；
解决方案：
1. 切换npm国内镜像：执行 docker exec -it openclaw bash，再执行 npm config set registry https://registry.npmmirror.com；
2. 检查Node.js版本：执行 node -v，确保版本≥22，若低于22，重新部署（一键脚本会自动升级）；
3. 清理缓存：执行 docker exec -it openclaw bash，再执行 openclaw cache clean，重新安装插件；
4. 检查网络：确保设备可正常访问GitHub、npm仓库。

7. 微信/QQ接入后，出现封号、风控提示

核心原因：个人微信/QQ直连第三方协议、高频发送指令、账号异常；
解决方案：
1. 微信：改用企业微信接入，避免个人微信直连；
2. QQ：使用新注册的账号作为机器人，避免高频发送指令，定期登录QQ客户端保持账号活跃；
3. 减少敏感指令：避免发送违规、高频重复指令，降低风控风险。

8. 阿里云服务器部署后，远程访问卡顿、延迟高

核心原因：地域选择不当、带宽不足；
解决方案：
1. 更换地域：优先选择中国香港、新加坡，距离用户所在地较近的地域；
2. 升级带宽：将带宽升级至5Mbps及以上，减少访问延迟；
3. 关闭非必要进程：执行 sudo ps -ef | grep openclaw，关闭闲置进程，节省带宽与内存。

九、总结

OpenClaw（Clawdbot）的“新人秒级搭建”并非夸大其词，依托预置镜像与一键脚本，新手无需技术基础即可快速完成核心框架搭建；而其真正的价值，在于能无缝接入微信、QQ、钉钉、飞书四大通讯工具，让AI助手融入日常工作场景，无需切换APP，仅通过聊天指令就能完成各类自动化任务，大幅提升效率。

本文从新人视角出发，先明确OpenClaw的核心逻辑与前置准备，再实现秒级搭建，随后详细拆解2026年阿里云部署与本地三系统部署的完整流程，讲解阿里云千问与免费Coding Plan两种API配置方法，最后提供微信、QQ、钉钉、飞书四大平台的保姆级接入流程，搭配常用运维命令与常见问题解答，覆盖从搭建、部署、配置到接入的全场景，彻底解决新手“部署难、配置繁、接入无门、报错不会修”的痛点。

2026年的OpenClaw已实现极致简化，无论是秒级搭建还是全流程部署，无论是API配置还是通讯工具接入，所有操作均有明确步骤、可直接复制的命令，零基础用户也能在30分钟内完成全流程落地。只要严格按照本文步骤操作，就能顺利玩转OpenClaw，让AI助手24小时待命，真正实现“指令输入即落地”，解放双手、提升工作效率。

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

OpenClaw从零到精通保姆级图文教程：新人阿里云/本地秒级搭建+微信/QQ/钉钉/飞书接入与免费大模型API配置攻略

一、前言

二、OpenClaw（Clawdbot）核心认知：新人必懂的基础逻辑

（一）核心定位与优势

（二）“秒级搭建”的核心原理

（三）多平台接入的核心逻辑

（四）部署与接入的前置准备（必做，避免中途卡壳）

三、OpenClaw（Clawdbot）新人秒级搭建：基础框架快速落地

（一）本地秒级搭建（Windows11/MacOS/Linux通用）

1. 打开对应系统的终端（Windows11用管理员PowerShell，MacOS用终端，Linux用终端）；

2. 复制一键搭建脚本，粘贴执行（自动安装依赖、拉取镜像、启动服务）：

3. 脚本执行完成后，打开浏览器访问 http://localhost:18789，出现OpenClaw控制台页面，即完成本地秒级搭建。

（二）阿里云秒级搭建（长期使用首选）

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

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

1. 登录阿里云控制台，进入轻量应用服务器控制台，点击“创建实例”；

2. 配置实例参数（新手直接照搬）：

3. 支付完成后，等待5-10分钟，实例状态变为“运行中”，记录公网IP地址；

4. 远程连接服务器（使用阿里云Web终端），复制以下脚本执行，完成初始化：

5. 浏览器访问 http://你的阿里云公网IP:18789，出现控制台页面，即完成阿里云秒级搭建。

四、2026年OpenClaw全系统部署完整流程（详细版，新手必看）

（一）2026年阿里云部署OpenClaw（Clawdbot）完整流程

1. 实例创建与基础配置（详细版）

2. 安全组端口放行（必做，否则无法访问与接入）

3. 容器初始化与服务优化

4. 控制台基础设置

（二）本地全系统部署OpenClaw（详细版）

1. Windows11部署流程（管理员PowerShell操作）

2. MacOS部署流程（终端操作）

3. Linux（Ubuntu/Debian）部署流程（终端操作）

五、大模型API配置：阿里云千问 + 免费Coding Plan（二选一，新手首选免费版）

（一）阿里云千问大模型API配置（高性能、稳定，适合长期使用）

1. 获取阿里云千问API-Key（新手分步操作）：

2. 执行配置命令：

3. 配置完成后，退出容器：exit，即可使用阿里云千问模型驱动OpenClaw执行任务。

（二）免费Coding Plan API配置（零成本、易配置，适合新手体验）

1. 获取免费Coding Plan API-Key（新手分步操作）：

2. 执行配置命令：

3. 清空文件原有内容，粘贴以下配置（替换“你的免费API Key”为实际获取的密钥）：

4. 保存并退出编辑器：按Ctrl+O（保存），按Enter（确认），按Ctrl+X（退出）；

5. 重启服务，使配置生效：

6. 退出容器：exit，免费Coding Plan API配置完成，可正常使用。

（三）模型切换技巧（新手必知）

六、OpenClaw（Clawdbot）接入微信/QQ/钉钉/飞书保姆级流程

（一）接入微信（推荐企业微信，无封号风险）

（二）接入QQ（个人/企业均可，注意避开封号风险）

（三）接入钉钉（企业/个人均可，操作极简）

（四）接入飞书（两种方式，新手选快捷配置）

方式1：快捷配置（推荐，10分钟搞定）

方式2：手动配置（备用，适合无法扫码的场景）

七、OpenClaw常用运维与接入命令（新手速查，直接复制）

八、常见问题解答（FAQ）：90%新手会遇到的问题及解决方案

1. 部署后无法访问Web控制台（http://ip:18789 无法打开）

2. 大模型API调用失败、无响应，或提示“认证失败”

3. 通讯工具接入后，发送指令无响应

4. 服务启动后自动停止、卡顿，或内存占用过高

5. 本地部署重启电脑后，配置丢失、技能消失

6. 插件安装失败、网络超时，或提示“依赖缺失”

7. 微信/QQ接入后，出现封号、风控提示

8. 阿里云服务器部署后，远程访问卡顿、延迟高

九、总结

热门文章

最新文章

相关电子书

3. 脚本执行完成后，打开浏览器访问 `http://localhost:18789`，出现OpenClaw控制台页面，即完成本地秒级搭建。

5. 浏览器访问 `http://你的阿里云公网IP:18789`，出现控制台页面，即完成阿里云秒级搭建。

3. 配置完成后，退出容器：`exit`，即可使用阿里云千问模型驱动OpenClaw执行任务。

6. 退出容器：`exit`，免费Coding Plan API配置完成，可正常使用。