保姆级图文教程！OpenClaw阿里云/本地部署接入免费大模型api+飞书/Discord远程控制协同指南-阿里云开发者社区

AI代理工具的终极形态，是打破设备与平台的边界——既能在本地桌面高效运行，又能通过飞书、Discord等常用IM工具远程操控，实现“随时随地发指令，AI自动完成任务”。2026年，OpenClaw（昵称“龙虾”）凭借开放的插件生态与灵活的连接能力，成为跨平台协同的首选工具，而CodePilot等第三方客户端的崛起，更降低了新手入门门槛，让OpenClaw的安全与易用性再上一个台阶。

参考文章作者通过16天迭代40个版本，打造出融合Claude Code桌面端、Cowork协作功能与OpenClaw核心能力的CodePilot，支持飞书/Discord远程连接、多Agent并发分屏、Token使用监控等实用功能，为OpenClaw的跨平台协同提供了全新思路。本文基于参考文章核心逻辑，补充2026年新手零基础全平台部署流程（阿里云+Windows11/MacOS/Linux本地）、阿里云百炼免费大模型API配置步骤，深度解析OpenClaw与飞书/Discord的远程对接流程、CodePilot客户端使用方法及全流程避坑要点，所有代码命令可直接复制执行，助力用户解锁“本地+远程”的全场景AI协同体验。阿里云上OpenClaw极速一键部署最简单，步骤详情访问阿里云OpenClaw一键部署专题页面 了解。

一、核心认知：OpenClaw跨平台协同的核心价值

（一）为什么需要远程协同？

传统AI工具局限于单一设备，无法满足“随时随地发指令”的需求——比如通勤路上想让AI整理文件，或出差时需要远程触发自动化任务，仅靠本地部署难以实现。OpenClaw的跨平台协同能力，通过“IM工具+AI代理”的组合，解决三大核心痛点：

无设备限制：在飞书、Discord等常用IM工具中直接发指令，无需打开电脑客户端；
多场景覆盖：通勤、出差、团队协作等场景均能高效使用，打破时间与空间限制；
协作更高效：团队成员可通过IM工具共享OpenClaw能力，共同触发自动化任务，提升协作效率。

（二）部署方案选型对比（2026新手适配版）

结合远程协同需求，OpenClaw的双部署方案适配场景如下，用户可按需选择：

部署方案	核心优势	适用场景	配置要求	维护成本	远程协同适配性
阿里云部署	7×24小时运行、网络稳定、支持多用户远程连接、无需担心设备关机	团队协作、长期自动化任务、多设备远程控制	最低2vCPU+2GiB内存+40GiB ESSD	低（阿里云自带运维，可一键备份/重置）	完美适配，飞书/Discord远程指令响应稳定，支持多用户并发
本地部署（Win11/MacOS/Linux）	零服务器费用、数据隐私可控、操作便捷、适合个人使用	个人轻量使用、短期测试、隐私敏感场景	设备内存≥4GiB，需安装Node.js 22.x+	中（需自行处理依赖冲突、端口占用，远程连接依赖设备开机）	支持远程协同，但需保持设备开机与网络通畅，仅适合个人使用

（三）前置准备（全平台通用）

无论选择哪种部署方案，实现远程协同前需完成以下4项基础准备：

账号准备：注册阿里云账号并完成实名认证（个人用户支付宝刷脸验证，即时通过），用于服务器购买与百炼API开通；注册飞书/Discord账号，创建工作空间/服务器（用于远程连接）；
工具准备：远程连接工具（FinalShell/Xshell，用于阿里云操作）、文本编辑器（记录API密钥、IM工具机器人凭证）、Chrome浏览器（自动化技能必需）、Git（技能安装与客户端部署必需）；
环境准备：OpenClaw依赖Node.js 22.x及以上版本，CodePilot客户端支持Win11/MacOS（Linux用户需通过Docker部署）；
认知准备：了解飞书/Discord开放平台的机器人创建流程，明确OpenClaw的远程连接逻辑（通过Webhook或Socket模式接收IM工具指令）。

二、2026新手零基础全平台部署流程（OpenClaw核心部署）

（一）本地部署流程（Win11/MacOS/Linux全覆盖）

本地部署适合个人轻量使用，以下流程覆盖主流系统，所有命令可直接复制执行：

1. 前置依赖安装（Node.js+Git）

（1）Windows11系统（管理员模式操作）

安装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与配置国内镜像：

