乐于分享
好东西不私藏

从零搭建AI助手:我的OpenClaw踩坑实录

从零搭建AI助手:我的OpenClaw踩坑实录

家人们谁懂啊!最近刷到各种AI助手能自动发邮件、查股票、甚至陪聊,我直接狠狠心动💥 暗下决心:必须搞一个属于自己的,不依赖云端、不泄露数据,能真正帮我摸鱼(不是)干活的本地AI助手!
谁能想到,这一折腾,直接把我从“科技爱好者”逼成了“报错排查大师”,两天里踩的坑能绕Mac三圈,好几次都想把电脑扣在桌上——但最终,当OpenClaw成功给我发第一封邮件、查第一支股票时,那种成就感,比中了小奖还爽!
这篇推文,全程无废话、全是血泪教训+爆笑踩坑现场,给想搭OpenClaw的兄弟姐妹们避坑,看完直接少走90%的弯路!

一、为什么选OpenClaw?被其他方案虐哭后的选择😭

在锁定OpenClaw之前,我试了好几种方案,每一种都把我虐得死去活来,给大家避避坑:

方案

我的崩溃瞬间

直接用ChatGPT API

网络卡成PPT,有时候发个消息等半分钟,而且总担心数据被偷偷收集,安全感为0

自建本地知识库

太复杂了!各种配置、调试,折腾了一周,连基础的检索功能都没跑通,直接放弃治疗

字节Coze扣子

客观说体验不错,但偏向云端,我就是想搞本地化啊!感觉自己的AI助手,还是握在自己手里踏实

最终选择OpenClaw,纯属“救命式选择”,它的优点直接戳中我:
✅ 本地运行!数据全在自己Mac里,再也不用怕隐私泄露
✅ 能对接微信、邮件,日常办公能直接省一半事
✅ 可自定义技能(Skill),想让它干啥就干啥,主打一个随心所欲
✅ 对程序员友好,也对我这种“半吊子”友好,命令行+网页界面,怎么顺手怎么来
✅ 支持MiniMax这种国内模型,不用翻wall,稳定得一批

二、安装篇:每一步都在踩坑,每一步都在救场

原以为安装就是“复制命令→回车→搞定”,结果现实给了我狠狠一击,三个坑,把我折腾得怀疑人生

2.1 第一坑:Node.js版本太低,直接给我摆脸子

按照官方文档,兴致勃勃输了安装命令,结果终端直接红了,给我扔来一句:
node: v16.x.x is not supported
OpenClaw requires node >= 18
我:???我电脑里的Node.js,居然是“老古董”了?合着我这第一步就卡住了?
还好我反应快,赶紧用nvm升级,一顿操作猛如虎:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22
等待安装的那几分钟,我全程祈祷:别再出问题了,孩子真的会谢🙏

2.2 第二坑:npm证书过期,被公司网络背刺

好不容易升级完Node,兴致勃勃输入:
npm install -g openclaw
结果又双叒叕报错了,还是红色的,看得我眼睛都疼:
npm ERR! code CERTIFICATE_EXPIRED
npm ERR! certificate has expired
查了半天才知道,是公司网络搞的鬼——SSL劫持,导致证书过期。合着我不仅要跟软件斗,还要跟公司网络斗?
解决方法很简单,临时跳过证书验证,主打一个“先上车后补票”:
npm install -g openclaw –insecure

2.3 第三坑:Chrome安装失败,brew也来添乱

OpenClaw的浏览器工具需要Chrome,我想着用brew安装最方便,结果输完命令,又报错了:
Error: It seems the cask file is not downloaded.
我真的会谢!Apple Silicon Mac的Chrome版本居然有坑?没办法,只能重新安装,一顿操作:
brew reinstall –cask google-chrome
这次终于成功了,安装完成的那一刻,我差点原地欢呼🎉

三、邮件配置:Gmail坑王实锤,差点放弃发邮件

我的核心需求之一,就是让AI帮我自动发邮件,结果这里的坑,比安装时还多,每一个都让我想放弃

3.1 坑1:mac自带Mail.app,根本用不了!

我一开始想着,用mac自带的邮件应用多方便,结果OpenClaw根本读不到它的SMTP凭据——人家的密钥藏在系统钥匙串里,外部程序根本访问不了,相当于“看得见摸不着”,白忙活一场😅
结论:macOS Mail.app,直接pass,别浪费时间!

3.2 坑2:改用msmtp,配置文件搞懵我

查了攻略,说用msmtp这个命令行工具可以解决,于是我兴致勃勃写了配置文件 ~/.msmtprc:
account default
host smtp.gmail.com
port 587
auth on
user hare.ding@gmail.com
password 你的Gmail应用密码
tls on
tls_starttls on
看起来很简单对不对?错!后面的坑才刚刚开始

3.3 坑3:Gmail应用密码,居然有空格!

Gmail要生成应用密码,必须先开两步验证,这个我知道。但生成的密码居然是这样的:
zocd eaqy lvjj hsxh
有空格!我一开始直接复制粘贴到配置文件里,结果认证失败,试了好几次都不行,差点把电脑砸了。后来才知道,配置文件里必须去掉空格,连成一串,比如 zocdeaqylvjjhsxh,真的会谢,这个坑谁能想到啊😭

3.4 坑4:中文邮件乱码,尴尬到抠脚

终于搞定了认证,能发邮件了,结果发出去的中文标题全是乱码,别人收到还以为我发了什么加密信息。查了半天才知道,msmtp不会自动编码中文标题,得手动用Python处理:
from email.header import Header
msg[‘Subject’] = Header(‘邮件主题’, ‘utf-8’)
改完之后,终于能正常发中文邮件了,那一刻,我感觉自己又行了!

