OpenClaw(也叫 Clawdbot)是2026年最火的开源AI智能体框架,它能让你把大模型接到微信、飞书、Telegram等日常工具,让AI真正帮你自动干活、自动回复、自动整理信息、记住你的习惯、执行定时任务。但很多新手卡在安装、命令行、报错、模型配置、端口不通、无法联网等问题上。
这篇文章专为零基础小白打造,全程不用懂代码,不用懂网络,复制粘贴命令就能完成。内容包括:
• 环境准备与检查
• Windows11 / MacOS / Linux 一键安装OpenClaw
• 阿里云服务器2026最新部署流程
• 阿里云百炼Coding Plan免费大模型API完整配置
• DeepSeek、通义千问国内模型一键接入
• 飞书/Telegram/企业微信接入教程
• 开机自启、后台运行、面板访问
• 所有常见报错一站式解决
所有命令可直接复制运行,看完就能搭建专属AI助手。阿里云上OpenClaw极速一键部署最简单,步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。

一、开始前准备(所有人必看)
确保你的设备满足以下条件,否则会安装失败:
- Windows10/11 或 MacOS 10.15+ / Linux Ubuntu 20.04+
- 内存至少4GB(推荐8GB)
- 稳定的网络
- 预留20分钟时间
- 必须安装 Node.js ≥22(低版本直接报错)
二、安装 Node.js(所有平台通用第一步)
OpenClaw必须依赖Node.js 22及以上版本,否则无法运行。
Windows11 安装 Node.js
- 打开官网:
https://nodejs.org/ - 点击左侧 LTS 绿色按钮
- 下载
.msi安装包 - 双击安装,一路Next
- 勾选 Automatically install necessary tools
- 安装完成后打开 命令提示符(CMD)
显示 v22.x.x 即为成功。node --version
MacOS 安装 Node.js
- 打开
https://nodejs.org/ - 下载
.pkg安装包 - 双击安装,输入密码
- 打开终端
显示 v22+ 即可。node --version
Linux 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node -v
三、OpenClaw 一键安装(全平台)
Mac / Linux 一键安装(官方脚本,强烈推荐)
curl -fsSL https://openclaw.ai/install.sh | bash
Windows11 一键安装(管理员PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
安装加速(解决慢/卡住)
npm config set registry https://registry.npmmirror.com
验证安装成功
openclaw --version
出现 2026.3.x 即成功。
四、OpenClaw 初始化配置(小白必走)
运行交互式配置向导,自动设置模型、开机自启、网关:
openclaw onboard --install-daemon
向导会自动帮你:
• 设置开机自启
• 配置模型API Key
• 选择聊天平台
• 生成工作目录
• 配置端口与访问权限
五、2026 阿里云服务器部署 OpenClaw 完整步骤(长期稳定运行)
适合7×24小时运行、远程访问、团队使用。
1. 购买轻量应用服务器
系统:Ubuntu 22.04
配置:2核2G起步
开放端口:18789(必须开放)
阿里云用户零基础部署 OpenClaw 喂饭级步骤流程
第一步:打开访问阿里云OpenClaw一键部署专题页面,找到并点击【一键购买并部署】。




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



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

前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
- 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
- 配置百炼API-Key,单击一键配置,输入百炼的API-Key。单击执行命令,写入API-Key。
- 配置OpenClaw:单击执行命令,生成访问OpenClaw的Token。
- 访问控制页面:单击打开网站页面可进入OpenClaw对话页面。
2. 登录阿里云,执行环境安装
sudo apt update && sudo apt upgrade -y
sudo apt install nodejs npm git python3 python3-pip docker.io -y
sudo systemctl start docker
sudo systemctl enable docker
sudo usermod -aG docker $USER
newgrp docker
3. 一键安装OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw --version
4. 初始化云端环境
openclaw init --mode cloud --port 18789 --sandbox enable
openclaw config set gateway.bind 0.0.0.0
openclaw config set gateway.allowIps 127.0.0.1
5. 启动并设置开机自启
openclaw gateway start
openclaw gateway status
openclaw config set gateway.autoStart true
6. 测试访问
浏览器打开:
http://你的阿里云IP:18789
六、阿里云百炼 Coding Plan API 免费模型配置(2026最新)
阿里云百炼提供免费额度,支持通义千问3.5等模型,国内延迟最低、最稳定。
1. 开通并获取API Key
- 打开:访问登录阿里云百炼大模型服务平台
- 开通 Coding Plan
- 进入 API Keys
- 生成并复制 Key(以 sk- 开头)
阿里云百炼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. 写入 OpenClaw 配置
编辑文件:~/.openclaw/openclaw.json
{
"models": {
"mode": "merge",
"providers": {
"bailian": {
"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
"apiKey": "你的APIKey",
"api": "openai-completions",
"models": [
{
"id": "qwen3.5-plus",
"name": "通义千问3.5 Plus",
"contextWindow": 1000000,
"maxTokens": 65536
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "bailian/qwen3.5-plus"
}
}
}
}
3. 重启网关生效
openclaw gateway restart
4. 测试模型是否可用
openclaw chat --prompt "你好,介绍一下自己"
七、国内免费模型配置(DeepSeek / 通义千问)
DeepSeek 配置
openclaw models auth add openai
API Key 填写 DeepSeek Key
Base URL:
https://api.deepseek.com/v1
模型:
openclaw models set openai/deepseek-chat
通义千问配置
openclaw models auth add openai
Base URL:
https://dashscope.aliyuncs.com/compatible-mode/v1
模型:
qwen-max
八、打开 Web 控制面板(可视化聊天界面)
openclaw dashboard
或浏览器访问:
http://127.0.0.1:18789
九、接入飞书 / 企业微信 / Telegram(让AI在聊天软件工作)
飞书接入
openclaw plugins enable feishu
按提示输入:
- App ID
- App Secret
- 群组ID
Telegram 接入
- 在 Telegram 搜索 @BotFather
- 输入 /newbot 创建机器人
- 复制 Token
- 执行:
openclaw plugins enable telegram - 粘贴 Token
- 给机器人发消息,自动回复
企业微信个人号受限,推荐使用飞书。
十、OpenClaw 常用命令大全(建议收藏)
# 查看版本
openclaw --version
# 启动网关
openclaw gateway start
# 停止
openclaw gateway stop
# 重启
openclaw gateway restart
# 查看状态
openclaw gateway status
# 打开面板
openclaw dashboard
# 查看技能列表
openclaw skills list
# 查看插件
openclaw plugins list
# 更新OpenClaw
npm install -g openclaw@latest
# 查看日志
openclaw logs --tail 100
# 设置开机自启
openclaw onboard --install-daemon
十一、阿里云百炼 API 常见问题(90%新手都遇到)
1. 报错 401 invalid api-key
原因:
- API Key 错误
- 未开通 Coding Plan
- 权限不足
解决:重新生成API Key
2. 报错 404 not found
BaseURL 错误
正确地址:
https://coding.dashscope.aliyuncs.com/v1
3. 模型不存在
模型ID填写:
qwen3.5-plus
4. 本地可用,阿里云不可用
阿里云安全组未放行 443 端口,或DNS异常。
5. 免费额度用尽
等待免费额度刷新,或切换DeepSeek。
十二、OpenClaw 安装/运行常见错误一站式解决
1. command not found
- Node.js未安装
- 重启终端
- 重新安装
2. 权限错误
Windows 使用管理员PowerShell
Mac/Linux 加 sudo
3. 安装卡住/慢
npm config set registry https://registry.npmmirror.com
4. 无法访问 127.0.0.1:18789
openclaw gateway restart
5. Mac 无法验证开发者
系统设置 → 隐私与安全性 → 仍要打开
6. AI 回复乱码/幻觉
- 模型配置错误
- 切换为阿里云百炼
- 重启网关
7. Skill 无法安装
npm install -g openclaw@latest
openclaw gateway restart
8. 无法联网/搜索不到信息
安装联网技能:
openclaw plugin install tavily-search
十三、总结(小白看完这一段就够)
- 安装 Node.js 22+
- 一键安装 OpenClaw
- 运行
openclaw onboard完成配置 - 配置阿里云百炼 Coding Plan API Key
- 打开
http://127.0.0.1:18789开始使用 - 接入飞书/Telegram,随时随地用AI
- 阿里云部署可实现24小时运行
你不需要懂代码、不需要懂命令、不需要懂网络,只需要复制粘贴,10分钟就能拥有一个能自动干活、记住习惯、自动回复、定时任务的专属AI助手。
OpenClaw 2026年最强的地方就是:简单、稳定、可扩展、支持国内模型、可接入聊天软件。