2026年的AI Agent工具生态中,OpenClaw(原Clawdbot)凭借高度可扩展的Skills体系和跨平台部署能力,成为个人与团队打造专属自动化AI助理的核心工具。ClawHub官方技能市场已收录33696+款Skills,如何快速完成OpenClaw的本地或云端部署,同时筛选高价值技能完成配置,是解锁工具核心能力的关键。本文将完整覆盖2026年阿里云部署、本地MacOS/Linux/Windows11部署的实操流程,阿里云千问大模型与免费Coding Plan API的配置方法,以及官方下载量TOP15的Skills安装与使用,同时解答部署和使用中的常见问题,让使用者零门槛搭建可落地的AI自动化体系。
一、部署前核心准备
OpenClaw的部署需满足基础环境要求,同时做好安全前置配置,避免后续使用中出现权限、网络或模型调用问题,本地部署与云端部署的基础准备要求一致。
- 环境版本要求
核心依赖Node.js需满足v18+,生产环境推荐v22.x及以上,内存最低4GB(推荐8GB及以上),保证多技能同时运行的流畅性;默认占用18789端口,需确保该端口未被占用。 - 版本检查与升级命令
先检查本地Node.js版本,若低于要求需及时升级:# 检查Node.js版本 node -v # macOS/Linux系统安装nvm并升级至22版本 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 22 nvm use 22 # Windows11系统可通过nvm-windows或官网直接下载安装包升级 - 安全前置须知
OpenClaw具备文件读写、系统命令执行、外部API调用等高权限能力,部署前需明确安全边界:本地部署优先绑定127.0.0.1,禁止公网直接暴露控制面板;API Key单独管理,不嵌入代码、不随意分享;云端部署必须开启防火墙,仅放行必要端口并配置访问令牌。阿里云部署 OpenClaw 只需两步,全网最简单,步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。
二、OpenClaw全平台部署流程
(一)本地部署:MacOS/Linux/Windows11
2026年版本的OpenClaw已实现全平台原生兼容,各系统部署流程简洁,核心通过命令行完成安装与初始化,以下为各系统实操步骤。
1. MacOS系统部署
# 1. 执行一键安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash
# 2. 验证安装是否成功,输出版本号即为成功
openclaw --version
# 3. 启动配置向导并安装后台服务
openclaw onboard --install-daemon
# 4. 编辑配置文件,绑定本地地址保证安全
nano ~/.openclaw/openclaw.json
# 5. 在配置文件中修改canvas_host为127.0.0.1,保存退出(Ctrl+O→回车→Ctrl+X)
# 6. 启动服务并获取访问令牌
openclaw gateway --verbose
# 7. 浏览器访问控制面板完成初始化
# 地址:http://127.0.0.1:18789
2. Linux系统部署(以Ubuntu/Debian为例)
# 1. 更新系统依赖并安装git
sudo apt update && sudo apt upgrade -y
sudo apt install -y git
# 2. 安装Node.js 22版本
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
sudo apt install -y nodejs
# 3. 验证Node版本
node -v
# 4. 全局安装OpenClaw(可选择npm或pnpm,pnpm速度更快)
npm install -g openclaw@latest
# pnpm add -g openclaw@latest
# 5. 初始化配置并安装后台服务
openclaw onboard --install-daemon
# 6. 检查18789端口占用情况,放行端口
lsof -i :18789
sudo ufw allow 18789/tcp
# 7. 修改配置文件,绑定本地地址
sed -i 's/canvas_host.*/canvas_host": "127.0.0.1"/g' ~/.openclaw/openclaw.json
# 8. 启动OpenClaw服务
openclaw start
# 9. 浏览器访问控制面板
# 地址:http://127.0.0.1:18789
3. Windows11系统部署
以管理员身份打开PowerShell,执行以下命令:
# 1. 执行一键安装脚本
iwr -useb https://openclaw.ai/install.ps1 | iex
# 2. 验证安装版本
openclaw --version
# 3. 运行配置向导并安装后台服务
openclaw onboard --install-daemon
# 4. 打开配置文件修改本地绑定地址
notepad $env:USERPROFILE\.openclaw\openclaw.json
# 5. 找到canvas_host,修改为"127.0.0.1"并保存
# 6. 启动服务并获取令牌
openclaw gateway --verbose
# 7. 浏览器访问控制面板
# 地址:http://127.0.0.1:18789
4. Docker通用部署(全平台兼容)
适合无环境依赖需求或服务器部署场景,一步完成容器化安装:
# 1. 拉取OpenClaw最新镜像
docker pull openclaw/openclaw:latest
# 2. 启动容器,映射端口并挂载配置目录
docker run -d \
--name openclaw \
-p 18789:18789 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:latest
# 3. 查看容器运行状态,确认部署成功
docker ps | grep openclaw
(二)2026阿里云部署:一键搭建云端AI助理
阿里云为OpenClaw提供了专属一键部署方案,无需手动配置环境,3步即可完成云端搭建,支持公网访问、钉钉/飞书集成,适合团队协作或需要7×24小时运行的场景。
1. 部署前阿里云准备
- 注册阿里云账号,完成阿里云账号实名认证:个人用户通过支付宝刷脸认证,企业用户上传营业执照审核(1-3个工作日);
- 准备服务器配置:最低2核2GB内存(仅测试用),生产环境推荐2核4GB内存+40GB ESSD系统盘+5Mbps带宽;
- 地域选择:免备案节点可选中国香港、新加坡、美国弗吉尼亚;国内低延迟节点可选华东1(杭州)、华北2(北京)(需ICP备案);
- 获取阿里云百炼API-Key:访问登录阿里云百炼大模型服务平台→进入「密钥管理」→点击「创建API Key」,生成后立即复制保存(仅显示一次),并在「访问控制」中为该密钥授予「大模型调用权限」。
2. 阿里云一键部署实操
阿里云用户零基础部署 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 的地址。