# 安装Git
winget install Git.Git
# 配置npm国内镜像（解决技能安装超时）
npm config set registry https://registry.npmmirror.com

验证依赖安装：

node --version  # 需显示v22.x.x
git --version    # 需显示2.40.x及以上

（2）MacOS 12+系统

安装Homebrew（已安装可跳过）：

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

安装Node.js、Git并配置镜像：

# 安装依赖
brew install node@22 git
# 配置Node.js环境变量
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 配置npm国内镜像
npm config set registry https://registry.npmmirror.com

验证安装：
```
node --version && git --version
```

（3）Linux（Ubuntu 20.04+系统）

安装依赖并配置镜像：

# 安装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
# 解决权限问题
sudo chmod -R 777 /usr/local/lib/node_modules

验证安装：
```
node --version && git --version
```

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

全局安装OpenClaw（支持npm/pnpm双命令）：

# npm安装（推荐）
npm install -g openclaw@latest
# 或pnpm安装（已安装pnpm用户）
# pnpm add -g openclaw@latest

初始化工作空间与配置：

# 创建工作目录
mkdir ~/OpenClaw-Workspace && cd ~/OpenClaw-Workspace
# 初始化配置，按提示选择默认值（新手无需修改）
openclaw init

启动Gateway服务并验证：

# 前台启动（测试用）
openclaw gateway start
# 后台启动（推荐，支持关闭终端后运行）
# Win11（PowerShell）：Start-Job -ScriptBlock {openclaw gateway start}
# MacOS/Linux：nohup openclaw gateway start &
# 验证服务状态（浏览器访问http://localhost:18789，能打开控制台即为成功）

（二）阿里云部署流程（远程协同首选）

阿里云部署支持7×24小时远程连接，适合团队协作与长期自动化任务，步骤如下：

新手零基础阿里云上部署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对话页面。
1. 服务器配置与实例创建

访问阿里云轻量应用服务器控制台，点击“创建实例”，按以下配置选择：
- 地域选择：中国香港、新加坡（免备案，网络通畅，支持飞书/Discord远程连接）；
- 镜像选择：Alibaba Cloud Linux 3.2104 LTS 64位（兼容Node.js、Git）；
- 实例规格：2vCPU+2GiB内存+40GiB ESSD+3Mbps带宽（个人使用足够，团队协作可选4vCPU配置）；
- 付费类型：按需付费（测试）/ 包年包月（长期）；
- 登录密码：设置强密码（含大小写字母+数字+特殊符号），妥善保存。
支付完成后，记录服务器公网IP（如47.xx.xx.xx），等待实例状态变为“运行中”。

2. 端口放行与远程连接

端口放行：进入实例详情页→“防火墙”→“添加规则”，放行以下端口：
- 22端口（远程连接）：TCP协议，授权对象“个人IP地址”；
- 18789端口（OpenClaw控制台）：TCP协议，授权对象“个人IP地址”；
- 443端口（API通信）：TCP协议，授权对象“0.0.0.0/0”（百炼API调用必需）；
- 3000端口（IM工具Webhook回调）：TCP协议，授权对象“0.0.0.0/0”（飞书/Discord远程连接必需）；
远程连接：用FinalShell输入公网IP、用户名（root）、密码，连接成功后进入终端。

3. 依赖安装与OpenClaw部署

安装核心依赖：

# 安装Node.js 22.x、Git
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

安装OpenClaw并初始化：

npm install -g openclaw@latest
# 创建工作目录并初始化
mkdir /data/openclaw && cd /data/openclaw
openclaw init
# 启动服务并设置开机自启
openclaw gateway start
echo "openclaw gateway start" >> /etc/rc.d/rc.local
chmod +x /etc/rc.d/rc.local

验证部署：
- 浏览器输入http://服务器公网IP:18789，能打开控制台即为成功；
- 终端执行openclaw --version，显示2026.x.x及以上版本即达标。

三、阿里云百炼免费API配置（解锁AI协同能力）

OpenClaw的远程协同与自动化任务执行，依赖大模型的自然语言理解能力，阿里云百炼提供免费额度，适合新手零成本入门，步骤如下（全平台通用）：

（一）获取百炼API-Key

访问登录阿里云百炼大模型服务平台，登录后进入“密钥管理”；
点击“创建API-Key”，复制生成的API-Key（仅显示一次，立即保存至文本编辑器）；
领取免费额度：进入“额度管理”，新用户可领取7000万Token（90天有效期），足够日常远程协同使用。

（二）配置OpenClaw关联百炼API

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

