近期OpenClaw(前身为ClawdBot、Moltbot)在开源社区爆火,GitHub星标突破12万,仅凭一行命令就能部署一个能自主执行任务的AI智能体,帮你处理邮件、调用工具、甚至通过IM工具远程控制设备,堪称现实版“贾维斯”。
从前期准备、3种部署方案(适配不同基础),到基础使用、避坑要点,全程图文级拆解,零基础也能轻松上手,让你快速解锁AI智能体的核心能力。
一、前言:先搞懂OpenClaw是什么
在开始安装前,先简单科普下OpenClaw的核心价值,避免大家盲目部署:它不是单一AI工具,而是一个本地化部署的AI智能体框架,核心优势的是“自主执行+全平台适配+持久记忆”。
简单说,它能帮你做这些事:① 集成WhatsApp、Telegram、企微等IM工具,私聊/群聊@它就能发指令;② 调用大模型(支持GPT、Claude,国内可对接通义千问、腾讯混元),自主写代码、执行Shell命令;③ 持久化记忆,本地存储聊天记录和你的偏好,不受Token限制;④ 扩展技能,通过ClawdHub安装插件,甚至让它自主创建技能完成复杂任务。
二、前期准备(全方案通用,必看!)
无论选择哪种部署方案,都需要提前准备好以下内容,避免安装过程中卡壳,尤其注意国内网络适配和版本问题:
2.1 核心前提条件
2.2 前期避坑要点(国内用户重点看)
三、3种部署方案(按易操作度排序,按需选择)
结合国内用户的技术基础和网络环境,整理了3种部署方案,零基础优先选方案1(云厂商一键部署),有技术基础想定制化选方案2(Docker部署),注重数据隐私选方案3(本地部署)。
方案1:云厂商一键部署(推荐零基础/轻量场景)
核心优势:无需手动配置环境,规避国内网络限制,依托云厂商预置的OpenClaw镜像,实现“一键部署、开箱即用”,支持7×24小时后台运行,适配国内IM工具和大模型。
以下以腾讯云Lighthouse为例,全程可视化操作,阿里云操作类似:
选购云服务器:登录腾讯云Lighthouse控制台,在“应用模板”中找到“AI智能体→OpenClaw(原ClawdBot)”,地域选择国内节点(北京、上海、广州),套餐推荐2核4G(最低2核2G),完成购买后等待实例创建(1-3分钟);
实例配置:实例创建成功后,进入“管理实例→应用管理”,无需手动安装依赖(模板已预置Node.js、OpenClaw主程序),直接进入API-Key配置;
大模型授权:在配置面板选择国内大模型(如腾讯混元、通义千问),跳转至对应模型平台创建API-Key,复制粘贴后点击“应用保存”,系统自动重启服务(约30秒);
IM工具接入(可选):在“Channel配置”中输入企微、QQ的App ID和App Secret,点击保存即可完成接入(腾讯云独家支持国内四大IM工具);
部署验证:点击“服务状态→验证连接”,系统检测大模型授权、IM接入状态,提示“部署成功”后,即可通过浏览器访问实例公网IP,或通过IM工具发送指令测试。
成本参考:腾讯云2核4G套餐每月88-168元,新用户首月5折,年付立减20%;无需7×24小时运行可设置定时开关机,降低成本。
方案2:Docker手动部署(推荐有基础/定制化需求)
核心优势:灵活性高,支持自定义配置依赖、修改核心参数,可部署在任意支持Docker的服务器(云服务器、本地服务器均可),有效规避版本冲突。
安装Docker环境:提前在服务器上安装Docker(v24+)、Docker Compose(v2.20+),国内用户配置阿里云Docker镜像,避免镜像拉取超时;
拉取OpenClaw镜像:打开终端,执行命令(国内镜像版)
创建配置文件:在服务器上创建OpenClaw配置目录,执行命令:mkdir -p ~/.clawdbot && cd ~/.clawdbot,创建config.json文件,填写大模型API-Key和基础配置;
启动容器:执行启动命令,映射端口(18789为控制台端口):docker run -d -p 18789:18789 -v ~/.clawdbot:/root/.clawdbot --name openclaw openclaw/openclaw:latest;
验证部署:在浏览器中访问http://服务器IP:18789,输入默认密钥(可在配置文件中修改),能正常进入控制台即部署成功。
方案3:本地服务器部署(推荐注重隐私/企业用户)
核心优势:数据完全本地化存储,不受云端限制,适合对隐私要求极高、有自有算力资源的用户,需具备一定的Linux/ macOS操作基础。
卸载旧版本(关键):若之前安装过ClawdBot/Moltbot,执行命令卸载:sudo npm uninstall -g clawdbot moltbot;
安装OpenClaw:执行安装命令(国内用户建议用淘宝npm镜像):sudo npm install -g openclaw --registry=https://registry.npm.taobao.org;
初始化配置:运行初始化向导,按提示完成设置:openclaw onboard --install-daemon,依次选择大模型供应商、输入API-Key、配置消息渠道;
获取网关密钥:执行命令查看密钥:cat ~/.clawdbot/clawdbot.json | grep “token”,复制gateway.auth.token的值;
访问控制台:打开浏览器,访问http://127.0.0.1:18789/dashboard/overview,输入网关密钥,即可进入本地控制台。
注意:本地部署需保持电脑开机状态,若需远程访问,需配置SSH或VPN,避免直接开放端口带来安全风险。
四、OpenClaw基础使用教程(核心操作,必看)
部署成功后,主要通过“Web控制台”和“IM工具”两种方式使用OpenClaw,以下讲解最常用的操作,快速解锁核心功能。
4.1 Web控制台基础操作(新手入门)
登录控制台:访问http://IP:18789(本地部署为127.0.0.1,云部署为服务器公网IP),输入网关密钥登录;
熟悉界面:左侧为功能菜单(聊天、配置、技能管理、监控),中间为聊天窗口,右侧为配置面板;
首次对话:在聊天窗口发送指令,例如“帮我清理收件箱的垃圾邮件”“生成一段Sora2视频脚本”,OpenClaw会自动调用对应工具执行任务;
技能管理:进入“Skill Hub”,可安装社区贡献的技能(如Todoist管理、Home Assistant控制),也可让OpenClaw自主创建技能(输入指令“帮我创建一个查询大学课程表的技能”)。
4.2 IM工具远程使用(高频场景)
OpenClaw最便捷的使用方式的是通过IM工具(Telegram、企微等)远程控制,无需打开控制台:
绑定IM工具:在控制台“Channel配置”中,完成IM工具的授权(如Telegram需扫描二维码,企微需输入App信息);
发送指令:在IM工具中私聊OpenClaw,或在群聊中@它,发送自然语言指令即可,例如“帮我把Notion里的10篇文章迁移到Astro”“调用浏览器抓取某个网站的数据”;
查看结果:OpenClaw会实时反馈执行进度,支持流式输出(像打字一样实时显示回复),执行完成后会返回结果链接或文件。
4.3 核心功能实操示例(快速上手)
举2个高频场景的实操示例,帮大家快速掌握使用技巧:
示例1:文档迁移(Notion→Astro):在Telegram中发送指令“帮我把Notion里的文章迁移到Astro,共18篇,DNS转移到Cloudflare”,OpenClaw会自动调用Notion API、Astro工具,全程无需手动操作,完成后反馈迁移结果;
示例2:本地AI部署:发送指令“帮我通过Ollama部署本地AI模型,用于网页摘要”,OpenClaw会自主下载Ollama、部署模型、配置关联,完成后可直接调用本地模型处理任务。
五、常见问题与避坑指南(新手必看)
整理了安装和使用过程中最常遇到的5个问题,附解决方案,避免大家踩坑浪费时间:
问题1:安装时提示“依赖安装超时”?解决方案:切换国内npm镜像,或通过代理安装,执行命令npm config set registry https://registry.npm.taobao.org;
问题2:控制台无法访问,提示“端口未开放”?解决方案:云部署需在服务器安全组中开放18789端口,本地部署检查防火墙是否拦截;
问题3:IM工具无法绑定,提示“授权失败”?解决方案:检查IM工具的App信息是否填写正确,国内用户避免使用海外IM工具(如WhatsApp),优先用企微、QQ;
问题4:OpenClaw无法调用大模型?解决方案:检查API-Key是否正确,是否过期,国内大模型需在配置面板选择对应供应商,避免选错模型类型;
问题5:执行复杂任务时卡住?解决方案:复杂任务需拆分简单指令,逐步发送,若卡住可发送“停止当前任务”,重启容器后重新执行,或检查服务器内存是否充足(建议4G以上)。