OpenClaw 是什么?阿里云/本地部署OpenClaw /Hermes Agent保姆级图文教程

简介: 在2026年开源AI领域,OpenClaw无疑是最具影响力的项目之一,其前身为Clawdbot,历经品牌迭代后统一定名,凭借“低门槛、强执行、可自托管”的核心优势,快速成为个人与轻量团队的首选AI自动化工具。很多新手初次接触时,常会混淆“OpenClaw”与“Clawdbot”的关系,不清楚其核心价值的区别于普通AI工具,更不知道如何快速完成部署落地。

在2026年开源AI领域,OpenClaw无疑是最具影响力的项目之一,其前身为Clawdbot,历经品牌迭代后统一定名,凭借“低门槛、强执行、可自托管”的核心优势,快速成为个人与轻量团队的首选AI自动化工具。很多新手初次接触时,常会混淆“OpenClaw”与“Clawdbot”的关系,不清楚其核心价值的区别于普通AI工具,更不知道如何快速完成部署落地。
OpenClawo.png
事实上,OpenClaw与Clawdbot本质是同一产品的不同名称,2026年初因商标合规问题,Clawdbot先后更名为Moltbot,最终确定“OpenClaw”作为官方名称,核心功能、运行逻辑与技术架构完全一致,仅品牌标识发生变化。与传统聊天式AI不同,OpenClaw并非单纯的对话工具,而是一套开源的AI代理平台,无需编程基础,仅用自然语言指令就能实现任务规划、工具调用、结果反馈的全闭环,真正让AI从“只会说话的嘴”变成“能办实事的手”,适配办公自动化、开发辅助、生活服务等多类场景。

本文将先全面解析OpenClaw(Clawdbot)的核心定义、技术架构、核心功能,再详细拆解2026年阿里云轻量服务器部署与本地私有化部署的完整流程,每一步均配套可直接复制执行的代码命令,兼顾新手友好性与实操性,同时结合2026年最新版本特性,补充常见问题排查与优化技巧,助力所有用户零门槛完成部署,充分发挥这款开源AI工具的核心价值,覆盖部署全场景、全流程。阿里云部署 OpenClaw/Hermes Agent全网最简单,只需两步,详情👉访问阿里云OpenClaw/Hermes一键部署专题页面 了解。
OpenClaw1.png
OpenClaw2.png
OpenClaw02.png
openClaw3.png

OpenClaw031.png
OpenClaw03.png
OpenClaw04.png
OpenClaw5.png
Openclaw6.png

一、核心解析:OpenClaw(Clawdbot)是什么?

(一)名称渊源与核心定位

OpenClaw的前身是Clawdbot,由PSPDFKit创始人Peter Steinberger主导开发,最初是一个个人实验项目,2025年12月开源后凭借强大的自动化能力快速走红,短短几天内GitHub星标数直冲15万,成为2026年开源项目增长速度第一的AI类产品,目前全球已有超100万独立部署实例,涵盖个人用户、小团队与初创企业。2026年1月底,因商标相关问题,项目先后更名为Moltbot,最终统一确定为“OpenClaw”,既保留了初代设计的“龙虾(Claw)”吉祥物,又突出了开源(Open)的核心属性,目前官网、GitHub、文档与社区生态已完成全维度名称统一。

对于新手而言,无需纠结名称差异,2026年部署使用的OpenClaw,就是Clawdbot、Moltbot的迭代升级版,核心功能、操作逻辑完全一致,旧版用户无需重新学习,新手直接部署最新版OpenClaw即可,后续可通过简单配置切换至旧版称呼,适配个人使用习惯。

从核心定位来看,OpenClaw与普通聊天AI有着本质区别:普通聊天AI(如ChatGPT、Claude)仅能实现对话交流、信息查询,无法执行实际操作,属于“被动应答”模式;而OpenClaw是一套开源本地优先的AI代理平台,核心定位是“能干活的数字员工”,采用“用户交互-任务规划-工具执行-结果反馈”的极简闭环架构,能自动拆解复杂指令,调用各类工具完成实际操作,属于“主动执行”模式。

简单来说,你可以将OpenClaw理解为一位无需薪资、全年无休的专属助手,它能进驻你日常使用的通讯工具(如Telegram、钉钉),接收自然语言指令后,直接动手执行任务——比如帮你整理电脑文件夹、生成代码并调试、每天自动汇总行业简报、甚至远程操控设备,真正实现“解放双手”的核心价值,这也是它能快速爆火的关键原因。

需要注意的是,OpenClaw本身不具备独立的大语言模型推理能力,需对接阿里云百炼、Ollama等大模型平台,通过API-Key获取授权,调用通义千问、Gemini等系列模型,实现自然语言理解与任务执行的协同,这也是后续部署过程中的核心环节,同时2026年最新版本已新增对Google Gemini 3.1、火山引擎等模型的支持,进一步扩展了适配范围。

(二)核心技术架构与优势