# 核心操作通过阿里云控制台完成,命令行仅用于验证
# 步骤1:访问阿里云OpenClaw部署专题页,点击「一键购买并部署」
# 配置参数:应用镜像选择OpenClaw(原Clawdbot),选择已准备的实例规格和地域,完成支付
# 步骤2:放行18789端口
# 登录轻量应用服务器控制台→实例详情→防火墙→添加规则:TCP协议、端口18789、授权对象0.0.0.0/0
# 步骤3:配置百炼API-Key
# 实例详情→应用详情→百炼API-Key配置→粘贴API-Key并执行命令
# 步骤4:生成访问Token并启动服务
# 应用详情→执行命令→复制系统生成的管理员Token
# 步骤5:验证服务是否运行正常
curl http://<服务器公网IP>:18789/api/v1/health
# 返回{"status":"healthy"}即为部署成功
# 步骤6:浏览器访问云端控制面板
# 地址:http://<服务器公网IP>:18789/?token=<生成的Token>
3. 阿里云部署进阶配置:IM工具集成
云端部署后可绑定钉钉/飞书,实现即时消息指令交互:
- 钉钉集成:登录钉钉开放平台→创建企业内部应用并添加「机器人」能力→在OpenClaw「通道配置」中填入钉钉应用Client ID和Secret→钉钉群聊添加机器人并测试响应;
- 飞书集成:登录飞书开放平台→创建企业自建应用并添加「机器人」能力→订阅
im.message.receive_v1事件→OpenClaw中填入飞书App ID和Secret→飞书群添加机器人并输入配对码完成绑定。
三、大模型API配置:阿里云千问与免费Coding Plan
OpenClaw的核心能力依赖大模型支撑,2026年可直接对接阿里云千问大模型(Qwen3-Max等),也可配置市场免费的阿里云百炼Coding Plan API,满足不同场景的模型调用需求,以下为两种配置的实操步骤。
(一)阿里云千问大模型API配置
- 完成前文「部署前阿里云准备」中的API-Key创建与权限配置;
- 登录OpenClaw控制面板→进入「配置」→「模型管理」;
- 选择「添加模型」,模型类型选择「阿里云千问」,填入已生成的API-Key;
- 选择适配的千问模型版本(如qwen3-max-2026-01-23,适配中文场景),点击「测试连接」,提示连接成功后保存配置;
- 将千问模型设置为「主模型」,即可实现所有OpenClaw指令的千问模型调用。
(二)免费大模型Coding Plan API配置
阿里云百炼Coding Plan提供免费的大模型调用能力,兼容OpenAI接口格式,配置后可用于代码生成、文本处理等场景,支持VS Code、JetBrains等IDE与OpenClaw联动:
- 登录阿里云百炼大模型控制台→进入「Coding Plan」板块→生成专属API Key(格式为sk-sp-xxxxx);
- OpenClaw中配置:
# 1. 进入OpenClaw配置目录 cd ~/.openclaw # 2. 编辑模型配置文件 nano model.json # 3. 添加Coding Plan配置信息 { "provider": "openai-compatible", "baseUrl": "https://coding.dashscope.aliyuncs.com/v1", "apiKey": "你的Coding Plan API Key", "model": "coding-plan-v1" } # 4. 保存退出,重启OpenClaw服务 openclaw restart - IDE联动配置(可选):以VS Code为例,安装Kilo Code扩展→选择「Bring my own Key」→API Provider选择OpenAI Compatible→Base URL填入
https://coding.dashscope.aliyuncs.com/v1→API Key填入Coding Plan专属密钥→保存后即可实现IDE与OpenClaw的模型联动。
四、OpenClaw热门Skills安装:官方下载量TOP15
ClawHub官方技能市场按真实下载量排序的15款Skills,是经过用户验证的高价值工具,按「安全地基→核心能力→场景化应用」的顺序安装,可快速搭建OpenClaw的完整能力体系。所有技能的核心安装命令为npx clawhub@latest install <技能名>,无需全局安装clawhub,基于Node.js的npx即可直接执行,同时提供验证命令确保安装成功。
安装前通用命令
# 验证已安装技能列表
npx clawhub@latest list
# 更新所有已安装技能
npx clawhub@latest update --all
# 卸载指定技能
npx clawhub@latest uninstall <技能名>
# 搜索技能市场中的指定技能
npx clawhub@latest search <关键词>
TOP15 Skills安装与核心能力
- Self-Improving Agent(自我进化框架)
下载量289000+,星标2600+,记录操作失败、用户纠正、知识缺口并写入.learnings/目录,让AI实现持续自我进化,下次遇到相同问题可直接调用经验。npx clawhub@latest install self-improving-agent # 验证安装 npx clawhub@latest list | grep self-improving-agent - Summarize(智能摘要)
下载量197000+,星标758,支持网页、PDF、图片、音频、YouTube视频的一键摘要,大幅提升信息处理效率。npx clawhub@latest install summarize npx clawhub@latest list | grep summarize - Agent Browser(浏览器自动化)
下载量160000+,星标708,基于Rust构建的无头浏览器,让AI实现网页打开、点击、表单填写、截图、内容抓取,是OpenClaw的「操作手」。npx clawhub@latest install agent-browser # 安装浏览器底层依赖 agent-browser install --with-deps npx clawhub@latest list | grep agent-browser - Skill Vetter(安全扫描)
下载量141000+,星标594,安装第三方技能前的必备工具,检查代码风险、权限范围、可疑网络调用,建议装完OpenClaw后第一个安装。npx clawhub@latest install skill-vetter npx clawhub@latest list | grep skill-vetter - Gog(Google全家桶)
下载量129000+,星标771,打通Gmail、Google Calendar、Drive、Sheets等产品,支持对话式邮件收发、日程安排、文件操作,需配置Google OAuth。npx clawhub@latest install gog # macOS安装二进制工具 brew install steipete/tap/gogcli npx clawhub@latest list | grep gog - GitHub(开发者协作中枢)
下载量127000+,星标423,基于GitHub CLI的指令集,支持对话式查看Issue、PR状态、CI构建日志,安装前需本地安装gh并完成gh auth login。npx clawhub@latest install github npx clawhub@latest list | grep github - Ontology(知识图谱)
为AI打造长期记忆,创建并管理人、项目、任务等实体及关系,适合知识管理、项目复盘,让AI不再每次对话从零开始。npx clawhub@latest install ontology npx clawhub@latest list | grep ontology - Proactive Agent(主动式AI)
下载量116000+,星标615,基于WAL Protocol实现AI从「被动执行」到「主动预判」,配合Self-Improving Agent使用效果更佳。npx clawhub@latest install proactive-agent npx clawhub@latest list | grep proactive-agent - Weather(天气查询与提醒)
下载量109000+,星标314,无需API Key,支持天气查询、多日预报、定时推送,适合出行计划、活动提醒等场景组合。npx clawhub@latest install weather npx clawhub@latest list | grep weather - Multi Search Engine(多引擎搜索)
下载量78400+,星标398,支持17个搜索引擎(8个国内+9个全球),含高级搜索、时间筛选、WolframAlpha知识查询,全部免费无需API Key。npx clawhub@latest install multi-search-engine npx clawhub@latest list | grep multi-search-engine - Nano Pdf(PDF全能处理)
下载量70600+,星标172,通过自然语言指令实现PDF文字提取、内容修改、水印添加、拆分合并,无需学习复杂操作。npx clawhub@latest install nano-pdf npx clawhub@latest list | grep nano-pdf - Humanizer(AI文本去味儿)
下载量67000+,星标447,润色AI生成文本,去除模板化表达和重复措辞,让文本更接近人工写作风格,适合文案、报告、邮件创作。npx clawhub@latest install humanize-ai-text npx clawhub@latest list | grep humanize-ai-text - AdMapix(广告情报助手)
下载量65500+,星标164,支持广告创意搜索、应用排名查看、下载量/收入追踪,是产品经理、运营做ASO、竞品调研的必备工具。npx clawhub@latest install admapix npx clawhub@latest list | grep admapix - Sonoscli(音响控制)
下载量65000+,星标43,实现Sonos音响的对话式控制,支持播放、暂停、切歌、设备分组,通过SSDP自动发现局域网设备,适合智能家居场景。npx clawhub@latest install sonoscli # 安装底层工具 go install github.com/steipete/sonoscli/cmd/sonos@latest npx clawhub@latest list | grep sonoscli - Notion(知识库管理)
下载量63400+,星标205,基于Notion API实现页面、数据库、块结构的创建与管理,适合用Notion做知识管理、任务追踪的用户。npx clawhub@latest install notion npx clawhub@latest list | grep notion
新手推荐一键安装地基技能
# 一次性安装安全与核心能力地基技能
npx clawhub@latest install skill-vetter
npx clawhub@latest install self-improving-agent
npx clawhub@latest install agent-browser
npx clawhub@latest install summarize
npx clawhub@latest install ontology
五、OpenClaw部署与使用常见问题解答
(一)部署类问题
问题:本地部署后无法访问127.0.0.1:18789控制面板
解决:①检查18789端口是否被占用,执行lsof -i :18789(MacOS/Linux)或netstat -ano | findstr "18789"(Windows11)查看,占用则关闭对应进程;②确认配置文件中canvas_host已改为127.0.0.1,未修改则重新编辑配置并重启服务;③检查本地防火墙是否放行18789端口。问题:阿里云部署后执行健康检查返回失败,提示连接超时
解决:①确认阿里云轻量应用服务器的防火墙已放行18789端口,授权对象为0.0.0.0/0;②检查服务器公网IP是否正确,是否为实例详情页的公网IP而非内网IP;③重启OpenClaw服务,执行openclaw restart后重新验证。问题:安装时提示Node.js版本过低,即使已安装高版本
解决:①确认系统已识别新安装的Node.js版本,执行nvm use 22切换版本;②MacOS/Linux系统执行source ~/.bashrc或source ~/.zshrc刷新环境变量;③Windows11系统关闭当前PowerShell,重新以管理员身份打开后再执行安装。
(二)模型调用类问题
问题:配置API-Key后,OpenClaw执行指令提示模型无响应
解决:①核对API-Key是否正确,无空格、大小写错误,阿里云API-Key需确认已授予大模型调用权限;②检查阿里云账号是否有模型调用额度,免费额度耗尽需充值;③确保服务器/本地网络可访问阿里云百炼接口,可执行ping coding.dashscope.aliyuncs.com测试网络连通性。问题:Coding Plan API配置后,代码生成指令提示接口不兼容
解决:①确认Base URL为https://coding.dashscope.aliyuncs.com/v1,无多余后缀;②检查模型名称填写为coding-plan-v1,与阿里云官方要求一致;③重启OpenClaw服务,让配置文件生效。
(三)Skills安装与使用类问题
问题:安装Agent Browser后,执行网页操作指令提示依赖缺失
解决:必须执行底层依赖安装命令agent-browser install --with-deps,完成后重启OpenClaw,再测试网页操作指令。问题:安装GitHub技能后,提示无法连接GitHub
解决:①本地需提前安装GitHub CLI工具gh,并完成gh auth login认证;②检查网络是否可访问GitHub,国内网络需配置合规的网络环境;③执行gh auth status验证认证状态,失效则重新执行gh auth login。问题:安装第三方技能时,Skill Vetter提示权限风险
解决:①若为非必要技能,直接放弃安装,避免系统安全风险;②若为必须使用的技能,检查风险项是否为核心功能所需,确认无恶意后,可临时关闭安全扫描(不推荐);③优先选择ClawHub官方认证的技能,避免第三方非合规技能。
(四)系统运行类问题
问题:OpenClaw运行中突然崩溃,提示内存不足
解决:①关闭无关进程,释放系统内存,推荐将本地内存升级至8GB及以上;②阿里云部署则升级服务器配置,从2核2GB升至2核4GB及以上;③减少同时运行的Skills数量,关闭未使用的场景化技能。问题:Windows11系统中,OpenClaw服务无法开机自启
解决:①重新执行openclaw onboard --install-daemon,确保后台服务安装成功;②在Windows服务中找到OpenClaw,将启动类型改为「自动」;③以管理员身份执行sc config openclaw start= auto,通过命令行设置自启。
六、Skills安装与使用安全提醒
- 高权限技能(Agent Browser、Skill Vetter)建议开启操作确认模式,避免AI执行未授权的系统操作;
- 仅安装ClawHub技能市场中通过安全扫描的技能,拒绝来源不明的第三方技能安装包;
- 定期执行
npx clawhub@latest update --all更新技能,修复已知的安全漏洞和功能问题; - 新技能建议先在测试环境安装使用,确认行为符合预期后,再部署至生产环境;
- 云端部署的OpenClaw,测试完成后将防火墙授权对象从0.0.0.0/0改为指定IP,提升公网访问安全性。
OpenClaw的核心价值在于通过可扩展的Skills体系实现AI自动化的个性化定制,完成基础部署和核心技能安装后,可根据自身场景(办公协作、开发、运营、智能家居等)进一步安装场景化技能,同时通过大模型API的灵活配置,平衡模型能力与使用成本。遵循「先地基、再核心、后场景」的原则,即可快速搭建属于自己的AI自动化助理,实现工作与生活的效率提升。