# 进入配置目录
cd ~/.openclaw
# 编辑配置文件（Win11用notepad，Mac/Linux用nano）
# Win11：notepad config.yaml
nano config.yaml

粘贴以下配置（替换为你的API-Key）：

model:
  provider: alibaba-cloud
  apiKey: "你的百炼API-Key"
  baseUrl: "https://dashscope.aliyuncs.com/compatible-mode/v1"
  defaultModel: "bailian/qwen3.5-turbo"  # 平衡型模型，适配远程指令理解
  parameters:
    temperature: 0.7  # 控制创造性，0.7适合日常场景
    maxTokens: 2048   # 足够处理远程指令与任务反馈
skills:
  autoLoad: true  # 自动加载已安装技能
security:
  skillScan: true  # 启用技能安全扫描
webhook:
  enabled: true    # 启用Webhook，支持IM工具回调
  port: 3000       # Webhook端口，与放行端口一致

保存退出，重启OpenClaw使配置生效：

# 本地部署重启
openclaw gateway restart
# 阿里云部署重启
openclaw gateway restart

（三）验证API配置

# 测试远程指令响应能力
openclaw chat "帮我整理一份今日远程协同任务清单，包含远程触发文件整理、数据采集"

若返回结构化任务清单（含任务描述、执行步骤），说明API配置成功，OpenClaw已具备远程协同能力。

四、OpenClaw远程协同实战（飞书/Discord对接+CodePilot使用）

远程协同的核心是“IM工具+OpenClaw”的对接，以下详细拆解飞书、Discord的远程连接流程，以及CodePilot客户端的使用方法，所有步骤可直接落地：

（一）对接飞书：企业协作首选

飞书作为企业级IM工具，适合团队内部的OpenClaw远程协同，步骤如下：

1. 飞书开放平台创建机器人

访问飞书开放平台（https://open.feishu.cn/），登录后创建“企业内部应用”；
进入应用详情页，获取“App ID”与“App Secret”（远程连接核心凭证）；
配置权限：在“权限管理”中添加以下核心权限：
- 消息推送权限（im:message:send）：允许机器人发送消息；
- 消息接收权限（im:message:read）：允许机器人接收用户指令；
- 文档权限（doc:read/doc:write）：支持远程操作飞书文档；
配置事件订阅：在“事件订阅”中添加“接收消息”事件，设置“请求URL”为http://服务器公网IP:3000/webhook/feishu（阿里云部署）或http://本地IP:3000/webhook/feishu（本地部署，需内网穿透）；
发布应用：将应用发布至企业内部，获取机器人“Bot ID”。

2. OpenClaw配置飞书远程连接

编辑OpenClaw配置文件，添加飞书机器人信息：
```
cd ~/.openclaw
nano config.yaml
```

粘贴以下配置（替换为你的飞书凭证）：

channels:
  feishu:
    enabled: true
    appId: "你的飞书App ID"
    appSecret: "你的飞书App Secret"
    botId: "你的飞书Bot ID"
    webhookPath: "/webhook/feishu"
    responseMode: "direct"  # 直接回复用户指令

重启OpenClaw使配置生效：
```
openclaw gateway restart
```

3. 远程协同实战：飞书指令触发文件整理

在飞书聊天窗口@飞书机器人，发送指令：“帮我整理服务器/data目录下的文件，按文档、图片、压缩包分类”；
执行效果：机器人接收指令后，转发至OpenClaw，OpenClaw执行文件整理任务，完成后通过机器人返回结果：“文件整理完成！文档12个、图片8个、压缩包3个，已分类保存至对应文件夹”；
进阶功能：团队成员可通过飞书群@机器人，共同触发自动化任务（如团队周报生成、数据汇总），实现协作效率提升。

避坑要点

本地部署需配置内网穿透（如frp），否则飞书无法访问本地OpenClaw；
确保3000端口已放行，且飞书机器人的“请求URL”与OpenClaw的webhookPath一致；
权限配置需完整，缺少消息接收权限会导致机器人无法响应指令。

（二）对接Discord：个人/小团队首选

Discord适合个人或小团队的OpenClaw远程协同，步骤如下：

1. Discord开发者平台创建机器人

访问Discord开发者平台（https://discord.com/developers/applications），登录后创建应用；
进入“Bot”页面，点击“Add Bot”，获取“Bot Token”（远程连接核心凭证）；
配置权限：在“OAuth2”→“URL Generator”中，勾选“bot”与“applications.commands”权限，生成邀请链接；
将机器人邀请至你的Discord服务器，确保机器人拥有“发送消息”“读取消息”权限。

