零基础搭建 OpenClaw 智能体:阿里云ECS云服务器实例部署、Token Plan密钥配置完整保姆级新手实操教程

简介: 随着AI智能体技术快速落地,很多开发者、技术爱好者希望搭建具备自主规划、工具调用、多渠道消息交互能力的AI智能体。OpenClaw作为一款开源的AI代理自动化平台,支持持久记忆、联网检索、文件读写、自定义技能插件,还可以对接多种大模型服务,能够自主拆解复杂任务、分步执行操作,是个人开发者与小型团队搭建AI助理的热门选择。如果在本地电脑运行OpenClaw,会受到电脑关机、带宽、硬件性能限制,而在ECS云服务器上部署,可以实现7×24小时不间断在线运行,随时响应指令。同时搭配Token Plan订阅方案,能够享受大模型调用的大幅折扣,在Agent长时间多轮思考、工具调用场景下,显著降低Token

随着AI智能体技术快速落地,很多开发者、技术爱好者希望搭建具备自主规划、工具调用、多渠道消息交互能力的AI智能体。OpenClaw作为一款开源的AI代理自动化平台,支持持久记忆、联网检索、文件读写、自定义技能插件,还可以对接多种大模型服务,能够自主拆解复杂任务、分步执行操作,是个人开发者与小型团队搭建AI助理的热门选择。如果在本地电脑运行OpenClaw,会受到电脑关机、带宽、硬件性能限制,而在ECS云服务器上部署,可以实现7×24小时不间断在线运行,随时响应指令。同时搭配Token Plan订阅方案,能够享受大模型调用的大幅折扣,在Agent长时间多轮思考、工具调用场景下,显著降低Token消耗成本。本文面向零基础新手,全程附带可直接复制的命令,完整讲解ECS实例准备、服务器环境初始化、OpenClaw安装、Token Plan接入配置、Web可视化面板访问、任务测试、后台守护部署、常见故障排查全部流程,哪怕是几乎没有Linux使用经验的新手,按照步骤一步步操作,就可以成功搭建一套可正常使用的OpenClaw智能体。

一、前期准备工作

部署OpenClaw之前,需要完成两项核心准备:创建ECS云服务器实例,在模型服务控制台开通Token Plan套餐,获取专属API Key。

1.1 ECS实例选型与创建

操作系统推荐Ubuntu 22.04 LTS或者Ubuntu 24.04 LTS,这两个版本对Node.js、OpenClaw依赖组件兼容性最好。最低硬件配置推荐2核4G,若计划长时间执行复杂链式任务、开启多轮工具调用,建议选用4核8G规格;系统盘容量至少40G,预留足够空间存放项目文件、日志、插件资源。网络选择专有网络,安全组需要开放22端口用于SSH远程登录,OpenClaw的Web管理面板默认占用18789端口,需要在安全组规则放行该端口,否则外部浏览器无法访问Web界面。

零基础部署AI Agent:OpenClaw/Hermes Agent喂饭级步骤流程

第一步:👉点击打开访问阿里云OpenClaw/Hermes Agent一键部署专题页面
OpenClaw1.png
OpenClaw2.png
OpenClaw02.png
openClaw3.png
OpenClaw031.png
OpenClaw03.png
OpenClaw04.png
OpenClaw5.png
Openclaw6.png

👉访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换,用于多模态模型灵活调用,实现多模型、多工具、多场景下的额度共享与统一管理,兼顾灵活性、稳定性与安全性,大幅降低企业使用大模型的门槛与成本。
tokenplan1.png
tokenplan1.png
tokenplan2.png
tokenplan3.png
tokenplan4.png

第二步:👉打开选择阿里云轻量应用服务器,配置参考如下:

  • 镜像:OpenClaw(或Hermes Agent)镜像(已经购买服务器的用户可以重置系统重新选择镜像)
  • 实例:内存必须2GiB及以上。
  • 地域:默认美国(弗吉尼亚),目前中国内地域(除香港)的轻量应用服务器,联网搜索功能受限。
  • 时长:根据自己的需求及预算选择。

轻量应用服务器OpenClaw镜像.png
bailian1.png
bailian2.png

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

阿里云百炼密钥管理图.png

