Trello：使用 AI 代理管理看板和卡片 - Openclaw Skills

下载入口:https://github.com/openclaw/skills/tree/main/skills/steipete/trello

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install trello

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 trello。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

什么是 Trello？

Trello 技能是为 AI 代理直接与 Trello 生态系统交互而设计的专门集成。通过利用 Openclaw Skills，开发人员和项目经理无需离开终端或代理环境即可自动执行任务生命周期。它提供了通往 Trello REST API 的强大桥梁，实现了对项目看板、组织列表和单个任务卡片的编程控制。

该技能对于希望将项目管理集成到自动化工作流中的团队特别有用。它利用标准化的 curl 命令和 jq 进行数据解析，确保您的 AI 代理能够精准、快速地读取和写入 Trello。无论您是在同步开发任务还是管理营销管道，此技能都能简化代理与 Trello 之间的交互。

Trello 应用场景

• 根据系统警报、收到的电子邮件或客户反馈自动创建新的 Trello 卡片。
• 在 Trello 与外部开发工具或版本控制系统之间同步任务状态。
• 通过跨多个看板获取卡片数据，生成项目进度的自动化摘要报告。
• 使用 Openclaw Skills 以编程方式在工作流阶段之间移动卡片，模拟人工看板更新。
• 归档已完成的任务，并为现有项目卡片添加上下文注释，以便更好地进行审计追踪。

Trello 工作原理

1. 通过向代理提供 Trello API 密钥和生成的个人令牌来建立身份验证。
2. 代理利用 curl 向特定的 Trello REST API 端点 (v1) 发送经过身份验证的请求。
3. 使用 jq 对来自 API 的响应数据进行过滤和格式化，以提取特定标识符（如 boardId、listId 或 cardId）。
4. 根据所需任务，该技能执行 POST、PUT 或 GET 请求来修改或检索组织数据。
5. 当代理处理 JSON 响应或确认 Trello 操作的成功状态时，生命周期完成。

Trello 配置指南

要在 Openclaw Skills 框架内开始使用此技能，您必须配置您的凭据和环境：

1. 从 Trello App Key 页面 获取您的 API 密钥。
2. 点击开发者页面上的“Token”链接生成安全的访问令牌。
3. 确保本地系统上安装了 jq 实用程序以便进行 JSON 处理。
4. 在终端中设置以下环境变量：

export TRELLO_API_KEY="your-api-key"
export TRELLO_TOKEN="your-token"

Trello 数据架构与分类体系

Trello 技能根据标准的 Trello 层级结构组织和处理数据。Openclaw Skills 使用以下元数据分类法进行清晰的沟通：

实体	关键属性	用途
看板 (Board)	id, name	代表顶层项目容器。
列表 (List)	id, name, idBoard	代表看板内的特定阶段或类别。
卡片 (Card)	id, name, desc, idList	工作或任务项的基本单元。
注释 (Comment)	id, text, idMember	附加到卡片的可操作笔记和审计日志。

所有 API 响应都将被解析为干净的 JSON 对象，以确保 AI 代理能够准确解释看板的状态。

name: trello
description: Manage Trello boards, lists, and cards via the Trello REST API.
homepage: https://developer.atlassian.com/cloud/trello/rest/
metadata: {"clawdbot":{"emoji":"??","requires":{"bins":["jq"],"env":["TRELLO_API_KEY","TRELLO_TOKEN"]}}}

Trello Skill

Manage Trello boards, lists, and cards directly from Clawdbot.

Setup

1. Get your API key: https://trello.com/app-key
2. Generate a token (click "Token" link on that page)
3. Set environment variables:

   export TRELLO_API_KEY="your-api-key"
   export TRELLO_TOKEN="your-token"
   

Usage

All commands use curl to hit the Trello REST API.

List boards

curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id}'

List lists in a board

curl -s "https://api.trello.com/1/boards/{boardId}/lists?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id}'

List cards in a list

curl -s "https://api.trello.com/1/lists/{listId}/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id, desc}'

Create a card

curl -s -X POST "https://api.trello.com/1/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \r
  -d "idList={listId}" \r
  -d "name=Card Title" \r
  -d "desc=Card description"

Move a card to another list

curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \r
  -d "idList={newListId}"

Add a comment to a card

curl -s -X POST "https://api.trello.com/1/cards/{cardId}/actions/comments?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \r
  -d "text=Your comment here"

Archive a card

curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \r
  -d "closed=true"

Notes

• Board/List/Card IDs can be found in the Trello URL or via the list commands
• The API key and token provide full access to your Trello account - keep them secret!
• Rate limits: 300 requests per 10 seconds per API key; 100 requests per 10 seconds per token; /1/members endpoints are limited to 100 requests per 900 seconds

Examples

# Get all boards
curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN&fields=name,id" | jq

# Find a specific board by name
curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | select(.name | contains("Work"))'

# Get all cards on a board
curl -s "https://api.trello.com/1/boards/{boardId}/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, list: .idList}'