即梦 CLI 体验指南

⚠️ 目前只有即梦高级会员可用

---

简介

即梦 CLI 是一个面向 AGENT 的工具包，让你的 AGENT 能够使用即梦相关的生成能力。

功能特点：

• 一键配置即可启用
• AGENT 能够自动使用你的即梦账号在任意环境进行生成任务
• 通过 CLI 工具，在任意工作流中嵌入即梦生成工具
• 支持批量任务、定时任务自动化

---

更新日志

版本	日期	内容
v1.3.1	2026-04-04	新增自动更新检测能力；优化登录流程稳定性
v1.3.2	2026-04-05	支持 seedance2.0fast_vip 以及 seedance2.0_vip 通道提速
v1.3.3	2026-04-07	修复超清图片任务一直处于排队的问题
v1.3.4	2026-04-10	支持 Linux arm64 平台

---

一、快速上手

如何使用本 Skill

当需要使用即梦进行图片或视频生成任务时，OpenClaw 会自动加载本 Skill。

在 OpenClaw 中触发方式：

• 告诉 Bobby "用即梦生成一张图片" 或 "用即梦做个视频"
• 提到关键词：即梦、Dreamina、seedance

Skill 会自动帮你：

1. 检查 dreamina CLI 是否已安装
2. 确认登录状态
3. 根据你的需求选择合适的命令（文生图/视频、图生图/视频等）
4. 提交任务并追踪结果

---

安装方式

⭐ 推荐：ClawHub 一键安装

懒人办法: 直接把命令复制给agent, 让agent自行安装即可使用skill

clawhub install seedance-cli

安装完成后重启 OpenClaw 即可使用。

手动安装（官方脚本）

curl -fsSL https://jimeng.jianying.com/cli | bash

安装完成后，使用 -h 指令阅读所有功能，并完成登录。

---

二、登录指令

执行登录

dreamina login

该命令会自动拉起你的默认浏览器，引导你完成登录授权。

调试模式

如果浏览器未能自动拉起，或登录过程卡住：

dreamina login --debug

登录成功自检

dreamina user_credit

如果终端能正确返回包含余额信息的 JSON 数据，说明登录状态和环境配置均已生效。

---

三、核心命令用法 (以下都是操作部分, 感兴趣可以了解, 安装skill后agent会自己学习执行)

通用参数说明

--poll=<秒数>：在任务提交命令中加入该参数，工具会在提交任务后以每秒 1 次的频率轮询任务状态，最长等待指定的秒数。

• 若在等待时间内任务完成：直接输出最终结果
• 若等待超时任务仍未完成：返回一个 querying 状态的中间结果，可稍后使用 query_result 命令查询

1. 文生图（text2image）

dreamina text2image \
 --prompt="一只戴墨镜的橘猫" \
 --ratio=1:1 \
 --resolution_type=2k \
 --poll=30

2. 文生视频（text2video）

dreamina text2video \
 --prompt="镜头推进，一只橘猫从沙发上跳下来" \
 --duration=5 \
 --ratio=16:9 \
 --video_resolution=720P \
 --poll=30

3. 图生图（image2image）

dreamina image2image \
 --images ./input.png \
 --prompt="改成水彩风格" \
 --resolution_type=2k \
 --poll=30

注意：--images 参数需要指向一个本地图片文件路径。

4. 图生视频（image2video）

dreamina image2video \
 --image ./first_frame.png \
 --prompt="镜头慢慢推近" \
 --duration=5 \
 --poll=30

注意：--image 参数需要指向一个本地图片文件路径。

5. 查询异步任务结果

# 根据 submit_id 查询结果
dreamina query_result --submit_id=<你的_submit_id>

# 查询结果并直接下载到指定目录
dreamina query_result --submit_id=<你的_submit_id> --download_dir=./downloads

6. 查看历史任务

# 查看所有任务
dreamina list_task

# 仅查看成功的任务
dreamina list_task --gen_status=success

# 根据 submit_id 筛选特定任务
dreamina list_task --submit_id=<你的_submit_id>

---

四、常见问题（FAQ）

Q: 登录成功后，执行生成命令依然提示无权限或失败？

A: 请先进行两项检查：

1. 确认 ~/.dreamina_cli/config.toml 文件存在且内容正确
2. 执行 dreamina user_credit 命令检查是否能成功返回信息

Q: login 命令后浏览器登录流程卡住了？

A: 使用 dreamina login --debug 命令重试，它会在终端打印出详细的调试信息。

Q: 提交的异步任务迟迟没有最终结果？

A: 建议优先使用带 --poll 参数的命令提交任务，例如 --poll=30。如果等待超时，请记下返回的 submit_id，稍后手动调用 dreamina query_result --submit_id=<你的_submit_id> 来获取最终结果。

Q: 如何切换或重新登录另一个账号？

A: 执行 dreamina relogin 命令，它会清除现有登录态并发起新的登录流程。

Q: 如何完全清空本地的登录信息？

A: 执行 dreamina logout 命令。请注意，此命令仅清除 credential.json 文件中的登录凭证，不会删除 config.toml 配置文件和 tasks.db 任务记录。

---

五、本地文件说明

dreamina 会在你的用户主目录下创建并维护以下文件：

文件路径	说明
~/.dreamina_cli/config.toml	环境配置文件，决定了你的请求发往何处
~/.dreamina_cli/credential.json	本地登录凭证，记录了你的登录状态
~/.dreamina_cli/tasks.db	本地数据库，存储了你所有任务的提交记录
~/.dreamina_cli/logs/	存放工具运行日志的目录