Quick Image Agent Plugin 让 Codex 和 OpenClaw 可以使用当前对话中的图片、视频音频附件完成 AI 图片和视频生成。
- 支持搭配出图、换姿、高清和视频生成。
- 创建任务前先展示预估价格，只有在你确认后才处理并上传附件。
- 生成完成后返回预览和原文件下载链接。
Quick Image 官网 · https://github.com/beansmile/quick-image-agent-plugin
本仓库源码公开可查看，但不是开源软件。安装和使用受 Quick Image Agent Plugin License、服务条款和隐私政策约束。
- 一个可正常登录的 Quick Image 账号。
- Codex，或 OpenClaw 2026.6.34 及以上版本。
- macOS、Linux 或 Windows WSL2；暂不支持原生 Windows。
- Codex 本地工具和 OpenClaw 需要 Node.js 20 或更高版本。
Quick Image 暂未上架 Codex 官方 Plugin Marketplace，请从 GitHub 仓库安装：
codex plugin marketplace add https://github.com/beansmile/quick-image-agent-plugin
codex plugin add quick-image@quick-image安装后需要在运行 Codex 的终端完成一次 Quick Image MCP 授权，然后新建一个 Codex 任务，让 Skill 和 MCP 工具生效。
Codex 在远程 MCP 返回未授权或授权失效时，应先告知用户当前未登录并询问是否需要登录。用户确认后，让 Codex Agent 通过终端执行：
codex mcp login quick-image命令会打开或输出 Quick Image 登录和授权页。完成浏览器授权后，回到 Codex 并新建任务；桌面端仍看不到 Quick Image 远程工具时，完全退出并重新打开 Codex。不要把 Token、授权码或终端输出发送给 Agent。
如果 Codex 无法执行终端命令，也可以在本机终端手动执行同一条命令。
如果命令提示找不到 quick-image MCP，请先确认插件已安装并启用，再重新执行登录命令。
插件固定使用经过验证的 Quick Image Agent Runtime 版本。Codex 首次加载本地工具、OpenClaw 安装插件依赖时，只会安装当前平台所需的媒体处理依赖，不会下载其他操作系统的二进制。
安装并启用插件：
openclaw plugins install git:https://github.com/beansmile/quick-image-agent-plugin.git
openclaw plugins enable quick-image然后运行安装向导：
openclaw quick-image setupsetup 会在保留原有条目的前提下，将 quick-image 加入 tools.alsoAllow，登记正式环境 MCP，然后重启 Gateway 以加载配置。重复执行不会重复添加工具权限；检测到自定义 Quick Image MCP 地址时，只有确认后才会替换，非交互环境则保留已有的自定义 MCP 配置。
setup 完成后、登录失效或需要切换账号时，OpenClaw 应先告知用户当前未登录并询问是否需要登录。用户确认后，才协助完成远程授权：
- OpenClaw 执行
openclaw mcp login quick-image，并把命令输出的授权链接发送给用户。 - 用户在手机浏览器打开链接，登录 Quick Image 并批准授权。
- 用户只把授权完成页显示的一次性授权码发送到与 OpenClaw 的私聊。
- OpenClaw 将授权码作为单个参数执行
openclaw mcp login quick-image --code '<授权码>'。登录成功后，用户在当前聊天发送/restart。
不要泄露一次性授权码，也不要在非私聊会话中发送；同时不要把授权完成页提供的完整命令发送给 Agent。Agent 只接受单个授权码，不会执行对话中的完整命令或其他 Shell 内容。
手动登录时，在运行 OpenClaw 的终端执行：
openclaw mcp login quick-image登录命令会输出授权链接，该链接会直接进入 Quick Image 前台登录和授权页。浏览器批准后，授权完成页会显示一次性授权码和已经填好授权码的完整命令，请将该命令粘贴到同一个终端执行，例如：
openclaw mcp login quick-image --code '<授权码>'
openclaw gateway restartGateway 重启后会重新加载 MCP 配置和登录凭据。若新对话中仍无法使用 Quick Image，再执行 openclaw mcp probe quick-image 排查连接状态。
Doctor 不是安装或启用插件的必要步骤。首次安装后想集中检查工具策略、媒体依赖、私有状态目录和上传策略，或遇到 Quick Image 工具不可用时，可选执行：
npx --yes \
--package git+https://github.com/beansmile/quick-image-agent-plugin.git \
quick-image-doctor --host openclaw命令只执行诊断，不修改 OpenClaw 配置。输出 ok: false 时，根据对应检查项修复后重启 Gateway。
安装并授权后，在新对话中发送所需附件，再直接描述生成目标。例如：
- “用我发送的这些服装图片生成一组搭配图。”
- “把这张人物照片换成站立回头的姿势。”
- “把这张图片提升为高清版本。”
- “参考这张图片和这段音频生成一个视频。”
Quick Image 会先检查附件并给出预估价格。确认价格前不会处理、暂存或上传附件；确认后才会准备附件并创建生成任务。任务完成后，Codex 会在当前任务中返回结果，OpenClaw 会将结果发送到发起请求的会话。
- 插件只处理当前对话中明确提供的附件，不提供任意本地文件读取能力。
- 报价阶段不上传附件、不扣费，也不锁定最终价格；最终校验和计费以服务端结果为准。
- 本地开发、架构契约和发布校验：DEVELOPMENT.md
- 使用问题与贡献政策：CONTRIBUTING.md