核心用法
Manus 是一个自主 AI 代理 skill,通过命令行脚本与 Manus API 交互。用户需先配置 MANUS_API_KEY 环境变量,然后使用 scripts/manus.sh 执行以下操作:
- 创建任务:
create "任务描述" [profile],支持三种配置(默认/快速/深度) - 状态查询:
status <task_id>获取 pending/running/completed/failed 状态 - 等待完成:
wait <task_id> [超时秒数]轮询直至任务结束 - 获取详情:
get <task_id>返回完整任务 JSON - 文件管理:
files列输出文件,download下载到本地 - 任务列表:
list查看历史任务
典型三步工作流:创建 → 等待 → 下载。
显著优点
1. 真正的自主执行:Manus 可独立浏览网页、调用工具,无需人工逐步干预
2. 完整交付物:输出结构化文件而非仅文本回复,适合报告、数据集等场景
3. 灵活配置:三档性能模式(lite/fast、default、max/thorough)平衡速度与深度
4. 透明可控:disable-model-invocation: true 设计确保必须由用户显式触发,防止代理自主滥用
5. 轻量集成:仅需 curl + jq,无复杂依赖
潜在缺点与局限性
- 高级功能未封装:文件上传、Webhook、多轮对话、交互模式等需直接调用 API
- 无本地文件上传:当前脚本不支持附件,限制了工作流完整性
- 同步轮询模式:
wait命令阻塞式轮询,长任务期间终端占用 - 网络依赖:完全依赖 Manus 云服务可用性和 CDN 下载稳定性
- 成本不透明:API 定价未在文档中说明,深度模式可能消耗较多 token
适合人群
- 研究人员:需要自动化信息收集与结构化报告生成
- 数据分析师:定期抓取网页数据并整理为可下载格式
- 内容创作者:批量生成研究素材、竞品分析文档
- 开发者:希望将 AI 代理能力集成到 CI/CD 或自动化脚本中
常规风险
1. API 密钥安全:密钥仅发往 api.manus.ai,但需确保环境变量不被日志泄露
2. 数据隐私:任务内容、浏览记录、输出文件均经过 Manus 服务器,敏感信息需谨慎
3. 输出可靠性:自主代理可能产生幻觉、过时信息或错误工具调用,需人工验证
4. 服务依赖:Manus 为商业服务,存在定价变更、速率限制或 discontinue 风险
5. 脚本审计:建议首次使用前审查 manus.sh 源码,确认无额外网络行为