前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
阿里云百炼密钥管理图2.png

  • 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
  • 配置百炼API-Key,单击一键配置,输入百炼的API-Key。单击执行命令,写入API-Key。
  • 配置OpenClaw/Hermes:单击执行命令,生成访问OpenClaw/Hermes的Token。
  • 访问控制页面:单击打开网站页面可进入OpenClaw/Hermes对话页面。

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

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

  • 购买后,在控制台生成API Key。注:这里复制并保存好你的API Key,后面要用。
    image.png
  • 回到轻量应用服务器-控制台,单击服务器卡片中的实例 ID,进入服务器概览页。
    image.png
  • 在服务器概览页面单击应用详情页签,进入服务器详情页面。
    image.png
  • 端口放通在OpenClaw使用步骤区域中,单击端口放通下的执行命令,可开放获取OpenClaw 服务运行端口的防火墙。
    image.png
  • 这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key,直接选择就可以。
    image.png
  • 获取访问地址单击访问 Web UI 面板下的执行命令,获取 OpenClaw WebUI 的地址。
    image.png
    image.png
    实例创建完成之后,记录实例公网IP地址、登录账号与密码。Windows系统可以使用PowerShell、Xshell等工具远程连接服务器,Mac或者本地Linux系统直接打开终端执行ssh登录命令。
    ssh root@ECS公网IP地址
    
    输入登录密码,成功登录服务器终端,就可以开始后续环境部署操作。

1.2 获取Token Plan的API Key

登录模型服务控制台,进入API Key管理页面,创建Token Plan对应的API密钥。Token Plan分为个人版与团队版,两个版本在支持模型池、额度上限、接口端点地址存在差异。创建密钥之后,务必复制保存API Key,密钥仅在创建弹窗完整展示一次,关闭弹窗之后无法再次查看完整密钥。密钥属于敏感凭证,不要随意对外分享,一旦密钥泄露,其他人可以使用你的套餐额度,产生额外Token消耗。

二、ECS服务器系统环境初始化

全新创建的ECS系统缺少OpenClaw运行所需基础运行库,第一步执行系统软件源更新,安装依赖组件。执行下面命令更新系统包:

apt update && apt upgrade -y

等待系统更新完成,安装基础工具包,OpenClaw基于Node.js开发,需要node、npm运行环境,同时安装git、curl、wget等工具用于拉取代码、测试网络连通性:

apt install git curl wget nodejs npm -y

安装完成之后,校验组件版本,确认环境安装正常:

node -v
npm -v
git --version
curl --version

命令能够正常输出版本号,代表基础依赖安装完成。
为了隔离项目依赖,避免和服务器其他应用包版本冲突,推荐创建独立工作目录,使用npm本地项目环境管理OpenClaw。

mkdir -p ~/openclaw-workspace
cd ~/openclaw-workspace

国内网络环境下,npm默认源下载速度较慢,切换国内镜像源加速包下载,避免安装超时失败:

npm config set registry https://registry.npmmirror.com

三、OpenClaw安装与版本校验

OpenClaw支持npm包管理器直接安装,在当前工作目录执行安装命令:

npm install -g openclaw

等待包下载、依赖解析完成,安装结束,执行版本查看命令,验证OpenClaw是否安装成功:

openclaw --version

正常输出版本号,代表安装成功。如果提示command not found,说明npm全局安装路径未加入系统环境变量,可以执行下面命令,查看npm全局安装路径,添加到环境变量:

npm config get prefix

除了npm全局安装,也可以使用源码方式部署,适合想要自定义插件、修改底层代码的开发者:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build
npm link

源码部署完成之后,同样执行openclaw --version验证安装状态。

四、核心配置:OpenClaw对接Token Plan

这是整套部署流程的核心环节,修改OpenClaw配置文件,填入Token Plan的接口地址、API密钥,让OpenClaw通过Token Plan套餐调用大模型。OpenClaw的配置文件为openclaw.json,存放在~/.openclaw/目录下,可以直接使用vim编辑器编辑配置文件。

vim ~/.openclaw/openclaw.json

写入Token Plan对应的模型配置,将YOUR_API_KEY替换成你从控制台复制的密钥:

{
   
  "models": {
   
    "mode": "merge",
    "providers": {
   
      "bailian-token-plan": {
   
        "baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-completions",
        "models": [
          {
   
            "id": "qwen3.8-flash",
            "name": "qwen3.8-flash",
            "reasoning": false,
            "contextWindow": 1000000,
            "maxTokens": 65536
          },
          {
   
            "id": "qwen3.8-max",
            "name": "qwen3.8-max",
            "reasoning": true,
            "contextWindow": 1000000,
            "maxTokens": 65536
          }
        ]
      }
    },
    "defaultProvider": "bailian-token-plan",
    "defaultModel": "qwen3.8-flash"
  },
  "gateway": {
   
    "mode": "standalone",
    "port": 18789
  }
}