OpenClaw采用解耦式模块化设计,各组件独立部署、可灵活替换,核心架构围绕“能听、能想、能做、能记”四大能力展开,拆解为四大核心模块,协同实现自动化执行闭环,具体如下:

  1. 多渠道网关(前台):作为OpenClaw的“统一入口”,负责适配不同聊天工具的通信协议,将用户自然语言消息转发至核心执行层,同时将执行结果格式化后推送给用户,支持Telegram、Discord、钉钉等多平台接入,实现“一处指令,全域响应”,可独立部署在云端实现远程指挥。2026年最新版本对Telegram、Discord渠道进行了大规模优化,新增生命周期状态表情反应、语音通道管理等功能,提升交互体验。
  2. 大模型推理内核(大脑):作为“思考中枢”,集成了国内外主流大模型,用户可根据需求和预算灵活切换,核心作用是对用户的自然语言指令进行理解、拆解和规划。比如当你下达“帮我分析本周行业热点并写一篇推文”的指令时,大脑会先拆解任务——抓取资讯、筛选热点、确定主题、撰写内容,再制定执行步骤,传递给执行层。
  3. 可插拔技能库(双手):这是OpenClaw实现“执行能力”的核心,也是区别于传统大模型的关键。所有能力均以Skill形式实现,支持单文件脚本、MCP协议开发,社区技能市场ClawdHub已有超千款现成技能,可一键安装,也可自定义开发专属技能,涵盖浏览器操作、Shell命令执行、邮件管理、代码生成等各类场景,能将大脑的“想法”转化为实际行动。
  4. 双模记忆系统(档案柜):采用“短期上下文记忆+长期持久化记忆”的双模架构,短期记忆通过内存缓存,保存72小时内的对话上下文,确保多轮交互的连贯性;长期记忆通过SQLite数据库和Markdown文件本地存储,永久保存用户的偏好、习惯、重要决策和任务记录,实现“越用越聪明”的效果。更重要的是,所有记忆数据均存储在用户本地设备或自托管服务器中,无需上传云端,保障数据隐私安全,这也是OpenClaw的核心竞争力之一。

相较于同类AI代理工具,OpenClaw的核心优势可概括为三点:一是低门槛上手,无需编程基础,无需手动编写脚本,仅用自然语言即可下达指令,新手零学习成本;二是高适配场景,兼容阿里云各类服务器环境与Windows、macOS、Linux三大桌面系统,支持集成办公软件、通讯工具,适配个人办公、团队协作、基础开发等多类场景;三是强扩展性,开源特性允许开发者自定义开发技能插件,同时支持多模型并行推理,可将不同任务分配给不同模型执行,灵活适配各类需求,2026年最新版本还新增了技能权限精细化控制、安全沙盒等功能,进一步提升使用安全性与稳定性。

(三)2026年最新版本核心功能(部署即能用)

结合2026年最新发布的OpenClaw v2026.2.21版本特性,其功能围绕“自动化”与“多工具协同”展开,覆盖个人与轻量团队高频需求,无需复杂配置,部署完成后即可直接使用,核心功能分为四大类,每类均配套简易调用指令,直接发送至聊天工具或Web控制台即可触发执行,具体如下:

  1. 基础办公自动化:这是最常用的功能,涵盖文档处理、文件管理、日程管理三大场景。文档处理方面,可生成、编辑、格式转换各类文档(Word、Excel、PDF、Markdown),支持读取PDF核心内容并生成摘要、将Excel数据可视化;文件管理方面,可自动分类电脑或服务器中的文件、批量重命名、筛选指定类型文件;日程管理方面,可创建会议、设置日程提醒、检测日程冲突,甚至自动发送会议邀请,适配日常办公场景。
  2. 跨工具协同操作:支持对接钉钉、企业微信等通讯工具,关联WPS、Office等办公套件,实现跨平台任务协同,无需频繁切换应用。比如可指令OpenClaw读取钉钉群聊消息,自动汇总核心内容生成日报;或调用WPS生成文档后,直接发送至指定通讯群组,大幅提升办公效率。
  3. 开发辅助功能:适配开发者日常需求,可生成基础代码片段(支持Python、Java、JavaScript等主流语言)、解释代码含义、排查基础语法错误、分析服务器日志,还能执行Shell命令、调试脚本,甚至生成测试用例,减少重复性开发工作。2026年最新版本新增了代码生成变种模型支持,进一步提升代码生成的准确性与实用性。
  4. 轻量定制化与生活服务:支持接入私有知识库,导入本地文档(PDF、Word、TXT等),实现精准检索与内容总结;可自定义自动化规则,比如每日固定时间汇总行业资讯、自动回复未读邮件;同时支持简单的生活服务类任务,比如查询天气、预订机票、整理出行攻略等,适配个人生活场景。

此外,2026年最新版本还优化了记忆引擎、增强了安全机制,新增了60余项安全加固,涵盖网关、Docker、命令执行、文件系统等核心环节,同时支持多模型并行推理、技能权限精细化控制,进一步提升了工具的稳定性、安全性与实用性,让普通用户也能安全、高效地使用AI执行能力。

二、2026年OpenClaw(Clawdbot)阿里云轻量服务器部署流程(保姆级,零门槛)

