先坦白一件事——我当初折腾OpenClaw的时候,差点把键盘砸了。

网上那些教程看着都挺美:一条命令、五分钟搞定、AI助手随时待命。结果呢?Node版本不对,npm报错,API Key配完了连不上,Telegram Bot死活不回复。前后折腾了整整一个周末,最后在GitHub Issues里翻到一个老哥的评论才把问题解决。

后来我发现了OpenClawInstaller,又发现了ClawCloud的免费容器。说实话,这两个东西放一起,真的是把“从零到一”的门槛降到了地板价。所以我决定把整个过程从头到尾写下来,不是那种官方文档的翻译,而是我自己踩坑、填坑、最终跑起来的真实记录。

如果你也想拥有一个7x24小时在线的私人AI助手,能在微信、Telegram、飞书里直接跟它聊天,让它帮你查资料、写邮件、设提醒——那这篇文章应该能帮你省下至少一整个周末的时间。

一、OpenClaw到底是个什么东西?为什么最近这么多人聊它?

简单来说,OpenClaw(官网叫clawd.bot)是一个“AI网关”。它不自己提供大模型,而是做中间人:

  • 左边连着各种聊天软件:Telegram、Discord、飞书、微信、Slack……你平时用哪个,它就能接哪个。
  • 右边连着各种AI模型:Claude、GPT、Gemini,甚至你本地用Ollama跑的模型也行。
  • 中间它加了一些很实用的能力:跨会话的记忆(你昨天说过的话,它今天还记得)、主动推送消息(比如定时提醒)、技能系统(用Markdown文件就能定义新功能)、远程控制(执行命令、读写文件)。

所以你可以在微信上直接@它问天气,在Telegram让它帮你翻译文档,在飞书让它每天早上九点自动发日报摘要——不用再打开任何一个额外的App。

截至2026年初,OpenClaw主仓库和周边生态的GitHub Stars加起来快破万了,社区贡献的技能也有五百多个。这东西确实火,但火归火,装不起来等于零。

二、手动部署的痛苦,谁踩过谁知道

我承认,OpenClaw的设计思路很棒,但手动部署是真的折磨人。我总结了一下,主要有三个坎儿:

第一,环境依赖太烦了。

需要Node.js v22以上,还要Git、npm,不同操作系统下的安装命令不一样。如果你平时不怎么碰命令行,光是装个正确的Node版本就可能卡半天。我当初在Ubuntu上装Node 22,用apt默认源装的是v18,后来用nvm才搞定。这些细节教程里很少提。

第二,配置文件看一眼就头疼。

你要填API Key,要配Telegram Bot Token,要设置回调地址,还要改JSON文件里的各种参数。少一个逗号、多一个空格,整个服务就起不来。而且Telegram Bot的创建本身就要跟@BotFather聊半天,拿到Token之后还得测试连通性,每一步都可能出错。

第三,好不容易跑起来了,一关终端就没了。

本地部署最大的问题就是持久化。你关掉SSH连接或者合上笔记本盖子,OpenClaw就跟着退了。想要7x24小时在线,得自己配systemd守护进程、写日志轮转脚本、搞自动重启。这对个人开发者和小团队来说,有点超出“玩一玩”的范围了。

所以当我发现OpenClawInstaller的时候,第一反应是:这玩意儿要是真能一键搞定,那就是救命了。

三、OpenClawInstaller是怎么做到“一键搞定”的

这个项目的GitHub地址是:https://github.com/miaoxworld/OpenClawInstaller。它本质上是一个Shell脚本集合,核心设计理念就是——能用菜单解决的问题,绝不让你手写JSON。

3.1 一条命令,从头跑到尾

安装命令长这样:

curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash

我第一次跑这条命令的时候,心里其实挺虚的,担心它会不会把我服务器搞崩。后来看了脚本源码,发现它做了几件很聪明的事:

  • 自动识别操作系统:不管是macOS、Ubuntu还是CentOS,脚本自己判断该怎么装依赖。
  • Node版本检查:如果当前Node版本低于v22,它会自动调用nvm或者系统包管理器升级,不用你自己折腾。
  • 交互式配置:装完之后不会直接让你面对一堆配置文件,而是弹出一个数字菜单,让你一步步选AI模型、填API Key、选消息渠道。每一步都有提示,填错了也会报友好错误。
  • 自动测试连接:配置完成后,脚本会尝试调用一次API,确认Key能用、网络通,避免你配置半天最后发现连不上。
  • 守护进程自动配置:最后会问你要不要配systemd,选了yes之后,服务器重启了OpenClaw也会自己起来。