2. OpenClaw配置Discord远程连接

编辑OpenClaw配置文件，添加Discord机器人信息：
```
cd ~/.openclaw
nano config.yaml
```

粘贴以下配置（替换为你的Discord Bot Token）：

channels:
  discord:
    enabled: true
    botToken: "你的Discord Bot Token"
    guildId: "你的Discord服务器ID"
    webhookPath: "/webhook/discord"
    prefix: "!claw"  # 远程指令前缀，如!claw 整理文件

重启OpenClaw使配置生效：
```
openclaw gateway restart
```

3. 远程协同实战：Discord指令触发数据采集

在Discord服务器中发送指令：!claw 用agent-browser采集阿里云官网的最新产品信息，生成结构化报告；
执行效果：机器人接收指令后，OpenClaw启动网页自动化技能，采集产品信息并生成报告，通过机器人返回报告链接或直接发送报告内容；
多用户协同：服务器成员可通过相同前缀指令，共同使用OpenClaw能力，适合小团队的远程协作。

避坑要点

Discord Bot Token需妥善保存，避免泄露导致恶意使用；
服务器ID可通过Discord设置“开发者模式”后获取；
若机器人无响应，检查网络通畅性（阿里云部署需确保Discord可访问）。

（三）CodePilot客户端：新手友好的远程协同工具

参考文章推荐的CodePilot客户端，融合了Claude Code与OpenClaw核心能力，支持Win11/MacOS，无需复杂配置即可实现远程协同，步骤如下：

1. 下载与安装CodePilot

访问CodePilot GitHub Releases（https://github.com/op7418/CodePilot/releases/tag/v0.26.0）；
下载对应系统版本（Windows选择.exe安装包，MacOS选择.dmg安装包）；
安装客户端，按提示完成初始化（默认配置即可，新手无需修改）。

2. 配置OpenClaw远程连接

打开CodePilot客户端，进入“设置”→“OpenClaw配置”；
输入OpenClaw连接信息：
- 连接地址：http://服务器公网IP:18789（阿里云部署）或http://localhost:18789（本地部署）；
- 百炼API-Key：粘贴你的阿里云百炼API-Key；
配置IM工具连接：在“远程连接”中选择飞书/Discord，输入对应机器人凭证，点击“测试连接”；
启用多Agent分屏：在客户端首页点击“分屏”按钮，可同时运行多个Agent，并行处理不同远程任务。

3. 核心功能实战

Token使用监控：客户端首页的“Token看板”实时显示API调用额度，避免超额计费；
可视化配置Code Plan：在“Code Plan”页面选择任务类型（如文件整理、数据采集），可视化配置执行步骤，无需手动输入指令；
远程指令历史记录：在“历史记录”中查看所有远程指令的执行结果，支持回溯与重复执行；
设计Agent与素材库：集成参考文章作者开发的设计Agent，支持远程生成图片、文案等素材，直接同步至IM工具。

避坑要点

CodePilot仅支持Win11/MacOS，Linux用户需通过Docker部署（docker pull op7418/codepilot）；
连接阿里云部署的OpenClaw时，确保服务器公网IP可访问，3000端口已放行；
客户端初始化失败时，检查Node.js版本是否达标（≥22.x）。

五、全流程避坑指南（新手必看）

结合参考文章踩坑经验与实战测试，梳理部署、API配置、远程协同三大环节的关键坑点：

（一）部署环节避坑

坑点1：Node.js版本过低 → 解决方案：严格安装Node.js 22.x及以上版本，用node --version验证，版本过低用nvm升级：
```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 22 && nvm use 22
```
坑点2：本地部署远程连接失败 → 解决方案：本地部署需配置内网穿透（如frp），将本地3000端口映射至公网，飞书/Discord的“请求URL”填写穿透后的公网地址。
坑点3：阿里云部署端口未放行 → 解决方案：确认3000端口已放行（远程Webhook回调必需），公网IP正确，用curl http://服务器公网IP:3000测试端口是否可访问。

（二）API配置避坑

坑点1：百炼API-Key丢失 → 解决方案：重新进入百炼控制台“密钥管理”，创建新API-Key，替换配置文件中的旧密钥，重启服务。
坑点2：API调用提示“429错误”（额度超限） → 解决方案：用openclaw model quota查看剩余额度，CodePilot客户端的“Token看板”可实时监控使用情况，避免高频无效调用。
坑点3：webhook未启用 → 解决方案：确保配置文件中webhook.enabled: true，端口与IM工具的“请求URL”一致，重启OpenClaw使配置生效。

