手把手教你配置 OpenClaw 微信公众号发布技能(避坑指南)

> 文 / 卡哥
> 这是「卡哥 AI 实操」的第 1 篇原创


为什么写这篇文章

昨天有个粉丝问我:"卡哥,能不能让 AI 自动发公众号文章?"

我说能,但需要配置一下。

结果他折腾了一下午,卡在 IP 白名单那一步动不了。

所以我决定把完整的配置过程写下来,包括我踩过的所有坑。

你照着做,30 分钟搞定


开始前需要准备的东西

👉 已注册的微信公众号(订阅号或服务号都行)


👉 一台能联网的电脑(Windows / Mac 都可以)


👉 Node.js 环境(如果没装,后面会教)


👉 你的 AppID 和 AppSecret(公众号后台获取)


第一步:获取 AppID 和 AppSecret

登录微信公众平台:https://mp.weixin.qq.com

扫码登录后,点击左侧菜单的 开发 → 基本配置

在这个页面你能看到 AppID(类似 wx1ec4bd8707cd30c4)和 AppSecret。

注意:
- AppSecret 需要点击"重置"才能看到(重置后旧的会失效)
- 把这两个值复制到记事本,后面要用

⚠️ 易错点:
- 不要直接截图保存 AppSecret(不安全)
- 复制时注意不要多复制空格


第二步:配置 IP 白名单(最容易卡住的地方)

还在"基本配置"页面,往下翻,找到 IP 白名单

点击"修改",添加你的服务器 IP。

如果你不知道自己的 IP 是什么:

打开浏览器,访问:https://ip138.com

页面上显示的第一个 IP 就是你的公网 IP。

⚠️ 易错点(我在这栽了两次):
- 家里宽带的 IP 会变(动态 IP),每次变了都要重新配置
- 最好用固定 IP 的服务器
- 配置后需要等 1-2 分钟才生效
- 不要配成内网 IP(192.168.x.x 或 10.x.x.x)


第三步:安装 Node.js(如果已安装可跳过)

访问 Node.js 官网:https://nodejs.org

下载 LTS 版本(长期支持版)

下载后一路下一步安装。

验证安装:

打开命令行(Windows 按 Win+R,输入 cmd),输入:

`bash
node -v
npm -v
`

如果显示版本号,说明安装成功。

⚠️ 易错点:
- 安装后需要重启命令行才能生效
- 不要安装最新版(可能有兼容性问题),选 LTS


第四步:创建技能目录

打开命令行,输入:

`bash
mkdir C:\Users\你的用户名\.openclaw\skills\wechat-mp-publisher-1.0.0
cd C:\Users\你的用户名\.openclaw\skills\wechat-mp-publisher-1.0.0
`

⚠️ 易错点:
- 路径中的用户名要改成你自己的
- 注意斜杠方向(Windows 用 \/ 都可以)


第五步:创建配置文件

在刚才创建的目录里,新建一个文本文件,命名为 .env

注意: Windows 默认会隐藏已知文件扩展名,你可能需要先在文件夹选项里取消勾选"隐藏已知文件扩展名"。

用记事本打开 .env 文件,输入:

`
WECHAT_APPID=wx1ec4bd8707cd30c4
WECHAT_APPSECRET=4e96cce78b6b5d3e021776a484e2a232
`

把上面的值换成你第一步里复制的 AppID 和 AppSecret。

⚠️ 易错点:
- 文件名必须是 .env(前面有个点)
- 等号两边不要有空格
- 不要有多余的空行或空格
- 这个文件不要发给别人(包含你的密钥)


第六步:安装依赖

在命令行输入:

`bash
npm install axios dotenv
`

⚠️ 易错点:
- 确保在正确的目录执行(就是第四步创建的目录)
- 如果下载慢,可以换淘宝镜像:npm config set registry https://registry.npmmirror.com


第七步:测试 Token 获取

在命令行输入:

`bash
node index.js token
`

成功的样子:

`
Access Token: 21_XXXXXXXXXXXXXXXXXXXXXXXXXXXXX
`

失败的样子(常见错误):

`
❌ 错误:网络错误:获取 token 失败:invalid ip xxx.xxx.xxx.xxx, not in whitelist
`

这说明 IP 白名单没配好,回到第二步重新检查。

⚠️ 易错点:
- 配置 IP 白名单后需要等 1-2 分钟
- 确保 .env 文件和 index.js 在同一个目录
- 确保安装了 dotenv


第八步:测试发布文章

Token 获取成功后,可以测试发布文章了。

在命令行输入:

`bash
node index.js publish --file article.txt --title "测试文章" --author "卡哥"
`

成功的样子:

`
📝 创建草稿:测试文章
✅ 草稿创建成功,media_id: XXXXXXXX
`

然后登录公众号后台,在"内容与互动 → 草稿箱"里能看到刚才发布的文章。

⚠️ 易错点:
- 订阅号每天只能发 1 次,测试前想好
- 发布的内容会进入审核,违规内容会被拒绝
- 第一次发布建议用简单的测试内容


常见问题汇总

Q1:提示"appid missing"

原因: .env 文件没被正确读取

解决:

👉 检查 .env 文件名是否正确(前面有个点)


👉 检查文件内容格式(等号两边不要有空格)


👉 确保安装了 dotenv


Q2:提示"invalid ip,not in whitelist"

原因: IP 白名单没配置或配置错了

解决:

👉 重新检查第二步的配置


👉 确认配置的是公网 IP,不是内网 IP


👉 配置后等 1-2 分钟再试


👉 家里宽带 IP 会变,变了要重新配


Q3:npm install 特别慢

原因: 默认源在国外

解决:
`bash
npm config set registry https://registry.npmmirror.com
`


Q4:发布后文章没显示

原因: 文章进入审核流程

解决:
- 正常现象,等几分钟
- 如果长时间不显示,检查内容是否违规
- 可以在公众号后台"发表记录"里查看审核状态


最后说两句

配置过程看着步骤多,其实就三件事:

👉 拿到 AppID 和 AppSecret


👉 配好 IP 白名单


👉 装好依赖跑起来

最容易卡住的是 IP 白名单,多试几次就行。

如果还有问题,可以在评论区留言,我看到会回复。


下篇预告

下篇文章我会写:《用 AI 自动生成公众号文章,每天节省 2 小时》

想看的点个在看,让我知道你需要。


我是卡哥,一个喜欢折腾的 AI 实践者。

关注公众号「卡哥 AI 实操」,一起用 AI 提效。


本文完