前提条件
- 已安装 Node.js 18+
- 至少一个图片生成提供商:
安装
Claude Code 插件(推荐)
配置提供商
启动一个新的 Claude Code 会话并运行
/meigen:setup。安装向导将引导你完成提供商选择和 API Key 配置。或者,你也可以直接设置环境变量(参见下方提供商配置)。OpenClaw
从 ClawHub 安装完整插件(包含命令、技能和 MCP 服务器):OpenClaw 使用 Agent Skills 开放标准。无需配置 MCP — Skill 会处理一切。
提供商配置
配置一个或多个提供商。当多个提供商可用时,插件按以下顺序选择:MeiGen → ComfyUI → OpenAI 兼容。你可以在每次请求时覆盖此设置。MeiGen Cloud
最简单的入门方式。通过 MeiGen 的托管 API 访问多个 AI 模型(Nanobanana、Seedream、Midjourney V7/Niji 7、Seedance 等)。| 变量 | 值 |
|---|---|
MEIGEN_API_TOKEN | 以 meigen_sk_ 开头的 API Key |
自带 API(OpenAI 兼容)
接入任意符合 OpenAI 接口规范的生图 API — Together AI、Fireworks AI、DeepInfra、硅基流动、OpenAI,或你自己的端点。| 变量 | 值 |
|---|---|
OPENAI_API_KEY | 你的供应商 API Key |
OPENAI_BASE_URL | API 端点(如 https://api.together.xyz/v1) |
OPENAI_MODEL | (可选) 供应商的模型名 |
OPENAI_BASE_URL 指向你的供应商端点。如果省略,默认使用 OpenAI 的 API。
ComfyUI(本地)
在你自己的 GPU 上运行图片生成,完全控制模型、采样器和工作流。免费使用 — 无需 API Key。| 变量 | 值 |
|---|---|
COMFYUI_URL | ComfyUI 服务器地址(默认:http://127.0.0.1:8188) |
- ComfyUI 必须正在运行且可通过配置的 URL 访问
- 你需要至少导入一个工作流模板 — 参见 ComfyUI 指南
ComfyUI 串行处理:每次只生成一张图片。
验证安装
安装完成后,向你的 AI 助手提问:“列出可用的模型”如果配置正确,它会调用
list_models 工具并显示你所有已配置提供商的可用模型。
使用示例
生成图片
“生成一幅水彩风景画,16:9 宽高比”
使用参考图
“生成一张类似这张图片的产品照:[拖入文件或粘贴 URL]“
搜索灵感
“在画廊中搜索美食摄影”
增强提示词
“增强这个提示词:山上的日落”
管理默认设置
“将我的默认风格设为极简摄影”
故障排除
'No image generation providers configured'
'No image generation providers configured'
未设置任何提供商。在 Claude Code 中运行
/meigen:setup,或在 MCP 配置中添加相应的环境变量:- MeiGen:
MEIGEN_API_TOKEN - OpenAI 兼容:
OPENAI_API_KEY - ComfyUI:
COMFYUI_URL(并导入一个工作流)
'Insufficient credits'(MeiGen)
'Insufficient credits'(MeiGen)
API Key 只能使用购买积分,不能使用每日免费积分。请在 meigen.ai 购买积分。
ComfyUI 连接被拒绝
ComfyUI 连接被拒绝
- 确保 ComfyUI 正在运行(在 ComfyUI 目录中执行
python main.py) - 检查
COMFYUI_URL是否与 ComfyUI 启动时显示的地址一致(默认:http://127.0.0.1:8188) - 如果在其他机器上运行,确保端口可访问
ComfyUI 生成失败
ComfyUI 生成失败
- 打开 ComfyUI Web UI 检查错误信息
- 使用
comfyui_workflow view检查工作流节点 - 确保工作流中引用的检查点模型已下载
- 先尝试在 ComfyUI 中手动运行工作流
插件未出现在工具列表中
插件未出现在工具列表中
- 确保已安装 Node.js 18+
- 尝试直接运行
npx -y meigen检查是否有错误 - 重启编辑器
- 检查 MCP 配置 JSON 是否有效
生成超时
生成超时
生成时间因模型和提供商而异。MeiGen Cloud 模型的生成时间在 5-60 秒之间。ComfyUI 取决于你的 GPU 性能。插件最多等待 5 分钟后超时。
配置修改未生效
配置修改未生效
修改
~/.config/meigen/config.json 或环境变量后,你必须重启编辑器(或启动新的 Claude Code 会话)才能使更改生效。