OpenClaw(原Clawdbot)作为本地优先、模块化的AI代理平台,2026年版本深度适配企业微信生态,可实现企业微信内自然语言交互、任务自动化、信息查询与办公协作全场景覆盖。本文提供2026年阿里云轻量服务器、本地MacOS/Linux/Windows11完整部署流程,详解企业微信接入(自建应用+机器人双模式)、阿里云千问大模型API与免费Coding Plan API配置方法,附可直接复制的代码命令与高频问题解决方案,零基础用户也能快速搭建稳定、安全、可协作的企业级AI助手系统。
一、部署前置准备(2026最新要求)
1. 系统与硬件要求
- 本地环境:Windows11(64位)、macOS 12+、Linux(Ubuntu20.04+/CentOS8+);内存≥4GB(推荐8GB+),磁盘≥20GB
- 云端环境:阿里云轻量应用服务器,配置≥2核2GB、系统盘≥40GB,选择OpenClaw 2026官方应用镜像
- 核心依赖:Node.js≥22.x、pnpm包管理器、Git;端口默认18789(Web控制台+企业微信通信)
- 阿里云部署 OpenClaw 只需两步,全网最简单,步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。

2. 必备凭证清单(提前获取)
- 阿里云百炼API Key(千问/Coding Plan):访问登录阿里云百炼大模型服务平台→密钥管理→创建API Key,保存Access Key ID与Secret
- 企业微信凭证:CorpID(企业ID)、AgentID(应用ID)、Secret(应用密钥)、Token、EncodingAESKey(自建应用);Bot ID、Secret(机器人模式)
3. 网络与安全配置
- 国内环境配置npm镜像加速:
npm config set registry https://registry.npmmirror.com - 阿里云轻量服务器提前放行18789、443端口(企业微信通信必需)
二、本地三系统部署OpenClaw(2026一键脚本)
(一)MacOS部署流程
# 1. 安装Homebrew(已安装跳过)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 2. 安装Node.js 22.x与pnpm
brew install node@22
brew install pnpm
# 3. 配置国内镜像
npm config set registry https://registry.npmmirror.com
# 4. 一键安装OpenClaw(国内镜像)
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
# 5. 初始化与安全配置
openclaw onboard --install-daemon
# 仅本地访问(安全加固)
sed -i '' 's/canvas_host.*/canvas_host": "127.0.0.1"/g' ~/.openclaw/openclaw.json
# 6. 启动服务
openclaw start
openclaw gateway start
# 7. 验证状态
openclaw gateway status
# 访问控制台:http://127.0.0.1:18789
(二)Linux部署(Ubuntu示例)
# 1. 更新系统与依赖
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git
# 2. 安装Node.js 22.x
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
sudo npm install -g pnpm
# 3. 配置镜像与安装OpenClaw
npm config set registry https://registry.npmmirror.com
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
# 4. 初始化与端口放行
openclaw onboard --install-daemon
sudo ufw allow 18789/tcp
sudo ufw reload
# 5. 公网访问配置(服务器场景)
sed -i 's/canvas_host.*/canvas_host": "0.0.0.0"/g' ~/.openclaw/openclaw.json
# 6. 启动与自启
openclaw start
openclaw gateway start
sudo systemctl enable openclaw-gateway
(三)Windows11部署(管理员PowerShell)
# 1. 国内镜像一键安装
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
# 2. 验证安装
openclaw --version
# 3. 初始化配置
openclaw onboard --install-daemon
# 4. 安装并启动网关
openclaw gateway install
openclaw gateway start
openclaw gateway status
# 5. 访问控制台:http://127.0.0.1:18789
三、2026阿里云轻量服务器部署(企业微信专属)
1. 服务器购买与初始化
- 登录阿里云轻量应用服务器控制台→创建实例→应用镜像→选择OpenClaw 2026企业微信适配版
- 配置:2核2GB+40GB ESSD,地域选就近节点(如杭州/上海),购买后记录公网IP
- 重置登录密码,通过Workbench远程连接服务器
零基础部署 OpenClaw 喂饭级步骤流程
第一步:点击打开访问阿里云OpenClaw一键部署专题页面。




第二步:打开选择阿里云轻量应用服务器,配置参考如下:
- 镜像:OpenClaw(Moltbot)镜像(已经购买服务器的用户可以重置系统重新选择镜像)
- 实例:内存必须2GiB及以上。
- 地域:默认美国(弗吉尼亚),目前中国内地域(除香港)的轻量应用服务器,联网搜索功能受限。
- 时长:根据自己的需求及预算选择。



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