配置文件参数说明:
baseUrl为Token Plan兼容模式接口地址,个人版与团队版接口地址存在差异,需要对照控制台信息填写;apiKey填写Token Plan密钥;models数组内可以添加套餐支持的全部模型,qwen系列、DeepSeek Flash系列模型都可以直接使用;defaultModel设置智能体默认调用模型,Flash系列模型响应更快,Token消耗更低,适合日常自动化任务;gateway.port定义Web面板监听端口,默认18789,需要在ECS安全组放行该端口。

保存并退出编辑器,执行诊断命令,自动校验配置文件、修复配置异常,生成访问Web面板的认证令牌:

openclaw doctor --fix

执行完成之后,可以查看配置文件,确认参数写入无误:

cat ~/.openclaw/openclaw.json

五、测试连通性,验证模型调用

配置完成之后,先执行命令行对话测试,验证OpenClaw能否正常通过Token Plan调用大模型,确认整个链路是否连通。

openclaw chat -q "介绍你的能力,说明你可以完成哪些自动化任务"

等待几秒,终端返回OpenClaw的回答,代表接入成功。如果返回报错,优先核对API Key是否复制完整,有没有多余空格换行;检查baseUrl地址与套餐地域匹配;确认Token Plan套餐状态,套餐是否过期、额度是否耗尽。

也可以进入交互式对话模式,持续多轮对话,OpenClaw会自动维护会话上下文,记住对话历史:

openclaw chat

进入交互模式后,直接输入任务指令,OpenClaw会自主拆解任务,调用内置工具完成操作。
临时切换模型只需要在命令增加-m参数,示例:

openclaw chat -m qwen3.8-max -q "编写Python脚本,遍历指定目录,统计所有txt文件行数"

六、启动Web可视化管理面板

OpenClaw内置Web可视化面板,浏览器访问即可管理智能体、查看对话历史、查看任务执行日志、开启插件,操作门槛更低,适合新手使用。执行命令启动Web服务:

openclaw start

启动成功后,终端会输出访问地址和访问令牌,打开浏览器访问http://ECS公网IP:18789,输入令牌登录Web管理界面。
在Web面板中,可以切换模型、开启联网搜索、文件读写插件、配置消息渠道,直接在网页发起任务指令,查看Agent任务执行全过程。

重要提醒:Web面板的访问令牌不要对外泄露,防止他人未经授权访问你的OpenClaw智能体,执行高危操作。

七、配置后台守护进程,实现7×24小时常驻运行

SSH终端窗口关闭之后,默认前台运行的OpenClaw进程就会终止。想要让智能体持续后台运行,推荐使用systemd配置系统守护服务,实现开机自动启动,进程异常崩溃自动重启。

创建systemd服务文件:

vim /etc/systemd/system/openclaw.service

写入服务配置内容:

[Unit]
Description=OpenClaw AI Agent Service
After=network.target

[Service]
User=root
WorkingDirectory=/root/openclaw-workspace
ExecStart=/usr/local/bin/openclaw start
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

保存退出,执行命令重载系统服务配置,启用并启动OpenClaw后台服务:

systemctl daemon-reload
systemctl enable openclaw
systemctl start openclaw

查看服务运行状态,确认服务正常运行:

systemctl status openclaw

看到active(running),代表后台服务启动成功。查看实时运行日志,用于排查调用报错:

journalctl -u openclaw -f

八、Token Plan计费、额度管理与成本控制

Token Plan是订阅式节省方案,相比普通按量计费,能够大幅降低大模型调用成本,非常适合OpenClaw这类持续多轮思考、频繁工具调用的Agent场景。OpenClaw在执行复杂任务时,会多次调用大模型进行任务规划、结果校验,Token消耗速度远高于普通单次问答,部分场景还支持输入缓存优惠,进一步减少开销。

开发者可以在模型控制台查看调用明细、Token消耗统计,设置额度告警,防止超额消耗。建议新手设置额度上限,避免复杂任务产生意料之外的消耗。
在OpenClaw配置文件中,可以灵活切换模型,Flash系列轻量化模型推理速度更快,单位任务Token消耗更低,适合日常自动化任务;Max系列模型推理能力更强,适合复杂逻辑推理、代码开发类任务。