我第二次重装的时候,全程只花了大概十分钟——主要是等npm下载包的时间,真正动手输入的内容不超过五行。

3.2 配置菜单长啥样?我直接给你看

装完之后,运行./config-menu.sh,会看到一个像这样的菜单:

OpenClaw Configuration Menu
1. AI Model Configuration
2. Channel Configuration
3. Advanced Settings
4. View Current Config
5. Restart Gateway
6. Update OpenClaw
0. Exit

选1进去之后,你可以选模型服务商:

  • Anthropic Claude(claude-sonnet-4-5、claude-opus-4)
  • OpenAI GPT(gpt-4o、gpt-4-turbo)
  • Google Gemini(gemini-2.0-flash)
  • OpenRouter(一个Key用遍所有模型)
  • Groq(速度快,延迟低)
  • Mistral(性价比不错)
  • Ollama(本地跑,不要钱)

选2进去,可以配消息渠道:

  • Telegram Bot
  • Discord
  • WhatsApp
  • Slack
  • 飞书
  • 微信企业号
  • iMessage(仅限Mac用户)

每个渠道都会问你要对应的Token或Webhook地址,菜单里还会给提示告诉你怎么去申请。说实话,就算你对这些东西一窍不通,跟着菜单一步步走也能配好。

四、实战:用ClawCloud的免费容器跑起来

安装脚本搞定了,但还有个问题:跑在哪里?总不能一直开着家里的电脑吧。

ClawCloud这个平台我最近才开始用,它的免费策略确实挺大方——只要你的GitHub账号注册超过180天,登录就送每月5美元额度,不用绑信用卡。而且免费容器的规格是4核CPU、8GB内存、10G带宽,跑OpenClaw绰绰有余。

下面我手把手带你走一遍。

4.1 注册ClawCloud并拿到免费额度

  1. 打开 https://console.run.claw.cloud
  2. 点击“Get started for free”,用GitHub账号登录。
  3. 如果你的GitHub账号满180天了,额度会自动到账。
  4. 登录后进控制台,找到“App Launchpad”功能——这是ClawCloud内置的容器创建工具。

重要提示:部署区域建议选“美国”。因为OpenAI和Google的API在某些地区(比如上海、香港)可能被墙或延迟很高,选美国区域能省很多麻烦。

4.2 创建一个Ubuntu容器

在App Launchpad里,点“创建应用”,参数这样填:

  • 应用名称:随便写,比如“my-openclaw”
  • 镜像:Ubuntu 22.04 LTS(Debian 12也行)
  • CPU/内存:最低0.5核+1GB就能跑,但建议至少1核+2GB,体验更流畅
  • 网络:开启外部访问,这样你能通过SSH进去操作
  • 持久存储:挂载5GB以上,用来存配置、记忆数据和日志

点“Deploy”,两三分钟后容器就起来了。

4.3 进终端,跑安装脚本

容器部署好后,在应用详情页找到“Terminal”按钮,点一下就能直接进容器命令行——不用配SSH密钥,浏览器里就能操作,很方便。

进去之后执行:

apt update && apt upgrade -y
apt install -y curl git build-essential

然后就是那条一键命令:

curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash

脚本跑起来之后,你会看到它自动检测系统、装Node、npm全局装OpenClaw。中间会弹出菜单让你配置AI模型和消息渠道。我自己的配置是这样的:

  • AI模型:Anthropic Claude,填了自己的API Key
  • 备用模型:OpenAI GPT-4o mini(万一Claude挂了还能顶上)
  • 消息渠道:Telegram Bot(先在Telegram上找@BotFather创建Bot,拿到Token填进去)

配置完成之后脚本会自动启动Gateway,还会问你要不要配systemd。选“是”,以后服务器重启了服务也能自己恢复。

4.4 验证一下是不是真的跑起来了

装完之后,用这几个命令检查:

openclaw status      # 看Gateway状态
openclaw health      # 健康检查
openclaw doctor      # 完整诊断,有问题会告诉你

如果一切正常,你会在Telegram上收到Bot发来的消息,比如“OpenClaw is online”。然后你就可以在聊天框里直接跟它对话了。

五、几个我觉得很实用的进阶玩法

基础部署完了,但OpenClaw的能力远不止“聊天”。下面这几个是我自己用下来觉得真香的。

5.1 多模型兜底,不怕API挂掉

OpenClaw支持配多个模型,设一个主模型,再设几个备用。比如我这样配:

  • 主模型:Claude Sonnet 4.5(处理复杂任务,质量最高)
  • 备用1:GPT-4o mini(日常闲聊,成本低)
  • 备用2:Ollama上的Llama 3(完全免费,最后的兜底)

