乐于分享
好东西不私藏

OpenClaw 完整教程:从安装到 QQ 对接,一键发布微信公众号

OpenClaw 完整教程:从安装到 QQ 对接,一键发布微信公众号

OpenClaw 完整教程:从安装到 QQ 对接,一键发布微信公众号

手把手教你搭建个人 AI 助手,还能自动发公众号文章!

你是否想过:

  • 拥有一个 24 小时在线的私人 AI 助手?
  • 通过 QQ 随时对话,问天气、查资料、写代码?
  • 一键发布文章到微信公众号?

今天这篇教程,带你从零开始,完整搭建 OpenClaw!


一、什么是 OpenClaw?

OpenClaw 是一个开源 AI 助手框架,让你可以轻松:

  • 部署私人 AI 助手
  • 对接多个聊天平台(QQ、微信、Telegram 等)
  • 扩展技能(天气、安全审计、公众号发布等)
  • 定时任务、自动化工作流

核心特点:

  • 开箱即用,配置简单
  • 插件化架构,无限扩展
  • 支持多平台消息收发
  • 适配主流大模型(Qwen、GPT、Claude 等)

二、安装 OpenClaw

前置要求

  • Node.js 18+(推荐 v20+)
  • npm 或 yarn
  • 一台能联网的电脑/服务器

步骤 1:安装 Node.js

Windows 用户:

  1. 访问 https://nodejs.org/[1]
  2. 下载 LTS 版本
  3. 一路下一步安装

验证安装:

node -vnpm -v

步骤 2:安装 OpenClaw

npm install -g openclaw

步骤 3:初始化配置

openclaw init

会提示你配置:

  • 模型提供商(推荐用 Qwen、DeepSeek 等)
  • API Key
  • 工作目录

步骤 4:启动 Gateway

openclaw gateway start

看到 Gateway started 就说明成功了!

步骤 5:验证安装

openclaw status

三、配置 QQ 机器人

3.1 获取 QQ Bot 配置

参考下面链接进行配置即可

https://q.qq.com/qqbot/openclaw/index.html

3.2 重启 Gateway

openclaw gateway restart

3.3 测试 QQ 对话

用另一个 QQ 号给你的机器人发消息,应该能收到回复!


四、配置发布平台

4.1 安装发布工具

npm install -g @wenyan-md/cli

4.2 获取平台配置信息

  1. 登录平台管理界面
  2. 进入开发设置页面
  3. 获取以下信息:
    • 应用标识(AppID)
    • 安全密钥(AppSecret)

4.3 配置访问许可

重要!需要将你的服务器地址添加到许可列表:

  1. 获取当前网络地址
  2. 在平台设置中添加该地址到许可列表

4.4 保存配置信息

将获取到的配置信息保存到安全位置:

# 保存配置APP_ID=你的应用标识APP_SECRET=你的安全密钥

或者设置环境变量:

Windows PowerShell:

$env:APP_ID="你的标识"$env:APP_SECRET="你的密钥"

Linux/Mac:

export APP_ID=你的标识export APP_SECRET=你的密钥

💡 小提示: 配置信息请妥善保管,不要公开分享哦!


五、一键发布文章到公众号

5.1 准备 Markdown 文章

创建文章文件(如 article.md):

---title: 我的第一篇文章cover: https://example.com/cover.jpg---# 文章标题正文内容...

注意:

  • title 和 cover 都是必填!
  • 封面图可以用本地路径或网络 URL

5.2 发布文章

方法 1:使用 wenyan-cli 直接发布

wenyan publish -f article.md -t lapis -h solarized-light

方法 2:在 OpenClaw 中发布

直接在 QQ 或对话框中说:

帮我把这篇文章发布到微信公众号 + 附上文件路径

AI 会自动调用 wechat-publisher 技能!

5.3 查看草稿

发布成功后:

  1. 登录公众号后台
  2. 进入 内容与素材 - 草稿箱
  3. 找到刚发布的文章
  4. 预览、编辑、群发

六、实战演示

场景 1:QQ 对话查天气

你:北京今天天气怎么样?

AI:北京:晴 +25 度,东南风 3 级,湿度 45%

场景 2:一键发公众号

你:帮我发布这篇文章到微信公众号

AI:发布成功!请登录公众号后台查看草稿箱

场景 3:定时提醒

你:每天早上 8 点提醒我看新闻

AI:已创建定时提醒,每天 08:00 准时推送


七、常见问题

Q1: Gateway 启动失败?

检查:

openclaw status

解决:

  • 确认 Node.js 版本 ≥ 18
  • 检查配置文件语法
  • 查看日志:openclaw gateway logs

Q2: QQ 收不到消息?

检查:

  • NapCat 是否正常运行
  • WebSocket 地址是否正确
  • 防火墙是否阻止连接

Q3: 公众号发布失败?

常见错误:

错误 1:invalid appid

  • 检查 APP_ID 是否正确
  • 确认公众号类型(订阅号/服务号)

错误 2:ip not in whitelist

  • 获取当前公网 IP
  • 添加到公众号后台白名单

错误 3:title is required

  • Markdown 文件必须包含 frontmatter
  • title 和 cover 缺一不可

Q4: 如何更新 OpenClaw?

npm update -g openclawopenclaw gateway restart

八、常用技能推荐

安装 OpenClaw 后,推荐试试这些技能:

  • weather:天气预报,直接问"北京天气"
  • healthcheck:安全审计,"帮我做安全检查"
  • clawhub:技能市场,"搜索 notion 技能"
  • wechat-publisher:公众号发布,"发布这篇文章"

学习资源

  • 官方文档:https://docs.openclaw.ai[3]
  • GitHub 仓库:https://github.com/openclaw/openclaw[4]
  • 技能市场:https://clawhub.com[5]
  • 社区 Discord:https://discord.com/invite/clawd[6]

结语

恭喜你完成 OpenClaw 的完整搭建!

现在你拥有:

  • 24 小时在线的私人 AI 助手
  • 可以通过 QQ 随时对话
  • 一键发布微信公众号文章

接下来可以:

  1. 探索更多技能(clawhub search)
  2. 自定义技能(skill-creator)
  3. 设置定时任务(cron)
  4. 对接更多平台(Telegram、WhatsApp 等)

有任何问题,欢迎在评论区留言!

觉得有用?欢迎点赞、在看、转发!

关注我,获取更多 AI 实战教程!