九、新手高频故障排查指南

问题1:openclaw命令找不到

大概率是npm全局安装路径未加入系统环境变量。执行npm config get prefix查看npm全局路径,将路径添加到~/.bashrc环境变量文件,执行source ~/.bashrc生效。

问题2:API鉴权失败,调用模型返回401错误

检查API Key复制是否完整,有没有多余换行空格;核对baseUrl地址和套餐地域匹配;确认Token Plan套餐没有过期,套餐额度没有耗尽。

问题3:Web面板无法访问

第一,检查ECS安全组是否放行18789端口;第二,确认openclaw服务正常启动,使用systemctl status openclaw查看进程状态;第三,使用curl测试端口连通性:

curl http://127.0.0.1:18789

本地curl访问正常,说明服务正常,问题出在安全组或者防火墙。

问题4:任务执行缓慢,模型响应超时

执行top命令查看服务器CPU、内存占用情况:

top

内存占用过高,建议升级ECS实例规格;也可以切换Flash轻量化模型,降低资源消耗,提升响应速度。同时检查服务器出口网络,测试接口连通性:

curl https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1

问题5:systemd服务启动失败

执行journalctl -u openclaw查看详细报错日志,检查ExecStart路径是否和npm全局openclaw实际路径一致;检查openclaw.json配置文件,JSON格式语法错误、缺少逗号引号,都会导致启动失败。JSON配置文件对语法要求严格,不能随意添加多余逗号。

问题6:Agent无法读取本地文件、执行系统操作

OpenClaw默认会做安全权限限制,需要在Web面板或者配置文件开启文件读写插件,同时限制可访问目录,不要直接给Agent开放服务器根目录全部权限,防止执行危险指令。

十、OpenClaw应用场景与生产环境优化建议

部署完成OpenClaw智能体之后,就可以用来执行各类自动化任务:批量文档整理、代码项目审查、数据文件解析、信息检索汇总、定时任务编排。OpenClaw支持插件扩展,可对接消息渠道,实现消息触发自动执行任务,把智能体集成到日常工作流中。

本文这套教程适合开发测试场景,如果要长期线上业务使用,还需要做更多安全优化:精细化配置防火墙,最小化开放端口;密钥使用环境变量注入,不要明文写在配置文件;配置日志轮转,防止日志文件占满服务器磁盘;增加进程监控,异常告警;限制Agent操作目录,做好权限隔离,降低误操作风险。

新手使用OpenClaw建议循序渐进,先在命令行做简单问答测试,确认Token Plan调用链路稳定之后,再尝试复杂任务、Web可视化面板,最后配置systemd后台常驻。不要一次性给智能体分配过高服务器权限,避免Agent自主执行高危系统命令。

十一、总结

整套流程从ECS实例准备、系统环境初始化、Node环境配置、OpenClaw安装、Token Plan接入配置、对话功能验证、Web面板部署,再到后台守护进程配置,完整实现了在云服务器搭建具备自主任务执行能力的AI智能体。整套方案不需要高性能本地硬件,依靠ECS算力搭配Token Plan订阅套餐,就可以低成本搭建全天候在线的OpenClaw智能体。

OpenClaw强大的任务拆解、工具调用、持久记忆能力,让自动化工作流落地变得简单,而Token Plan订阅方案,有效降低Agent长时间运行带来的大模型调用开销。在实际使用过程中,可以不断调整模型参数、切换不同大模型,编写自定义提示词、开发专属插件,扩展智能体能力边界。遇到报错优先查看终端日志、模型接口返回信息,绝大多数新手问题集中在环境变量、密钥配置、安全组端口三个方面,按照本文排错步骤逐一排查,基本都可以顺利解决。随着对OpenClaw熟悉之后,还可以扩展消息渠道,对接各类消息平台,实现更多场景下的自动化智能交互,将AI智能体融入日常工作、开发流程。

