manus

用途

本技能用于通过 Manus API 创建和管理自主 AI 智能体任务。Manus 是一个自主 AI 智能体，可以浏览网页、使用工具，并交付完整的工作成果，例如报告、代码、演示文稿等。

主要能力

创建自主 AI 任务，由 Manus 智能体执行。
支持多种智能体配置（Agent Profiles）：
- manus-1.6：标准（默认），适用于大多数任务。
- manus-1.6-lite：更快、更轻量，适用于快速/简单任务。
- manus-1.6-max：复杂、彻底，适用于深度研究/分析。
- 默认始终使用 manus-1.6，除非用户另有指定。
支持多种任务模式（Task Modes）：
- chat：对话模式。
- adaptive：自动选择最佳方式。
- agent：完全自主智能体模式（推荐用于文件创建）。
查询任务状态与输出，状态值包括：pending、running、completed、failed。
从任务响应中提取输出文件并下载到本地。
列出任务。

使用方式

API 基础信息

API Base：https://api.manus.ai/v1
认证方式：请求头 API_KEY: <your-key>
密钥设置方式：
- 环境变量 MANUS_API_KEY
- 或在 clawdbot 配置中设置 skills.manus.apiKey

创建任务

curl -X POST "https://api.manus.ai/v1/tasks" \
  -H "API_KEY: $MANUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Your task description here",
    "agentProfile": "manus-1.6",
    "taskMode": "agent",
    "createShareableLink": true
  }'

响应示例：

{
  "task_id": "abc123",
  "task_title": "Task Title",
  "task_url": "https://manus.im/app/abc123"
}

获取任务状态与输出

curl "https://api.manus.ai/v1/tasks/{task_id}" \
  -H "API_KEY: $MANUS_API_KEY"

重要：当状态为 completed 时，检查 output 数组中的文件：

查找 type: "output_file" 的条目。
直接从 fileUrl 下载文件。
保存到本地并作为附件发送给用户。

提取输出文件

任务响应中的输出示例如下：

{
  "output": [
    {
      "content": [
        {
          "type": "output_file",
          "fileUrl": "https://private-us-east-1.manuscdn.com/...",
          "fileName": "presentation.pdf"
        }
      ]
    }
  ]
}

使用 curl 下载这些文件并直接交付给用户，而不是依赖分享 URL。

列出任务

curl "https://api.manus.ai/v1/tasks" \
  -H "API_KEY: $MANUS_API_KEY"

适用场景

需要自主智能体完成网页浏览、工具调用并交付完整成果的任务。
生成报告、代码、演示文稿等文件类工作产品。
深度研究与分析（可使用 manus-1.6-max）。
快速或简单任务（可使用 manus-1.6-lite）。

限制与最佳实践

始终在告知用户任务完成前轮询确认完成状态。
将输出文件下载到本地，而不是提供 manus.im 链接（这些链接可能不可靠）。
对于创建文件/文档的任务，使用 agent 模式。
设定合理预期——复杂任务可能需要 2-10 分钟以上。

文档

API 参考：https://open.manus.ai/docs
主文档：https://manus.im/docs

技能介绍

用途

主要能力

使用方式

API 基础信息

推荐工作流

创建任务

获取任务状态与输出

提取输出文件

列出任务

适用场景

限制与最佳实践

文档