OpenClaw 安装指南

本文档对应 OpenClaw 专用 skill 包 platforms/openclaw/md2wechat/。

skills/md2wechat/ 是给 Claude Code / Codex / OpenCode 的 coding-agent skill，两条路径独立维护。

OpenClaw 路径由两部分组成：OpenClaw skill 壳 + 已安装的 md2wechat CLI。当前不再保留 skill 内部 run.sh wrapper，也不承担首跑动态下载。

什么是 OpenClaw

OpenClaw 是一个开源的 AI Agent 平台，在你的设备上运行，通过你已经在用的聊天应用（WhatsApp、Telegram、Discord、Slack、Teams）来操控 AI 助手。

The AI that actually does things.

清理收件箱、发送邮件、管理日历、航班值机——全部通过你熟悉的聊天应用完成。

OpenClaw 核心理念：

Your assistant. Your machine. Your rules.
你的助手。你的设备。你的规则。

与 SaaS 助手的区别： OpenClaw 运行在你选择的地方——笔记本、家用服务器或 VPS。你的基础设施，你的密钥，你的数据。

OpenClaw 特点：

🦞 开源免费 - 100,000+ GitHub Stars
🏠 本地运行 - 数据留在你的设备上
💬 多渠道支持 - WhatsApp、Telegram、Discord、Slack、Teams、Twitch、Google Chat
🤖 多模型支持 - Claude、GPT、DeepSeek、KIMI K2.5、Xiaomi MiMo 等
🔌 ClawHub 技能市场 - 安装和分享 AgentSkills

官方链接：

官网：openclaw.ai
文档：docs.openclaw.ai
技能市场：clawhub.ai
当前技能页面：clawhub.ai/geekjourneyx/skills/md2wechat
GitHub：github.com/openclaw/openclaw

安装方式

方式一：ClawHub 安装（仅安装 skill 壳）

这是当前最直接的官方 skill 壳安装方式：

# 安装 OpenClaw 专用 md2wechat skill 包
openclaw skills install @geekjourneyx/md2wechat

原生命令默认把 skill 安装到当前 active workspace 的 skills/。如果需要用户级共享并保留 OpenClaw 的安装追踪，使用：

openclaw skills install @geekjourneyx/md2wechat --global

--global 安装和本文的手动共享安装都使用 ~/.openclaw/skills。无论采用哪种方式，当前实际可见的 Source 和 Path 都以 openclaw skills info md2wechat 为准。

Skill metadata 使用 OpenClaw 官方 Node 安装资源声明 @geekjourneyx/md2wechat。如果运行环境没有自动安装依赖，按下一节用 npm 安装 CLI。

如果你更习惯从网页进入当前技能页面，可以直接打开：

clawhub.ai/geekjourneyx/skills/md2wechat

方式二：通过 npm 安装 CLI

这是 macOS 和 Linux 的主安装路径：

npm install -g @geekjourneyx/md2wechat
openclaw skills install @geekjourneyx/md2wechat

第一条安装 CLI，第二条安装 OpenClaw skill 壳。两者完成后直接运行验证命令。

Windows 可选安装器

Windows 用户也可以使用固定版本 PowerShell 安装器：

Invoke-WebRequest https://github.com/geekjourneyx/md2wechat-skill/releases/download/v3.2.0/install-openclaw.ps1 -OutFile install-openclaw.ps1
powershell -ExecutionPolicy Bypass -File .\install-openclaw.ps1

macOS 和 Linux 不再提供 OpenClaw 专用 shell 安装器，使用 npm + ClawHub 即可。

发给 Agent 的对话脚本

如果你不想自己一步步敲命令，可以直接把下面的话发给 OpenClaw、Claude、GPT 或其他 Agent：

请帮我安装 OpenClaw 版 md2wechat，并验证 skill 和 CLI 都可用。
按这个顺序执行：
1. npm install -g @geekjourneyx/md2wechat
2. openclaw skills install @geekjourneyx/md2wechat
3. openclaw skills info md2wechat
4. md2wechat version --json
5. md2wechat config init
6. md2wechat config validate
7. md2wechat capabilities --json
8. md2wechat skills read md2wechat --json
9. 确认 `command -v md2wechat` 有输出
如果某一步失败，请继续排查并给我下一条修复命令，不要只返回报错原文。

方式三：手动安装