阿里云轻量服务器部署是最适合新手的方案,依托阿里云预置的OpenClaw镜像,无需手动配置复杂环境,全程可视化操作,15-20分钟即可完成部署,核心优势是“零技术门槛、高稳定性、多设备远程访问”,适合追求便捷性、需要7×24小时稳定运行的用户,无论是个人日常使用还是轻量团队协作,都能完美适配。

(一)部署前准备(必做,避免后续踩坑)

  1. 阿里云账号:注册阿里云账号,完成注册与实名认证,个人用户可通过身份证刷脸、支付宝授权快速验证,企业用户需上传相关资质审核,实名认证是服务器购买与使用的前提,不可跳过。
  2. 服务器配置选择:优先选择阿里云轻量应用服务器,结合2026年OpenClaw最新版本需求,基础配置即可满足个人日常使用,核心配置推荐:2vCPU+2GiB内存+40GiB ESSD云盘+200Mbps峰值带宽;若需同时运行多模型、多技能,或用于团队协作,可升级至4vCPU+4GiB内存,提升运行流畅度。
  3. 地域选择:优先选择中国香港、美国弗吉尼亚等免备案地域,购买后可直接使用,无需等待ICP备案;国内地域(除香港外)需完成ICP备案后才能正常访问,备案流程通常需要3-7个工作日,适合有国内访问需求的用户。
  4. 核心凭证:阿里云百炼API-Key,这是OpenClaw调用大模型的关键,获取路径:访问登录阿里云百炼大模型服务平台→进入“密钥管理”模块→点击“创建API-Key”,创建后立即复制保存(刷新页面后无法再次查看),建议保存至加密记事本,避免泄露。
  5. 工具准备:SSH工具(推荐FinalShell、Xshell,免费且易用)、Chrome/Edge浏览器、截图工具(记录服务器公网IP、Token等关键参数)、加密记事本(保存API-Key、Token等敏感信息)。
  6. 其他准备:确保阿里云账号余额充足,用于支付服务器费用(基础配置月付约50-80元,年付更优惠);提前关闭本地电脑的防火墙(避免无法访问服务器),若使用公司网络,需确认网络未限制SSH连接(端口22)与OpenClaw服务端口(18789)。

(二)分步部署流程(全程可复制,零编程基础)

新手零基础阿里云上部署OpenClaw喂饭级步骤流程

第一步:访问阿里云OpenClaw一键部署专题页面,找到并点击【一键购买并部署】。
阿里云OpenClaw一键部署专题页面:https://www.aliyun.com/activity/ecs/clawdbot
OpenClaw1.png
OpenClaw02.png
OpenClaw2.png
第二步:选购阿里云轻量应用服务器,配置参考如下:

  • 镜像:OpenClaw(Moltbot)镜像(已经购买服务器的用户可以重置系统重新选择镜像)
  • 实例:内存必须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:单击执行命令,生成访问OpenClaw的Token。
  • 访问控制页面:单击打开网站页面可进入OpenClaw对话页面。

步骤1:购买阿里云轻量应用服务器并选择预置镜像

  1. 登录阿里云控制台,在顶部搜索栏输入“轻量应用服务器”,进入对应模块,点击页面右上角“创建实例”,进入购买页面。
  2. 核心配置逐项选择(按以下参数选择,避免配置错误):
    • 地域:选择“中国香港”或“美国弗吉尼亚”(免备案,优先推荐中国香港,访问速度更快);
    • 镜像类型:选择“应用镜像”,在搜索框输入“OpenClaw(Clawdbot)-2026汉化版”,选择对应镜像(确保镜像版本为2026年最新版,适配阿里云百炼大模型);
    • 实例规格:基础配置(2vCPU+2GiB内存)、5Mbps带宽、40GB高效云盘(可根据需求调整,基础配置足够个人使用);
    • 购买时长:根据自身需求选择,新手可先购买1个月测试,长期使用建议购买1年,享受年付优惠;
    • 密码设置:设置服务器登录密码(建议包含大小写字母、数字、特殊符号,提升安全性),或选择“密钥登录”(更安全,适合有一定技术基础的用户);
  3. 确认配置无误后,点击“立即购买”,完成支付后,返回轻量应用服务器控制台,等待5-10分钟,实例状态变为“运行中”,记录服务器公网IP(如47.xxx.xxx.xxx),后续所有操作均需使用该IP。

步骤2:服务器初始化配置(SSH远程连接,代码可直接复制)

  1. 打开SSH工具(以FinalShell为例),点击“新建连接”,选择“SSH连接”,填写相关参数:
    • 主机:输入服务器公网IP;
    • 端口:默认22(无需修改);
    • 用户名:默认root(阿里云轻量服务器默认用户名);
    • 密码:输入购买服务器时设置的密码;
  2. 点击“连接”,首次连接会弹出“是否信任该主机”的提示,点击“确认”,成功连接后,终端会显示root@xxx的命令行提示符,此时即可执行服务器配置命令。
  3. 执行以下命令,一键更新系统依赖(适配阿里云源,避免依赖冲突,确保OpenClaw正常运行):
    yum update -y --disablerepo=* --enablerepo=aliyunos,epel
    
  4. 放行OpenClaw核心服务端口(18789为OpenClaw默认服务端口,必须放行,否则无法访问Web控制台),执行以下命令:
    # 放行18789端口(TCP协议,永久生效)
    firewall-cmd --add-port=18789/tcp --permanent
    # 重新加载防火墙配置,使端口放行生效
    firewall-cmd --reload
    # 验证端口放行状态(输出18789/tcp即为成功)
    firewall-cmd --list-ports | grep 18789
    
  5. 查看OpenClaw服务状态(阿里云预置镜像已默认安装OpenClaw,无需手动安装,只需确认服务正常启动):
    systemctl status openclaw
    
    • 若输出“active(running)”,说明服务已正常启动;若显示“inactive(dead)”,执行以下命令重启服务:
      systemctl start openclaw
      
  6. (可选)设置OpenClaw服务开机自启,避免服务器重启后服务失效:
    systemctl enable openclaw
    