四、微信接入:差点被封号,吓出一身冷汗

搞定了邮件,接下来就是微信接入,毕竟日常沟通都靠微信,能让AI帮我回复消息,想想就爽。结果这里,又差点踩了大雷!

4.1 坑1:第三方协议,封号风险拉满

一开始想图省事,用WeChatPadPro这种第三方中间件,原理是模拟iPad协议桥接微信。结果查了一圈攻略,吓得我赶紧卸载——这种第三方工具,很容易被微信检测到,轻则限流,重则直接封号,我可不想我的微信账号没了,果断放弃!

4.2 救星:腾讯官方微信插件

还好有官方方案,直接安装腾讯官方的OpenClaw微信插件,安全又稳定:
npx -y @tencent-weixin/openclaw-weixin-cli install
安装完,手机微信扫码授权,再重启网关:
openclaw gateway restart

4.3 坑2:消息收不到,插件罢工了?

重启网关后,我兴奋地给微信发消息,结果AI一点反应都没有,我瞬间慌了——不会又出问题了吧?
赶紧查网关状态:
openclaw gateway status
果然,日志里有错误,原来是插件没加载成功,重新加载一下,立马就好了。虚惊一场,差点又崩溃了😮💨

五、自定义Skill:OpenClaw的灵魂,让AI真正“会干活”

折腾到这里,其实已经能正常用了,但OpenClaw最牛的地方,还是自定义Skill——简单说,就是给AI“教技能”,让它能帮你做特定的事,比如查股票、查天气。
什么是Skill?说白了,就是一个Markdown文件,相当于给AI写的“操作手册”,告诉它:什么时候触发这个技能、用什么工具、执行什么命令、怎么把结果返回给你。
比如我想让AI帮我查股票,就写了一个stock.skill.md:
name: stock
description: 当用户让我查股票、股价、行情的时候,就用这个技能!

股票查询Skill

使用方法:用curl调用腾讯股票API,直接获取实时行情
curl -s “https://qt.gtimg.cn/q=sh600519”
是不是很简单?目前我已经给AI配置了3个实用技能,日常够用了:

Skill名称

功能

stock

查实时股价、行情(比如贵州茅台)

weather

查城市天气、温度、预警,再也不用打开天气APP

blogwatcher

订阅博客RSS,自动监控更新,再也不用手动刷


六、博客订阅:自动追更,摸鱼神器get

我平时喜欢看一些博客、漫画,手动刷更新太麻烦,就用blogwatcher这个工具,配合OpenClaw,实现自动订阅、自动提醒。
安装很简单:
go install github.com/Hyaxia/blogwatcher/cmd/blogwatcher@latest
我先订阅了我最喜欢的XKCD漫画(一个主打数学和浪漫的搞笑漫画):
blogwatcher add “XKCD” “https://xkcd.com/rss.xml”
扫描更新、查看新文章:
blogwatcher scan

扫描更新

blogwatcher articles

查看新文章

目前唯一的小遗憾:阮一峰的博客订阅失败了,应该是RSS地址和工具不兼容,后续再慢慢调试,先把XKCD追更安排上再说😜

七、意外之喜:AI文生图,随手出大片

本来没抱希望,结果发现OpenClaw居然内置了图片生成功能,对接的是MiniMax的模型,不用额外配置,直接跟AI说需求就行:
“画一只LABUBU在月球上弹吉他,可爱一点,背景是星空”
不到10秒,图片就生成了,质量居然还不错,日常做个表情包、封面图,完全够用,简直是意外之喜!

八、边折腾边学习:AI帮我搞定LLM开发笔记

这两天折腾OpenClaw的间隙,我还让AI帮我整理了《AI+LLM大模型应用开发实战》的全套笔记,相当于一边搭系统,一边充电,主打一个高效利用时间。
笔记里涵盖了:大模型基础、Prompt工程、AI Agent、RAG检索增强、工作流设计,甚至还有应用变现思路,相当于免费上了一节LLM开发课,血赚不亏!

总结:折腾两天,爽到飞起!

现在回头看,这两天确实踩了很多坑,从Node.js升级到邮件配置,从微信接入到Skill自定义,每一步都走得磕磕绊绊,甚至有好几次想放弃,但当我看到AI自动给我发邮件、查股票、生成图片的那一刻,所有的折腾都值了!
目前我的OpenClaw,已经能实现这些功能,彻底解放我的双手:
✅ 本地运行,数据安全,不依赖云端
✅ Gmail自动收发邮件,中文标题不乱码
✅ 微信安全对接,不怕封号,能自动回复
✅ 查股票、查天气,随叫随到
✅ 博客RSS自动订阅,不用手动刷更新
✅ AI文生图,随手就能出素材
✅ 自定义Skill,想让它干啥就干啥
最后,给想搭OpenClaw的兄弟姐妹们说几句真心话:
报错不可怕,可怕的是不看报错信息——认真读日志,80%的问题都能解决
网络环境很重要,提前准备好稳定的网络,避免被SSL、代理坑
遇到问题先搜一搜,大概率有人跟你踩过一样的坑,别自己死磕
不要怕折腾,每解决一个问题,你对AI Agent的理解就深一层,折腾的过程,也是学习的过程

彩蛋:AI给我画的“折腾实录”

最后,我让AI给我生成了一张漫画——《程序员深夜搭建OpenClaw的精神状态》,简直是我这两天的真实写照,笑不活了😂(图片见附件)
后续我会继续优化Skill,接入更多工具(比如备忘录、日历),把它打造成真正的全能AI助理。
如果你也在搭建OpenClaw,或者想玩本地AI Agent,欢迎在评论区交流,一起避坑、一起折腾,让AI真正帮我们省时间、提效率!