# 1. 下载固定版本 release 资产
VERSION=3.2.0
# 按你的平台选择对应二进制，这里以 Linux amd64 为例
curl -LO https://github.com/geekjourneyx/md2wechat-skill/releases/download/v${VERSION}/md2wechat-openclaw-skill.tar.gz
curl -LO https://github.com/geekjourneyx/md2wechat-skill/releases/download/v${VERSION}/md2wechat-linux-amd64
curl -LO https://github.com/geekjourneyx/md2wechat-skill/releases/download/v${VERSION}/checksums.txt
sha256sum -c checksums.txt --ignore-missing

# 2. 解压并复制技能目录
mkdir -p /tmp/md2wechat-openclaw
tar -xzf md2wechat-openclaw-skill.tar.gz -C /tmp/md2wechat-openclaw
mkdir -p ~/.openclaw/skills
cp -r /tmp/md2wechat-openclaw/skills/md2wechat ~/.openclaw/skills/

# 3. 安装 CLI 到用户级环境路径
mkdir -p ~/.local/bin
install -m 0755 md2wechat-linux-amd64 ~/.local/bin/md2wechat
export PATH="$HOME/.local/bin:$PATH"

手动安装时，请以同一版本 release 提供的 OpenClaw 资产为准，确保 skill 包与 md2wechat CLI 同版本安装。

配置说明

安装完成后，直接初始化 md2wechat 自己的配置文件即可。

初始化配置文件

md2wechat config init
md2wechat config validate

默认配置文件路径：

~/.config/md2wechat/config.yaml

Discovery、inspect、preview 和无发布副作用的本地转换不要求微信公众号凭证。只有显式上传或创建草稿时才配置 WECHAT_APPID / WECHAT_SECRET；推荐写入这里，而不是把它们设成 openclaw.json 的全局 skill 环境要求。

最小示例：

wechat:
  appid: "你的AppID"
  secret: "你的Secret"

配置项说明

环境变量	必需	说明	获取方式
`WECHAT_APPID`	草稿上传时	微信公众号 AppID	微信开发者平台 → 开发接口管理
`WECHAT_SECRET`	草稿上传时	微信公众号 Secret	同上，点击"重置"获取
`IMAGE_API_KEY`	AI 图片时	图片生成 API Key	见图片服务配置

可选：图片生成配置

如果需要 AI 图片生成功能，在同一份 config.yaml 中继续添加：

wechat:
  appid: "你的AppID"
  secret: "你的Secret"
api:
  image_provider: "volcengine"
  image_key: "your-ark-api-key"
  image_model: "seedream-3-0"
  image_size: "2K"

验证安装

检查已安装技能

openclaw skills info md2wechat

命令应返回 md2wechat 的技能信息及当前可见的 Source、Path。原生安装默认位于 active workspace 的 skills/，使用 --global 或本文的手动共享安装时位于 ~/.openclaw/skills；不要只用某个固定目录作为安装成功依据。

测试运行

md2wechat --help

如果当前 shell 还找不到 md2wechat，先执行：

export PATH="$HOME/.local/bin:$PATH"

建议再执行一轮发现命令，确认当前 CLI 和资源都可见：

md2wechat capabilities --json
md2wechat skills list --json
md2wechat skills read md2wechat --json
md2wechat providers list --json
md2wechat providers show volcengine --json
md2wechat themes list --json
md2wechat prompts list --json

capabilities 提供聚合路由事实；资源 list 提供轻量选择字段，选定后再用 show 读取完整定义，render 负责物化 prompt/layout。JSON stdout 是单行紧凑对象并以换行结束，需要人工查看时加 | jq。

skills read 读取当前 CLI 二进制内置的核心 coding-agent SOP，用来确认运行时协议和 CLI 版本一致。OpenClaw 是否已发现当前 skill、实际来源和解析路径以 openclaw skills info md2wechat 为准；仓库内的平台差异说明位于 platforms/openclaw/md2wechat/SKILL.md。

如果你要选图片模型，优先看 providers show <name> --json 返回的 supported_models，不要凭记忆写死。

在 OpenClaw 中使用

启动 OpenClaw 后，直接用自然语言交互：

请用秋日暖光主题将 article.md 转换为微信公众号格式

常见问题

Q: 安装后找不到技能？

A: 让 OpenClaw 从当前 workspace 查询技能：

openclaw skills info md2wechat

如果命令找不到技能，回到需要使用该技能的 workspace，重新运行 openclaw skills install @geekjourneyx/md2wechat。

Q: 运行时报错 "command not found"？

A: 先确认 md2wechat CLI 已经通过 npm 安装，并确认可执行文件可用：

md2wechat --help