目录
相关文章
|
7天前
|
人工智能 API 内存技术
刚刚 DeepSeek V4.1 Flash 开启内测,1 分钟教你用上!
刚刚 DeepSeek 内测群发布了 DeepSeek V4.1 Flash 中间版本内测的消息,这次的模型采用了新的结构,原生支持多模态、能力更强、速度更快、且成本更低。
1776 10
|
11天前
|
人工智能 运维 BI
阿里云千问办公QwenWork深度解析:基于Qwen3.8,六大核心能力重构企业全自动化工作流与计费选型指南
传统AI办公工具大多停留在对话问答、文档摘要、简单文案生成层面,只能完成单点碎片化任务,无法自主拆解复杂业务流程,很难串联多工具、多文档、外部业务系统完成端到端完整工作交付。很多企业在落地AI办公的时候,需要组合多款不同工具,来回切换界面,手动复制粘贴中间结果,智能化改造落地门槛居高不下。千问办公QwenWork是整合多款智能体产品能力打造的一体化企业办公智能体平台,底层基座依托Qwen3.8大模型,打通桌面端Agent、云端Agent、企业协同Agent三种运行形态,不再局限简单问答,接收业务目标之后自主拆解任务步骤,调用各类工具,处理文档、表格、浏览器自动化、数据查询,直接输出可交付的办公
1643 3
|
12天前
|
网络协议 Linux iOS开发
【2026实测】Wireshark下载+安装+汉化+使用教程(图文版,巨详细)
Wireshark 是一款免费开源的网络协议分析工具,可实时捕获、解析并可视化数据包,助你诊断网络故障、分析通信协议(如HTTP、DNS、TCP等)。支持Windows/macOS/Linux,含中文界面,新手入门便捷。(239字)
|
8天前
|
SQL 人工智能 前端开发
QoderWake 1.0 正式发布:从桌面里的 Agent,到工作现场的数字员工
QoderWake v1.0正式发布:企业级数字员工团队平台。支持“一句话建岗”,预置10类特训岗位;Waker常驻钉钉/飞书群,@即响应、自动协作、跨任务记忆;具备定时/事件/API多触发方式与统一任务看板;已沉淀27.6万条记忆、12.3万项技能,助力组织实现人机协同增效。
778 2
|
6天前
|
缓存 测试技术 API
DeepSeek V4.1 Flash 内测接入:改个模型名即可调用(附代码)
DeepSeek V4.1 Flash 内测不用申请,base_url 不变、改个模型名就能调,9/10 到期。本文讲清接入、计费限流与多模态注意点。
800 0
DeepSeek V4.1 Flash 内测接入:改个模型名即可调用(附代码)
|
20天前
|
人工智能 自然语言处理 安全
阿里云千问办公、Qoder Teams、Qoder CN区别与选择指南:模型能力、适用场景与最新活动参考
本文聚焦阿里云2026年推出的三款自研AI办公产品,清晰拆解千问办公、Qoder Teams、Qoder CN的差异化定位与能力边界:千问办公主打职场全场景提效,支持自然语言指令一键完成PPT生成、数据分析等高频办公任务;Qoder Teams面向程序员团队,深度整合AI代码生成、团队协同与企业知识库能力;Qoder CN则专为金融、政务等强合规场景打造,实现数据不出境与VPC私有化部署。文章同步给出分场景选型指南与最新活动定价,帮助不同类型的企业按需组合产品,实现业务岗、研发岗与强合规场景的AI能力全覆盖。
3963 5
阿里云千问办公、Qoder Teams、Qoder CN区别与选择指南:模型能力、适用场景与最新活动参考
|
11天前
|
人工智能 自然语言处理 安全
阿里云AI数智鉴密:AI 生成内容如何拿到一张"防篡改的身份证"
隐形水印 + C2PA签名:让AI生成内容“持证上岗”。
1155 0
|
13天前
|
缓存 数据可视化 开发工具
DeepSeek Harness 怎么更新?dsh 更新完整指南:更新本体(npx、npm、源码)与更新插件两种方式
DeepSeek Harness 的更新分两层:本体更新(npx 自动最新、npm update -g、源码 git pull)与插件更新(插件市场点更新、命令行覆盖安装)。本文按「准备 → 更新本体 → 更新插件 → 更新后检查」四步走,覆盖新手常见疑问。
1492 1
DeepSeek Harness 怎么更新?dsh 更新完整指南:更新本体(npx、npm、源码)与更新插件两种方式
|
6天前
|
人工智能
千问办公官网入口:阿里AI办公QwenWork产品页和免费网页端链接
千问办公官网含两大入口:一是网页端(qwenwork.cn),即开即用,支持浏览器直接访问;二是阿里云产品页 https://t.aliyun.com/U/JNKJuO 提供免费/付费版详情、功能介绍及使用指南。

热门文章

最新文章