步骤3:配置阿里云百炼API-Key(激活AI能力,核心步骤)

OpenClaw本身不具备推理能力,需配置阿里云百炼API-Key,对接通义千问等大模型,才能实现自然语言理解与任务执行,这一步是部署的核心,不可跳过。

  1. 执行以下命令,进入OpenClaw容器环境(阿里云预置镜像采用Docker容器部署,核心配置需在容器内完成):
    docker exec -it openclaw-core /bin/bash
    
    • 执行后,终端提示符会变为root@容器ID,说明已成功进入容器环境。
  2. 配置阿里云百炼API-Key,将以下命令中的“你的阿里云百炼API-Key”替换为你提前保存的API-Key,执行命令:
    openclaw config set models.providers.bailian.apiKey "你的阿里云百炼API-Key"
    
  3. 设置默认模型(适配中文场景,提升交互体验,选择阿里云百炼旗下的通义千问模型,无需额外配置):
    openclaw config set agents.defaults.model.primary "bailian/qwen3-max-2026-01-23"
    
  4. (可选)配置模型缓存,减少API调用次数,降低使用成本(缓存1天,可根据需求调整):
    openclaw config set model.cache.enabled true --json
    openclaw config set model.cache.ttl 86400 --json
    
  5. 重启OpenClaw服务,使配置生效:
    openclaw gateway restart
    
  6. 执行以下命令,退出容器环境,返回服务器终端:
    exit
    

步骤4:生成访问Token并验证部署(确认部署成功)

  1. 生成管理员Token(用于登录OpenClaw Web控制台,Token是唯一登录凭证,需妥善保存),执行以下命令:
    docker exec -it openclaw-core openclaw token generate --admin
    
    • 执行后,终端会输出一串字符串(即管理员Token),复制该Token,保存至加密记事本,丢失后可重新生成。
  2. 访问验证:打开Chrome/Edge浏览器,在地址栏输入“http://你的服务器公网IP:18789/?token=你的管理员Token”,替换对应参数后,按下回车,若能成功进入OpenClaw Web控制台(界面显示“OpenClaw管理后台”,包含指令输入框、技能管理、配置中心等模块),说明部署成功。
  3. (可选)绑定Telegram/Discord等通讯工具,实现多渠道指令下达,以Telegram为例,执行以下命令(需提前通过@BotFather创建Telegram Bot,获取Bot Token):
    # 进入容器环境
    docker exec -it openclaw-core /bin/bash
    # 配置Telegram Bot Token
    openclaw config set channels.telegram.botToken "你的Telegram Bot Token"
    # 重启服务生效
    openclaw gateway restart
    # 退出容器
    exit
    
    • 配置完成后,私聊Telegram Bot,发送自然语言指令,即可触发OpenClaw执行任务,实现多渠道协同。

步骤5:功能测试(确保核心功能正常,新手必做)

登录Web控制台后,发送3条测试指令,验证核心功能正常,避免后续使用时出现问题:

  1. 文档处理测试:在指令输入框输入“帮我生成一份季度工作总结模板,包含工作成果、不足与改进计划,保存为Word格式”,点击发送,查看OpenClaw是否能生成符合要求的文档,并保存至服务器指定目录。
  2. 数据处理测试:输入“统计10、20、30、40、50的平均值、最大值、最小值,生成简单统计报告”,验证AI是否能正确解析指令,输出准确的统计结果。
  3. 基础操作测试:输入“帮我在服务器/app目录下创建一个名为openclaw-test的文档,内容为OpenClaw阿里云部署测试成功”,执行后,通过SSH工具登录服务器,执行以下命令,查看文档是否创建成功:
    cat /app/openclaw-test.txt
    
    • 若能正常显示文档内容,说明基础操作功能正常。