当主模型API调用失败或者速率超限,OpenClaw会自动切到备用模型。这个功能在免费层级的API Key上尤其有用——很多模型的免费额度有每分钟请求限制,有兜底就不会断档。

5.2 用OpenClaw Manager图形界面管理

如果你实在不想敲命令,可以装OpenClaw Manager这个桌面应用。它基于Tauri 2.0 + React + Rust开发,跨平台支持Windows、macOS、Linux。

界面长得像现代化的仪表盘,能看到服务状态、内存占用、运行时间。所有配置都是可视化表单,不用手写JSON。对于不熟悉命令行的用户来说,这个桌面版是神器。

5.3 容器数据持久化,防止重启丢配置

ClawCloud的免费容器有个特点:如果长期不活跃,可能会被系统回收。为了不让你的配置和记忆数据丢失,建议做两件事:

  1. 挂载持久存储:在创建容器的时候,把~/.openclaw目录挂载到持久存储卷上。这个目录下存了所有配置、记忆数据、日志。
  2. 定期备份:每隔一段时间运行openclaw export,把配置和数据导出成文件,下载到本地存着。

另外,可以在OpenClaw里设置一个定时任务,比如每天早上8点向你的Telegram发送一条“早安,我还活着”的消息。这样既能让容器保持活跃,也能确认服务正常。

六、那些我踩过的坑(以及怎么爬出来的)

写到这里,我觉得有必要把之前踩过的坑列出来,给你提个醒。

坑一:Node版本不对,装到一半报错

OpenClaw要求Node v22+,但很多云服务器的默认源里最高只有v18。如果你的install.sh跑失败了,先检查一下Node版本:

node --version

如果低于v22,手动装一下:

# 用nvm装是最稳妥的
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 22
nvm use 22

然后再重新跑install.sh。

坑二:旧版本残留导致命令冲突

如果你之前装过旧版OpenClaw或者别的pnpm/npm全局包,可能会遇到openclaw命令指向错误。解决方法:

npm rm -g openclaw
pnpm rm -g openclaw  # 如果有pnpm残留
rm -rf ~/.openclaw
sudo rm -f /usr/bin/openclaw /usr/local/bin/openclaw

然后重新安装。

坑三:ClawCloud的浏览器终端超时断连

通过浏览器进Terminal跑长时间任务(比如npm install),如果一段时间没输出,会话可能会被断开。解决方案有两个:

  • tmuxscreen保持会话:先装tmux,开一个新session,在里面跑安装脚本。
  • 或者在安装过程中时不时敲一下回车,保持连接活跃。

坑四:API Key在容器里能ping通但curl不通

如果你配置完模型后测试连接失败,但Key本身没错,大概率是网络问题。检查一下容器所在的区域——如果是上海或香港区域,访问OpenAI和Google的API可能会被阻断。解决办法就是换到美国区域的容器,重新部署一次。

七、总结:这套方案到底值不值得用?

如果让我给OpenClawInstaller + ClawCloud这个组合打分,我愿意给95分(扣掉的5分是因为偶尔还会遇到一些小bug,不过基本都能解决)。

成本角度:ClawCloud每月5美元的免费额度,配合4核8GB的容器配置,对个人开发者来说完全是零成本。相比那些按月收费的商业AI服务,这套自托管方案跑一年也花不了几块钱。

效率角度:从零到跑通,我第二次安装只用了不到一刻钟。如果没有OpenClawInstaller,光手写配置文件和调试API连接可能就要一下午。

自主性和隐私:所有数据都在你自己的云实例上,API Key不会经过第三方服务。对话历史、记忆数据都只有你自己能访问。

当然,这套方案也不是完美无缺的。你需要有一点基本的Linux命令行常识(至少知道cdlscurl是干嘛的)。如果你连终端都没打开过,可能需要先花半小时补一下基础。但说实话,OpenClawInstaller已经把门槛降到了最低——只要你愿意跟着教程一步步点,大概率能跑起来。

最后,OpenClaw生态还在快速发展。技能仓库里已经有五百多个现成的技能可以拿来就用,桌面管理工具也越来越成熟。我个人的感觉是,现在正是入局的好时机——工具链已经基本完善,社区也很活跃,你遇到的问题大概率别人已经踩过并且给出了解决方案。

如果你在部署过程中遇到任何问题,欢迎在评论区留言。我会尽量回复。也建议你把这篇文章收藏起来,哪天需要重新部署的时候,直接按步骤来就行。

祝你的AI助手顺利上线!

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