OpenClaw Skills Trello 项目管理技能使用参考手册

概述

Trello 是用于管理 Trello 看板、列表和卡片的 OpenClaw 技能，通过 Trello REST API 实现，适合需要在 AI 助手中集成 Trello 项目管理功能的场景，帮助用户通过自然语言驱动的方式管理 Trello 的项目内容。该技能可以让 AI 代理直接驱动 Trello 的自动化接口，将原本需要人工点击操作的 Trello 界面，变成可以通过指令控制的管理工具，适用于个人任务追踪、团队敏捷开发、内容日历管理等各类场景。

该技能由 steipete 开发，在 ClawHub 平台上累计使用量达 7.6k，遵循 agentskills 开放规范，通过标准化的技能定义文件，为 OpenClaw 提供与 Trello 项目管理平台的无缝集成能力。

技能信息

名称：trello
描述：通过 Trello REST API 管理 Trello 看板、列表和卡片，支持看板、列表和卡片的创建、查看、更新和删除操作。
版本：1.0.0
作者：steipete
主页：https://developer.atlassian.com/cloud/trello/rest/
依赖：
- 需要 jq 工具（用于 JSON 数据格式化处理）
- 需要设置环境变量TRELLO_API_KEY和TRELLO_TOKEN
触发词："Trello 看板管理"、"Trello 列表管理"、"Trello 卡片管理"、"Trello 项目管理"、"Trello 任务管理"

👤 作者：Peter Steinberger
🦞 官方地址：https://clawhub.ai/steipete/trello
👉 Skills 下载地址：trello-1.0.0.zip

配置设置

1. 获取 API 密钥

访问Trello 应用密钥页面获取你的 API 密钥。

2. 生成令牌

在上述页面点击 "Token" 链接，生成访问令牌。

3. 设置环境变量

将获取到的 API 密钥和令牌设置为环境变量：

export TRELLO_API_KEY="你的API密钥"
export TRELLO_TOKEN="你的访问令牌"

使用方法

所有命令都通过 curl 调用 Trello REST API 实现。

列出看板

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

列出看板中的列表

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

将{boardId}替换为实际的看板 ID。

列出列表中的卡片

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

将{listId}替换为实际的列表 ID。

创建卡片

curl -s -X POST "https://api.trello.com/1/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
-d "idList={listId}" \
-d "name=卡片标题" \
-d "desc=卡片描述"

将{listId}替换为实际的列表 ID。

移动卡片到另一个列表

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

将{cardId}替换为实际的卡片 ID，{newListId}替换为目标列表的 ID。

为卡片添加评论

curl -s -X POST "https://api.trello.com/1/cards/{cardId}/actions/comments?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
-d "text=你的评论内容"

将{cardId}替换为实际的卡片 ID。

归档卡片

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

将{cardId}替换为实际的卡片 ID。

注意事项

看板 / 列表 / 卡片 ID 可以在 Trello 的 URL 中找到，或者通过上述的列表命令获取。
API 密钥和令牌拥有你的 Trello 账户的完整访问权限，请妥善保管，不要泄露。
速率限制：每个 API 密钥每 10 秒最多 300 次请求；每个令牌每 10 秒最多 100 次请求；/1/members端点每 900 秒最多 100 次请求。

示例命令

## 获取所有看板
curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN&fields=name,id" | jq


## 通过名称查找特定看板
curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | select(.name | contains("工作"))'


## 获取看板中的所有卡片
curl -s "https://api.trello.com/1/boards/{boardId}/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, list: .idList}'

将{boardId}替换为实际的看板 ID。

元数据信息

该技能的元数据信息如下：

{
"ownerId": "kn70pywhg0fyz996kpa8xj89s57yhv26",
"slug": "trello",
"version": "1.0.0",
"publishedAt": 1767545389426
}