(三)阿里云部署优化技巧(提升使用体验,可选)

  1. 日志管理:OpenClaw的运行日志默认存储在容器内,可通过以下命令查看实时日志,便于排查问题:
    # 实时查看OpenClaw运行日志
    docker exec -it openclaw-core openclaw logs --follow
    
  2. 定期备份配置:避免配置丢失,可通过以下命令将OpenClaw配置文件备份至服务器本地:
    # 备份配置文件至/root目录
    docker cp openclaw-core:/app/config /root/openclaw-config-backup
    
  3. 版本更新:2026年OpenClaw更新频率较高,可通过以下命令更新至最新版本,获取新增功能与安全修复:
    # 进入容器环境
    docker exec -it openclaw-core /bin/bash
    # 更新OpenClaw至最新版本
    openclaw update
    # 重启服务生效
    openclaw gateway restart
    # 退出容器
    exit
    
  4. 端口自定义:若18789端口被占用,可通过以下命令修改服务端口(以修改为18790为例):
    # 进入容器环境
    docker exec -it openclaw-core /bin/bash
    # 修改服务端口
    openclaw config set gateway.port 18790 --json
    # 重启服务生效
    openclaw gateway restart
    # 退出容器
    exit
    # 放行新端口(18790)
    firewall-cmd --add-port=18790/tcp --permanent
    firewall-cmd --reload
    

三、2026年OpenClaw(Clawdbot)本地部署流程(私有化,隐私可控)

本地部署的核心优势是“数据隐私可控、无服务器成本”,所有数据(记忆、配置、任务记录)均存储在本地设备中,无需上传云端,适合处理敏感任务、需要离线使用的用户,支持Windows、macOS、Linux三大系统,全程包含详细代码命令,新手可逐步操作,部署完成后可断开网络使用(仅模型调用需联网,若使用本地模型如Ollama,可完全离线)。

(一)部署前准备(必做,按系统适配)

  1. 硬件要求:CPU≥Intel i5/Ryzen 5(或2核以上),内存≥4GB(推荐8GB,避免运行卡顿,多模型、多技能同时运行建议16GB),磁盘预留≥20GB SSD(OpenClaw源码、依赖、模型缓存等需占用一定空间)。
  2. 软件要求:Docker(20.10.0+)、Docker Compose(2.0.0+)、Python 3.9+、Git、Node.js(v22.0.0+)、pnpm,不同系统的安装方式不同,后续步骤会详细说明,确保所有软件版本符合要求,否则会导致部署失败。
  3. 核心凭证:阿里云百炼API-Key(与阿里云部署通用,无需重复创建);若使用本地模型(如Ollama),可无需API-Key,直接部署本地模型即可。
  4. 网络要求:部署时需联网下载OpenClaw源码、依赖包与Docker镜像,部署完成后可断开网络(仅调用云端模型时需联网,本地模型可完全离线)。
  5. 工具准备:终端工具(Windows用管理员PowerShell,macOS/Linux用自带终端)、浏览器、加密记事本(保存API-Key、Token等敏感信息)。
  6. 其他准备:关闭本地电脑的防火墙(避免端口被拦截);Windows用户需启用WSL2(适配Docker运行,否则无法正常启动容器);macOS用户需开启Docker的“允许来自网络的连接”权限。

(二)分步部署流程(分系统操作,代码可直接复制)

步骤1:安装基础依赖(分系统执行,关键步骤)

基础依赖是OpenClaw正常运行的前提,不同系统的安装命令不同,严格按照以下命令执行,避免依赖缺失或版本不兼容。

方案1:Linux/macOS系统(一键安装,推荐)
  1. 打开终端,执行以下命令,安装Docker(采用阿里云镜像,提升下载速度,避免官方镜像下载卡顿):
    curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
    
  2. 启动Docker服务并设置开机自启:
    # 启动Docker服务
    systemctl start docker
    # 设置开机自启
    systemctl enable docker
    
  3. 安装Python 3.9+、Git、Node.js与pnpm:
    # 更新系统依赖
    apt update && apt upgrade -y
    # 安装Python 3.9+与Git
    apt install python3.9 python3.9-pip git -y
    # 安装Node.js(v22.0.0+)
    curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
    sudo apt install -y nodejs
    # 安装pnpm
    npm install -g pnpm
    # 配置pnpm国内镜像,提升依赖下载速度
    pnpm config set registry https://registry.npmmirror.com/
    
  4. 验证依赖安装成功(输出版本号即为成功,若提示“command not found”,说明安装失败,重新执行对应命令):
    docker --version && docker compose version && python3.9 --version && git --version && node --version && pnpm --version
    
    • 需确保Docker版本≥20.10.0,Docker Compose≥2.0.0,Python≥3.9,Node.js≥22.0.0,否则需升级对应软件。