（三）远程协同避坑

坑点1：飞书机器人无响应 → 解决方案：
- 检查App ID、App Secret是否正确，权限是否完整；
- 确认“请求URL”可访问，事件订阅配置正确；
- 重启OpenClaw与飞书机器人应用。
坑点2：Discord机器人无法接收指令 → 解决方案：
- 检查Bot Token是否正确，机器人已邀请至服务器；
- 确保机器人拥有“读取消息”“发送消息”权限；
- 指令前缀正确（默认!claw），避免指令格式错误。
坑点3：CodePilot客户端连接OpenClaw失败 → 解决方案：
- 检查OpenClaw服务是否正常运行，连接地址是否正确；
- 本地部署时关闭防火墙，避免端口被拦截；
- 阿里云部署时确保18789端口已放行，公网IP可访问。

六、总结

OpenClaw的远程协同能力，彻底打破了AI工具的设备限制，通过飞书、Discord等IM工具的对接，实现“随时随地发指令，AI自动完成任务”的全场景体验。而CodePilot等第三方客户端的崛起，更降低了新手入门门槛，让远程协同、多Agent并发、Token监控等高级功能触手可及。

本文基于参考文章核心逻辑，补充了2026年全平台部署流程、阿里云百炼API配置、飞书/Discord对接流程及CodePilot使用方法，所有代码可直接复制执行，新手也能快速落地。建议用户按以下步骤推进，高效解锁远程协同价值：

选型：团队协作选阿里云部署+飞书对接，个人使用选本地部署+Discord/CodePilot；
部署：严格按系统类型安装依赖，验证OpenClaw与API配置成功；
远程对接：优先对接飞书/Discord，配置Webhook回调与机器人权限，测试远程指令响应；
工具选择：新手推荐使用CodePilot客户端，可视化配置与监控功能更友好；
维护：定期检查服务器状态（阿里云部署）、API额度使用情况，确保远程协同稳定运行。

2026年，AI协同的核心竞争力已从“单一功能”转向“全场景覆盖”。OpenClaw的远程协同能力，配合阿里云百炼的免费API与CodePilot的易用性，构建了“低成本+高效率+高安全”的AI协同体系，无论是企业团队的协作优化，还是个人用户的效率提升，都能发挥核心价值。随着IM工具与AI代理的深度融合，建议用户持续关注OpenClaw生态更新，解锁更多远程协同高级功能（如多机器人协同、跨平台任务同步）。

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

保姆级图文教程！OpenClaw阿里云/本地部署接入免费大模型api+飞书/Discord远程控制协同指南

一、核心认知：OpenClaw跨平台协同的核心价值

（一）为什么需要远程协同？

（二）部署方案选型对比（2026新手适配版）

（三）前置准备（全平台通用）

二、2026新手零基础全平台部署流程（OpenClaw核心部署）

（一）本地部署流程（Win11/MacOS/Linux全覆盖）

1. 前置依赖安装（Node.js+Git）

（1）Windows11系统（管理员模式操作）

（2）MacOS 12+系统

（3）Linux（Ubuntu 20.04+系统）

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

（二）阿里云部署流程（远程协同首选）

1. 服务器配置与实例创建

2. 端口放行与远程连接

3. 依赖安装与OpenClaw部署

三、阿里云百炼免费API配置（解锁AI协同能力）

（一）获取百炼API-Key

（二）配置OpenClaw关联百炼API

（三）验证API配置

四、OpenClaw远程协同实战（飞书/Discord对接+CodePilot使用）

（一）对接飞书：企业协作首选

1. 飞书开放平台创建机器人

2. OpenClaw配置飞书远程连接

3. 远程协同实战：飞书指令触发文件整理

避坑要点

（二）对接Discord：个人/小团队首选

1. Discord开发者平台创建机器人

2. OpenClaw配置Discord远程连接

3. 远程协同实战：Discord指令触发数据采集

避坑要点

（三）CodePilot客户端：新手友好的远程协同工具

1. 下载与安装CodePilot

2. 配置OpenClaw远程连接

3. 核心功能实战

避坑要点

五、全流程避坑指南（新手必看）

（一）部署环节避坑

（二）API配置避坑

（三）远程协同避坑

六、总结

热门文章

最新文章

相关电子书