前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
- 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
- 配置百炼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 的地址。


2. 服务器环境配置(命令行)
# 1. 登录服务器(替换为公网IP)
ssh root@xxx.xxx.xxx.xxx
# 2. 更新系统(Alibaba Cloud Linux)
yum update -y
# Ubuntu系统:apt update -y
# 3. 放行核心端口(防火墙+安全组双重配置)
firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --add-port=443/tcp --permanent
firewall-cmd --reload
# 4. 安装依赖(确保Node.js 22.x)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo yum install -y nodejs
sudo npm install -g pnpm
3. OpenClaw部署与Token生成
# 1. 一键安装OpenClaw
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
# 2. 初始化服务
openclaw onboard --install-daemon
# 3. 生成访问Token(登录控制台必需)
python3 -c "import secrets; token = secrets.token_hex(16); print(token); open('/root/.openclaw/openclaw.json', 'r+').write(open('/root/.openclaw/openclaw.json', 'r').read().replace('\"token\": \"\"', f'\"token\": \"{token}\"'))"
# 4. 查看并保存Token
cat /root/.openclaw/openclaw.json | grep token
# 5. 启动服务并设置开机自启
openclaw start
openclaw gateway start
systemctl enable openclaw-gateway
# 6. 验证服务状态
systemctl status openclaw-gateway
# 公网访问:http://公网IP:18789(输入Token登录)
四、企业微信接入(双模式:自建应用+机器人)
(一)模式一:自建应用接入(推荐,功能完整)
1. 企业微信后台创建应用
- 登录企业微信管理后台(https://work.weixin.qq.com)→应用管理→自建→创建应用
- 填写名称(如OpenClaw-AI助手)、上传图标、设置可见范围(全公司/指定部门)→创建
- 进入应用详情→记录AgentID、Secret;我的企业→企业信息→记录CorpID
2. 配置消息接收(关键)
- 应用详情→接收消息→设置API接收→填写:
- URL:
http://阿里云公网IP:18789/webhooks/wecom(本地部署用本地IP) - Token:自定义(如OpenClawWeCom2026)→随机生成EncodingAESKey→保存
- URL:
- 开启消息推送、接收消息、发送消息权限,添加服务器公网IP到可信IP列表
3. OpenClaw配置企业微信(命令行)
# 1. 安装企业微信通道插件
openclaw plugin install @openclaw/channel-wecom
# 2. 配置参数(替换为你的凭证)
openclaw config set wecom.enabled true
openclaw config set wecom.corpId "你的CorpID"
openclaw config set wecom.agentId "你的AgentID"
openclaw config set wecom.secret "你的Secret"
openclaw config set wecom.token "你的Token"
openclaw config set wecom.encodingAESKey "你的EncodingAESKey"
# 3. 重启网关生效
openclaw gateway restart
# 4. 验证配置
openclaw gateway status
# 企业微信后台点击“保存”,提示“已成功”即为打通
(二)模式二:机器人接入(简单快速)
1. 创建企业微信API机器人
- 企业微信客户端→工作台→智能机器人→创建机器人→手动创建→API模式创建
- 选择长连接→复制Bot ID、Secret→保存→设置机器人名称与可见范围
2. OpenClaw机器人配置
# 1. 安装机器人插件
openclaw plugin install @openclaw/bot-wecom
# 2. 配置机器人参数
openclaw config set wecom.bot.enabled true
openclaw config set wecom.bot.id "你的Bot ID"
openclaw config set wecom.bot.secret "你的Secret"
# 3. 重启服务
openclaw restart
# 4. 群聊添加机器人→@机器人发送测试消息,正常回复即成功
五、大模型API配置(阿里云千问+免费Coding Plan)
(一)阿里云千问大模型API配置
1. 开通服务与获取API Key
- 登录阿里云百炼平台(https://bailian.console.aliyun.com)→开通大模型服务→密钥管理→创建API Key(保存Access Key ID与Secret)
- 领取90天免费额度,开启消费限额避免超额费用
2. 环境变量配置(三系统通用)
# Linux/macOS临时配置
export DASHSCOPE_API_KEY="你的API Key"
# 永久配置(macOS)
echo "export DASHSCOPE_API_KEY='你的API Key'" >> ~/.zshrc
source ~/.zshrc
# 永久配置(Linux)
echo "export DASHSCOPE_API_KEY='你的API Key'" >> ~/.bashrc
source ~/.bashrc
# Windows PowerShell临时配置
$env:DASHSCOPE_API_KEY="你的API Key"
# 永久配置
setx DASHSCOPE_API_KEY "你的API Key" /M
3. OpenClaw对接千问
# 配置模型参数
openclaw config set model.provider aliyun
openclaw config set model.api_key $DASHSCOPE_API_KEY
openclaw config set model.base_url https://dashscope.aliyuncs.com/compatible-mode/v1
openclaw config set model.name qwen-turbo
# 重启服务生效
openclaw restart
# 验证模型调用
openclaw test model
# 输出测试成功即对接正常
(二)免费Coding Plan API配置(开发场景首选)
1. 获取免费API Key
- 阿里云百炼→Coding Plan→开通免费套餐→获取专属API Key(sk-sp-开头)
- 免费额度支持代码生成、调试、文档生成,满足个人与小型团队开发需求
2. OpenClaw配置Coding Plan
# 配置Coding Plan专属参数
openclaw config set agents.defaults.model.primary "coding-plan/qwen3-coding"
openclaw config set providers.coding-plan.apikey "你的Coding Plan API Key"
openclaw config set providers.coding-plan.baseurl "https://coding.dashscope.aliyuncs.com/v1"
# 重启服务
openclaw restart
# 验证配置
openclaw test model
# 测试代码生成功能,正常输出即成功
六、常见问题解答(FAQ)
1. 部署失败:Node.js版本过低
解决方案:卸载旧版,安装22.x及以上版本
# macOS
brew uninstall node && brew install node@22
# Linux
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# Windows:官网下载22.x安装包
2. 企业微信接入失败:URL验证不通过
- 检查服务器18789端口是否放行(阿里云控制台+服务器防火墙双重确认)
- 确认URL格式正确:
http://公网IP:18789/webhooks/wecom,无多余字符 - 重启OpenClaw网关:
openclaw gateway restart,重新验证
3. 大模型API调用失败
- 检查API Key是否正确,无空格、无换行
- 确认百炼服务已开通,账户无欠费
- 验证网络连通性:
ping dashscope.aliyuncs.com - 执行自动修复:
openclaw doctor --fix
4. 阿里云服务器无法公网访问
- 轻量控制台防火墙添加18789、443端口规则,授权对象0.0.0.0/0
- 服务器内部放行端口:
firewall-cmd --add-port=18789/tcp --permanent && firewall-cmd --reload - 确认安全组规则允许TCP 18789入站
5. Token丢失无法登录控制台
# 重新生成Token
python3 -c "import secrets; token = secrets.token_hex(16); print(token); open('/root/.openclaw/openclaw.json', 'r+').write(open('/root/.openclaw/openclaw.json', 'r').read().replace('\"token\": \"\"', f'\"token\": \"{token}\"'))"
openclaw restart
# 查看新Token:cat /root/.openclaw/openclaw.json | grep token
6. 企业微信消息接收延迟/无响应
- 检查服务器网络稳定性,确保带宽≥1Mbps
- 调整OpenClaw超时时间:
openclaw config set request.timeout 300 - 重启企业微信通道:
openclaw plugin restart @openclaw/channel-wecom
7. Windows安装脚本执行超时
- 切换国内镜像脚本:
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex - 关闭VPN/代理,重启PowerShell后重试
- 手动安装Node.js 22.x,再执行安装命令
8. 技能安装后无法在企业微信使用
- 用Skill-Vetter扫描技能:
clawhub scan 技能名,排查风险 - 更新技能:
clawhub update 技能名 - 查看日志:
cat ~/.openclaw/logs/skills.log定位错误
七、总结
2026年OpenClaw依托阿里云轻量服务器的一键部署能力与本地三系统的兼容性,实现了云端+本地的全场景覆盖;企业微信双模式接入(自建应用+机器人)让AI能力无缝融入企业办公流程,支持单聊、群聊、客户群的自然语言交互与任务自动化。阿里云千问大模型API提供强大的通用能力,免费Coding Plan API则为开发场景提供零成本解决方案,兼顾性能与成本。
本文完整覆盖部署、企业微信集成、大模型对接、问题排查全流程,所有命令均可直接复制执行,无需额外调试。无论是个人打造私人AI助手,还是企业搭建团队协作AI系统,都能快速落地并稳定运行。后续可通过OpenClaw技能库拓展更多功能,结合企业微信实现办公自动化、知识管理、客户服务等场景的深度赋能。