方案2:Windows系统(管理员PowerShell执行)
  1. 安装Docker Desktop:需手动下载安装(官网地址:https://www.docker.com/products/docker-desktop/),安装过程中勾选“使用WSL2而不是Hyper-V”,安装完成后重启电脑,确保Docker正常启动。
  2. 启用WSL2(适配Docker运行,若已启用可跳过):
    wsl --install
    
    • 执行后,按照提示重启电脑,完成WSL2安装。
  3. 安装Python 3.9+、Git、Node.js与pnpm:
    # 安装Git与pnpm(通过npm安装)
    npm install -g pnpm git
    # 安装Python 3.9+(若已安装,跳过此步)
    pip3 install requests python-dotenv
    # 配置pnpm国内镜像
    pnpm config set registry https://registry.npmmirror.com/
    
  4. 验证依赖安装成功:
    node --version && python3 --version && git --version && pnpm --version && docker --version
    
    • 若Docker未启动,手动启动Docker Desktop,再执行验证命令。

步骤2:拉取OpenClaw源码并初始化配置

  1. 克隆OpenClaw国内仓库(提升访问速度,避免GitHub仓库下载卡顿),执行以下命令:
    # 克隆仓库
    git clone https://gitee.com/openclaw-team/openclaw.git
    # 进入OpenClaw目录
    cd openclaw
    
  2. 安装项目依赖(依赖较多,耐心等待,若下载卡顿,可重新执行命令):
    pnpm install
    
  3. 初始化OpenClaw配置,生成默认配置文件(包含模型配置、服务配置等,无需手动创建):
    openclaw onboard --mode default
    
  4. 配置阿里云百炼API-Key(替换为你提前保存的API-Key,若使用本地模型,可跳过此步):
    # 配置API-Key
    openclaw config set models.providers.bailian.apiKey "你的阿里云百炼API-Key" --json
    # 配置阿里云百炼API地址
    openclaw config set models.providers.bailian.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1" --json
    # 设置默认模型
    openclaw config set agents.defaults.model.primary "bailian/qwen3-max-2026-01-23" --json
    
  5. (可选)配置本地模型(Ollama,完全离线使用):
    # 安装Ollama(本地模型运行环境)
    curl https://ollama.com/install.sh | sh
    # 拉取本地模型(以qwen:7b为例,轻量化模型,适合本地运行)
    ollama pull qwen:7b
    # 配置OpenClaw使用本地模型
    openclaw config set models.providers.ollama.enabled true --json
    openclaw config set agents.defaults.model.primary "ollama/qwen:7b" --json
    

步骤3:启动OpenClaw服务

  1. 启动OpenClaw服务,默认端口为18789,可自定义端口(如--port 18790),执行以下命令:
    # 启动服务(默认端口18789)
    openclaw gateway start --port 18789
    
    • 若提示“端口被占用”,更换端口即可,例如:openclaw gateway start --port 18790。
  2. 验证服务启动状态(输出“running”即为成功,若显示“stopped”,检查依赖是否安装完整,或端口是否被占用):
    openclaw status
    
    • 也可使用OpenClaw自带的诊断命令,快速排查启动问题:
      # 快速诊断服务状态
      openclaw status --all
      # 自动修复常见配置问题
      openclaw doctor
      

步骤4:生成Token并访问验证(确认部署成功)

  1. 生成管理员Token(仅允许本地IP访问,提升安全性,避免外部访问):
    openclaw token generate --admin --allow-ip 127.0.0.1
    
    • 执行后,终端会输出管理员Token,复制保存,丢失后可重新生成。
  2. 本地访问验证:打开浏览器,在地址栏输入“http://127.0.0.1:18789”,粘贴生成的Token,点击登录,若能成功进入OpenClaw Web控制台,说明本地部署成功。
  3. 离线使用测试(可选):断开本地网络,若已配置本地模型(Ollama),发送指令测试(如“帮我生成一份简单的Python脚本”),验证是否能正常执行;若使用云端模型,断开网络后无法调用模型,但已生成的脚本、配置仍可正常查看。

步骤5:本地部署优化(提升使用体验,可选)

  1. 启用本地数据持久化(避免重启服务后丢失配置、记忆与任务记录):
    openclaw config set memory.persistent true --json
    # 设置记忆存储路径(默认存储在~/.openclaw/memory)
    openclaw config set memory.path "~/.openclaw/memory" --json
    
  2. 导入本地知识库(适配个人学习、敏感资料处理场景,可导入PDF、Word、TXT等格式文档):
    # 创建本地知识库目录
    mkdir -p ~/.openclaw/knowledge-base
    # 复制本地文档到知识库目录(示例:复制PDF文件,可替换为自己的文档路径)
    cp ~/Downloads/xxx.pdf ~/.openclaw/knowledge-base/
    # 触发知识库索引,使OpenClaw能检索文档内容
    openclaw learning index
    
  3. 创建启动脚本(避免每次手动输入启动命令,Windows、Linux/macOS通用):
    ```bash

    创建脚本文件(Linux/macOS)

    cat > ~/openclaw-start.sh << 'EOF'

    !/bin/bash

    OpenClaw启动脚本

    openclaw gateway start --port 18789
    echo "OpenClaw服务已启动,访问地址:http://127.0.0.1:18789"
    EOF

    赋予执行权限

    chmod +x ~/openclaw-start.sh

Windows系统(管理员PowerShell执行)

echo "openclaw gateway start --port 18789" > C:\openclaw-start.ps1

    - 后续启动OpenClaw,只需执行脚本即可:Linux/macOS执行./openclaw-start.sh,Windows执行C:\openclaw-start.ps1。
4.  日志管理与问题排查:
```bash
# 实时查看运行日志
openclaw logs --follow
# 前台启动,查看完整输出(便于排查启动问题)
openclaw gateway
# 生成调试报告,用于寻求帮助或深度排查
openclaw status --all

四、常见问题排查(新手避坑,快速解决)

结合2026年OpenClaw最新版本与新手部署场景,整理了最常见的8类异常问题,对照排查即可快速解决,无需专业技术,覆盖阿里云部署与本地部署的所有高频问题,同时参考官方排查指南,确保解决方案的有效性。

(一)服务器部署(阿里云)常见问题

  1. 服务器部署后,浏览器无法访问Web控制台,提示“无法连接”:

    • 排查方向:服务器公网IP是否正确、18789端口是否放行、OpenClaw服务是否正常运行;
    • 解决方案:
      # 1. 确认服务器公网IP正确,重新输入访问地址
      # 2. 检查端口放行状态,若未放行,重新执行端口放行命令
      firewall-cmd --add-port=18789/tcp --permanent
      firewall-cmd --reload
      # 3. 检查OpenClaw服务状态,若未启动,重启服务
      systemctl start openclaw
      # 4. 查看服务日志,排查具体错误
      docker exec -it openclaw-core openclaw logs --follow
      
  2. API-Key配置后,无法调用模型,提示“API-Key无效”:

    • 排查方向:API-Key输入是否正确、阿里云百炼服务是否开通、API-Key是否过期;
    • 解决方案:
      # 1. 重新配置API-Key,确保输入正确(无多余空格、大小写无误)
      docker exec -it openclaw-core openclaw config set models.providers.bailian.apiKey "你的阿里云百炼API-Key"
      # 2. 重启服务生效
      docker exec -it openclaw-core openclaw gateway restart
      # 3. 登录阿里云百炼控制台,确认API-Key未过期、服务已开通
      
  3. 服务器重启后,OpenClaw服务无法自动启动:

    • 解决方案:设置服务开机自启,执行以下命令:
      systemctl enable openclaw
      # 重启服务器验证
      reboot
      

(二)本地部署常见问题

  1. 启动服务时,提示“Node.js版本不兼容”:

    • 排查方向:Node.js版本是否≥22.0.0;
    • 解决方案:升级Node.js至22.0.0以上版本,执行以下命令(Linux/macOS):
      curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
      sudo apt install -y nodejs
      # 验证版本
      node --version
      
    • Windows用户:手动下载Node.js v22.0.0以上版本,重新安装。
  2. 本地部署后,启动服务提示“端口被占用”:

    • 排查方向:18789端口是否被其他软件占用;
    • 解决方案:更换服务端口,执行以下命令:
      # 更换端口为18790,可自定义其他未占用端口
      openclaw gateway start --port 18790
      # 查看端口占用情况(Linux/macOS)
      lsof -i :18789
      # 查看端口占用情况(Windows)
      netstat -ano | findstr 18789
      
  3. 导入本地知识库后,无法检索文档内容:

    • 排查方向:知识库路径配置是否正确、是否触发索引;
    • 解决方案:
      # 1. 确认知识库路径配置正确
      openclaw config get learning.materials.path
      # 2. 重新触发索引
      openclaw learning index
      # 3. 检查文档格式,确保为PDF、Word、TXT等支持的格式
      
  4. 本地部署后,无法生成Token,提示“权限不足”:

    • 排查方向:终端是否以管理员身份运行(Windows)、目录权限是否足够;
    • 解决方案:
    • Windows:关闭PowerShell,重新以管理员身份打开,再执行生成Token的命令;
    • Linux/macOS:赋予目录权限,执行以下命令:
      chmod -R 755 ~/.openclaw
      # 重新生成Token
      openclaw token generate --admin --allow-ip 127.0.0.1
      

(三)通用常见问题

  1. Token丢失或忘记,无法登录Web控制台:

    • 解决方案:重新生成管理员Token,通用命令如下:
      # 阿里云部署
      docker exec -it openclaw-core openclaw token generate --admin
      # 本地部署
      openclaw token generate --admin --allow-ip 127.0.0.1
      
  2. OpenClaw执行任务时,提示“技能未找到”:

    • 排查方向:技能是否安装、技能库是否更新;
    • 解决方案:
      # 进入容器环境(阿里云部署)或OpenClaw目录(本地部署)
      # 安装常用技能
      openclaw skill install --all
      # 更新技能库
      openclaw skill update
      
  3. 运行过程中出现卡顿、崩溃,提示“内存不足”:

    • 排查方向:设备内存是否满足要求、是否同时运行多模型、多技能;
    • 解决方案:关闭不必要的软件与模型,升级设备内存(推荐8GB以上);若为阿里云部署,升级服务器配置。

五、总结

OpenClaw(Clawdbot)作为2026年最火爆的开源AI代理工具,其核心价值在于“低门槛、强执行、可自托管”,打破了传统AI工具仅能“提供建议”的局限,让普通用户无需编程基础,就能通过自然语言指令,让AI完成各类重复性、流程化任务,真正实现“解放双手”。它与Clawdbot、Moltbot本质一致,仅品牌名称不同,2026年最新版本在模型支持、安全机制、交互体验等方面均有大幅优化,进一步提升了实用性与稳定性。

2026年的双部署方案完美适配不同用户的需求:阿里云轻量服务器部署依托预置镜像,实现零门槛、高稳定部署,适合个人日常使用与轻量团队协作,支持7×24小时稳定运行与多设备远程访问;本地部署实现私有化存储,数据隐私可控、无服务器成本,适合处理敏感任务与离线使用,支持Windows、macOS、Linux三大系统,新手可逐步操作落地。

两种部署方案的核心流程均围绕“环境准备-API配置-服务启动-验证使用”展开,所有代码命令可直接复制执行,无需专业编程基础,同时本文补充了详细的常见问题排查与优化技巧,覆盖部署全场景、全流程,助力新手零踩坑,快速解锁OpenClaw的核心功能。

部署完成后,用户可根据自身需求,进一步配置跨工具协同、私有知识库、本地模型等功能,同时可通过社区技能市场ClawdHub安装现成技能,或自定义开发专属技能,无限扩展OpenClaw的能力边界。无论是个人办公、开发辅助,还是生活服务,OpenClaw都能成为你的“专属AI员工”,充分发挥AI的执行价值,让高效办公、便捷生活触手可及。

对于新手而言,建议先从阿里云轻量服务器部署入手,熟悉操作流程后,再尝试本地部署,根据自身需求选择合适的方案;同时关注OpenClaw官方更新,及时升级版本,获取新增功能与安全修复,让工具始终保持最佳运行状态。

目录
相关文章
|
8天前
|
缓存 人工智能 自然语言处理
我对比了8个Claude API中转站,踩了不少坑,总结给你
本文是个人开发者耗时1周实测的8大Claude中转平台横向评测,聚焦Claude Code真实体验:以加权均价(¥/M token)、内部汇率、缓存支持、模型真实性及稳定性为核心指标。
3231 20
|
20天前
|
人工智能 自然语言处理 安全
Claude Code 全攻略:命令大全 + 实战工作流(建议收藏)
本文介绍了Claude Code终端AI助手的使用指南,主要内容包括:1)常用命令如版本查看、项目启动和更新;2)三种工作模式切换及界面说明;3)核心功能指令速查表,包含初始化、压缩对话、清除历史等操作;4)详细解析了/init、/help、/clear、/compact、/memory等关键命令的使用场景和语法。文章通过丰富的界面截图和场景示例,帮助开发者快速掌握如何通过命令行和交互界面高效使用Claude Code进行项目开发,特别强调了CLAUDE.md文件作为项目知识库的核心作用。
17504 59
Claude Code 全攻略:命令大全 + 实战工作流(建议收藏)
|
22小时前
|
SQL 人工智能 弹性计算
阿里云发布 Agentic NDR,威胁检测与响应进入智能体时代
欢迎前往阿里云云防火墙控制台体验!
1147 2
|
4天前
|
人工智能 JSON BI
DeepSeek V4 来了!超越 Claude Sonnet 4.5,赶紧对接 Claude Code 体验一把
JeecgBoot AI专题研究 把 Claude Code 接入 DeepSeek V4Pro 的真实体验与避坑记录 本文记录我将 Claude Code 对接 DeepSeek 最新模型(V4Pro)后的真实体验,测试了 Skills 自动化查询和积木报表 AI 建表两个场景——有惊喜,也踩
1620 7
|
15天前
|
人工智能 JavaScript Ubuntu
低成本搭建AIP自动化写作系统:Hermes保姆级使用教程,长文和逐步实操贴图
我带着怀疑的态度,深度使用了几天,聚焦微信公众号AIP自动化写作场景,写出来的几篇文章,几乎没有什么修改,至少合乎我本人的意愿,而且排版风格,也越来越完善,同样是起码过得了我自己这一关。 这个其实OpenClaw早可以实现了,但是目前我觉得最大的区别是,Hermes会自主总结提炼,并更新你的写作技能。 相信就冲这一点,就值得一试。 这篇帖子主要就Hermes部署使用,作一个非常详细的介绍,几乎一步一贴图。 关于Hermes,无论你赞成哪种声音,我希望都是你自己动手行动过,发自内心的选择!
3147 29
|
2天前
|
人工智能 缓存 BI
Claude Code + DeepSeek V4-Pro 真实评测:除了贵,没别的毛病
JeecgBoot AI专题研究 把 Claude Code 接入 DeepSeek V4Pro,跑完 Skills —— OA 审批、大屏、报表、部署 5 大实战场景后的真实体验 ![](https://oscimg.oschina.net/oscnet/up608d34aeb6bafc47f
1195 3
Claude Code + DeepSeek V4-Pro 真实评测:除了贵,没别的毛病
|
3天前
|
机器学习/深度学习 缓存 测试技术
DeepSeek-V4开源:百万上下文,Agent能力比肩顶级闭源模型
DeepSeek-V4正式开源!含V4-Pro(1.6T参数)与V4-Flash(284B参数)双版本,均支持百万token上下文。首创混合注意力架构,Agent能力、世界知识与推理性能全面领先开源模型,数学/代码评测比肩顶级闭源模型。
1674 6
|
5天前
|
人工智能 测试技术 API
阿里Qwen3.6-27B正式开源:网友直呼“太牛了”!
阿里云千问3.6系列重磅开源Qwen3.6-27B稠密大模型!官网:https://t.aliyun.com/U/JbblVp 仅270亿参数,编程能力媲美千亿模型,在SWE-bench等权威基准中表现卓越。支持多模态理解、本地部署及OpenClaw等智能体集成,已开放Hugging Face与ModelScope下载。