MooTeam

English (ClawHub)

MooTeam 是一个面向项目 / 任务 / CRM 的 API 集成。代理应通过 exec CLI 命令，使用 python3 并指定以下路径来运行。

安装（社区版）

1. 执行 clawhub install mooteam（或发布后您选定的 slug），将其安装至 /skills/ 目录下。
2. 安装一次 Python 依赖（推荐在 workspace 虚拟环境中执行）：
   python3 -m pip install -r skills/mooteam/requirements.txt
3. 设置环境变量（可在网关 .env 文件、宿主环境变量中配置，或在 openclaw.json 中的 skills.entries.mooteam.env 下配置）：
   • MOOTEAM_API_TOKEN — Bearer token
   • MOOTEAM_COMPANY_ALIAS — X-MT-Company 请求头的值

如何调用脚本

• 以工作区根目录为当前工作目录（OpenClaw 的典型用法）：
  python3 skills/mooteam/scripts/main.py [args]
• 或以技能目录为当前工作目录（skills/mooteam）：
  python3 scripts/main.py [args]

可选：将工作区的 .venv 添加到 tools.exec.pathPrepend 中，使 python3 能正确加载该环境中安装的依赖。

概述（RU）

MooTeam API v1 集成接口：支持项目、任务（含草稿）、时间追踪、标签、工作流及活动日志。

核心功能

• 项目与团队：项目管理、项目成员构成。
• 任务与草稿：任务创建与管理、评论、草稿转正式任务。
• 计时器与工时记录：仅允许一个活跃计时器；支持手动添加 time logs。
• 参考数据：工作流、状态、标签组与标签。
• Activity logs：支持按项目、用户、事件类型进行过滤。

代理行为规范

1. API ID 使用规则：禁止猜测 ID；如有不确定，应先调用 projects、statuses 或 user-profiles 获取准确 ID。
2. 草稿处理：执行复杂 task-create 前，应先检查 task-draft；确认内容无误后，再执行 task-from-draft。
3. 计时器操作：执行 start 前，必须先调用 timer-current；若已有其他任务上的活跃计时器，则需先执行 stop。
4. 任务上下文：尽可能一并拉取相关评论与 time logs。
5. 列表返回格式：向用户返回列表时，应精简展示（仅含 id、title、status）。

技能结构

• scripts/MooTeamClient.py — 基于 requests 的 HTTP 客户端。
• scripts/main.py — 供代理调用的 CLI 入口脚本。
• references/api_docs.md — 各 API 方法的简明参考文档。

环境变量

• MOOTEAM_API_TOKEN
• MOOTEAM_COMPANY_ALIAS

CLI 命令

Team

获取用户资料列表：python3 scripts/main.py user-profiles

Projects

• 列出所有项目：python3 scripts/main.py projects
• 创建项目：python3 scripts/main.py project-create --name "名称" --workflow_id
• 查看项目详情：python3 scripts/main.py project-info --id
• 更新项目：python3 scripts/main.py project-update --id --name "名称"
• 删除项目：python3 scripts/main.py project-delete --id --force
• 向项目添加成员：python3 scripts/main.py project-team-add --project --user
• 从项目移除成员：python3 scripts/main.py project-team-remove --map_id

Tasks

• 列出某项目下的所有任务：python3 scripts/main.py tasks --project
• 创建任务：python3 scripts/main.py task-create --project --header "标题" --user_id
• 查看任务详情：python3 scripts/main.py task-info --id
• 更新任务：python3 scripts/main.py task-update --id --header "..."（可选参数：--status_id）
• 删除任务：python3 scripts/main.py task-delete --id

Drafts

• 获取当前草稿：python3 scripts/main.py task-draft
• 更新草稿：python3 scripts/main.py task-draft-update --header "..." --project
• 将草稿转为正式任务：python3 scripts/main.py task-from-draft

Comments

• 列出某任务下的所有评论：python3 scripts/main.py comments --task_id
• 创建评论：python3 scripts/main.py comment-create --task_id --text "..."
• 删除评论：python3 scripts/main.py comment-delete --id

Workflows & statuses

• 工作流：python3 scripts/main.py workflows / workflow-create / workflow-info / workflow-update / workflow-delete
• 状态：python3 scripts/main.py statuses 及 status-create|status-info|status-update|status-delete

Labels

• 标签组：label-groups、label-group-create|update|delete
• 标签：labels、label-create|label-info|label-update|label-delete

Timer & time logs

• timer-current、start 、stop
• time-create|time-update|time-delete、task-time --task_id 、time-list

Activity

• activity（支持选项：--project、--user、--type）
• activity-projects

用户请求示例

• “列出所有项目，并在项目 X 中添加任务……”
• “任务 #… 已耗时多久？”
• “查询项目 … 的活动日志”
• “为任务 … 启动计时器”