如果仍然找不到命令，请重新执行 npm install -g @geekjourneyx/md2wechat，并检查 npm 全局 bin 目录是否在 PATH 中。

Q: 我不想看文档，能不能直接发一句话给大模型？

A: 可以，直接复制这一段：

请帮我安装 OpenClaw 版 md2wechat，并验证 CLI、配置初始化和能力发现都正常。
执行：
1. npm install -g @geekjourneyx/md2wechat
2. openclaw skills install @geekjourneyx/md2wechat
3. openclaw skills info md2wechat
4. md2wechat version --json
5. md2wechat config init
6. md2wechat config validate
7. md2wechat capabilities --json
8. md2wechat skills read md2wechat --json
如果失败，请继续排查 OpenClaw 返回的技能状态、PATH 和版本，不要只给我错误信息。

Q: 如何更新技能？

# 更新 CLI
npm install -g @geekjourneyx/md2wechat

# 更新 workspace 内由 OpenClaw 追踪的安装（在原安装 workspace 执行）
openclaw skills update @geekjourneyx/md2wechat

# 更新通过 --global 安装并由 OpenClaw 追踪的安装
openclaw skills update @geekjourneyx/md2wechat --global

如果使用本文的手动 archive 流程安装，OpenClaw 没有对应的 tracked install；请重新执行“方式三：手动安装”，不要使用 skills update。

Q: 配置没生效？

A: 先确认你改的是 md2wechat 自己的配置文件，而不是旧的 OpenClaw skill 环境配置。优先检查：

md2wechat config show --format json
md2wechat config validate

Q: 和 Claude Code 安装冲突吗？

A: 不冲突。两个平台使用不同的目录：

平台	技能目录
Claude Code	`~/.claude/skills/`
OpenClaw	默认是 active workspace 的 `skills/`；`--global` 或本文手动共享路径是 `~/.openclaw/skills`；实际位置以 `skills info` 返回的 `Path` 为准

可以同时安装在两个平台。

与 Claude Code 的区别

方面	Claude Code	OpenClaw
定位	终端 AI 编程助手	聊天应用 AI 助手（WhatsApp/Telegram 等）
运行方式	本地终端	本地运行，通过聊天应用操控
仓库内 skill 路径	`skills/md2wechat/`	`platforms/openclaw/md2wechat/`
技能目录	`~/.claude/skills/`	默认是 active workspace 的 `skills/`；共享路径是 `~/.openclaw/skills`；实际位置以 `openclaw skills info md2wechat` 为准
安装方式	`/plugin` 命令	npm + `openclaw skills install @geekjourneyx/md2wechat`
配置文件	环境变量 / `~/.config/md2wechat/config.yaml`	`~/.config/md2wechat/config.yaml`
LLM 支持	Claude	Claude、GPT、DeepSeek、KIMI 等
市场	Plugin Marketplace	ClawHub

说明： 两个平台共享同一个 CLI 内核，但 skill 包和安装链分开维护。

Navigation Menu

OpenClaw 安装指南

目录

什么是 OpenClaw

安装方式

方式一：ClawHub 安装（仅安装 skill 壳）

方式二：通过 npm 安装 CLI

Windows 可选安装器

发给 Agent 的对话脚本

方式三：手动安装

配置说明

初始化配置文件

配置项说明

可选：图片生成配置

验证安装

检查已安装技能

测试运行

在 OpenClaw 中使用

常见问题

Q: 安装后找不到技能？

Q: 运行时报错 "command not found"？

Q: 我不想看文档，能不能直接发一句话给大模型？

Q: 如何更新技能？

Q: 配置没生效？

Q: 和 Claude Code 安装冲突吗？

与 Claude Code 的区别

相关链接

FilesExpand file tree

OPENCLAW.md

Latest commit

History

OPENCLAW.md

File metadata and controls

OpenClaw 安装指南

目录

什么是 OpenClaw

安装方式

方式一：ClawHub 安装（仅安装 skill 壳）

方式二：通过 npm 安装 CLI

Windows 可选安装器

发给 Agent 的对话脚本

方式三：手动安装

配置说明

初始化配置文件

配置项说明

可选：图片生成配置

验证安装

检查已安装技能

测试运行

在 OpenClaw 中使用

常见问题

Q: 安装后找不到技能？

Q: 运行时报错 "command not found"？

Q: 我不想看文档，能不能直接发一句话给大模型？

Q: 如何更新技能？

Q: 配置没生效？

Q: 和 Claude Code 安装冲突吗？

与 Claude Code 的区别

相关链接