首页
trello
steipete/clawdis
通过 Trello REST API 管理 Trello 看板、列表和卡片。
...展开全部关于trello
Trello 技能允许用户通过Trello REST API，直接在命令行上管理其Trello 工作区。该技能通过与环境变量集成进行身份验证，提供了一种简化的方式来操作看板、列表和卡片，而无需访问Trello 网页界面。 它解决了手动管理Trello 资源的问题，使用户能够自动化重复性任务、快速查询看板数据，并高效地保持工作组织有序。
该技能的主要功能包括列出用户的所有看板、枚举看板内的列表，以及从特定列表中检索卡片。用户还可以创建新卡片、在列表间移动卡片、添加评论以及归档卡片。 所有操作均利用简单的 curl 命令结合 jq 进行 JSON 解析，在 API 请求的执行方式上兼具灵活性和透明度。该技能配置要求极低，仅需Trello 的 API 密钥和令牌，并依赖 jq 来处理 JSON 响应。
该技能非常适合将Trello 作为核心任务管理工具的项目经理、开发人员和团队，他们希望实现工作流自动化，或将Trello 数据集成到脚本和其他系统中。 典型应用场景包括生成看板状态的快速报告、批量创建或更新卡片，以及自动化任务状态转换。对于熟悉命令行操作且希望优化Trello 管理任务（而不完全依赖网页界面）的用户而言，该技能尤为实用。
常见问题
如何设置Trello 技能？
您需要获取Trello 的API密钥和令牌，然后将其设置为环境变量TRELLO_API_KEY和TRELLO_TOKEN。此外，请确保已安装jq以进行JSON处理。
我可以使用此技能创建和移动卡片吗？
可以，该技能支持通过 curl 命令在列表中创建新卡片、将卡片移动到不同列表、添加评论以及归档卡片。
是否有需要注意的请求速率限制？
是的，Trello API 设有以下限制：每个 API 密钥每 10 秒 300 次请求，每个令牌每 10 秒 100 次请求，且 /1/members 端点的请求限制为每 900 秒 100 次。
使用此技能是否需要额外的软件？
是的，该技能需要 jq 来解析 API 返回的 JSON 响应。可通过 brew 或其他软件包管理器进行安装。
该技能面向哪些用户？
该技能面向希望通过命令行自动化管理看板、列表和卡片的Trello 用户，例如项目经理、开发人员和团队负责人。
Trello Skill
Manage Trello boards, lists, and cards directly from OpenClaw.
Setup
- Get your API key: https://trello.com/app-key
- Generate a token (click "Token" link on that page)
- 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" \ -d "idList={listId}" \ -d "name=Card Title" \ -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" \ -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" \ -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" \ -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/membersendpoints are limited to 100 requests per 900 seconds
Examples
# Get all boardscurl -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 namecurl -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 boardcurl -s "https://api.trello.com/1/boards/{boardId}/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, list: .idList}'
