OpenClaw 里怎么安装和使用 md2wechat-skill

OpenClaw 是最容易把两件不同事情混在一起的地方。

很多人装好了 skill 壳，就以为 runtime 也自然存在了。

恰恰是这个假设，让整个工作流直接失效。

什么心智模型最适合 OpenClaw

在 OpenClaw 里，你应该始终把它拆成两个部分理解：

• OpenClaw 的 skill 壳
• md2wechat CLI runtime

两者都要有。

只要其中一个存在、另一个缺失，集成仍然是坏的。

这也是为什么 OpenClaw 绝对不能被写成和 Claude Code、Codex 同一路径。

最快的完整安装路径

最直接的安装方式是：

curl -fsSL https://github.com/geekjourneyx/md2wechat-skill/releases/download/v2.0.7/install-openclaw.sh | bash
export PATH="$HOME/.local/bin:$PATH"

这个安装器的意义就在这里：它最容易让你同时得到版本一致的 skill 包和 CLI runtime。

如果你只是先想把 CLI 装进环境里，而且本机已经有 Node 和 npm，也可以先执行：

npm install -g @geekjourneyx/md2wechat

但这一步只会装 CLI，不会自动把 OpenClaw 的 skill 壳写进 ~/.openclaw/skills/md2wechat/。

ClawHub 路径是什么

如果你已经在用 ClawHub，也可以先装 skill 壳：

npx clawhub@latest install md2wechat

它可以成为一个不错的 skill 壳安装入口，但它并不保证 md2wechat CLI 也一定已经可用。

所以 ClawHub 之后，你仍然要检查：

command -v md2wechat

如果没有输出，说明 runtime 还是缺的。

装完之后立刻该验证什么

在做任何发布任务之前，先跑这些：

md2wechat version --json
md2wechat config init
md2wechat config validate
md2wechat capabilities --json
ls ~/.openclaw/skills/md2wechat/

这些命令分别能证明：

• CLI 能调用
• 配置文件能初始化
• discovery 正常
• skill 壳的目录确实存在于 OpenClaw 预期的位置

第一个值得跑的任务是什么

当验证都通过后，先从最朴素的预览任务开始：

md2wechat convert article.md --preview

然后再往上叠更敏感的链路：

md2wechat convert article.md --draft --cover cover.jpg

第二步往往才是微信凭证不全、配置不完整这些问题真正暴露出来的地方。

OpenClaw 里最常见的几个错误

1. 把 ClawHub 安装当成完整故事

它不一定是完整故事。它可能只装了 shell，没有装 runtime。

2. 排查错了目录

OpenClaw 要看的目录是：

~/.openclaw/skills/md2wechat/

不要去排查 ~/.claude/skills/，然后默认结论对 OpenClaw 也成立。

3. 忘了默认模式仍然是 API

即使在 OpenClaw 里，convert 也还是不传 --mode 就默认走 API 模式。

4. 以为不配凭证也能直接发草稿

OpenClaw 并不会消掉这些前提：

• 微信 AppID
• 微信 Secret
• API 模式下通常还需要 md2wechat.cn API Key

一条很好用的 OpenClaw 提示词

如果你想让 Agent 帮你做安装和验证，可以直接发：

请帮我安装 OpenClaw 版 md2wechat，确认 skill 壳和 CLI runtime 都可用，并在做任何转换前先运行 md2wechat capabilities --json。

这条提示词的价值，在于它会强制先做 runtime 检查，再去承诺后面的发布结果。

接下来读什么

• OpenClaw
• md2wechat-skill 使用指南
• md2wechat-skill FAQ