Back to Details

trello

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Trello Skill

Trello 操作技能

Manage Trello boards, lists, and cards directly from OpenClaw.
直接通过OpenClaw管理Trello看板、列表和卡片。

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:
    bash
    export TRELLO_API_KEY="your-api-key"
export TRELLO_TOKEN="your-token"
  1. 获取你的API密钥：https://trello.com/app-key
  2. 生成令牌（点击该页面上的"Token"链接）
  3. 设置环境变量：
    bash
    export TRELLO_API_KEY="your-api-key"
export TRELLO_TOKEN="your-token"

Usage

使用方法

All commands use curl to hit the Trello REST API.
所有命令均使用curl调用Trello REST API。

List boards

列出所有看板

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

列出看板中的所有列表

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

列出列表中的所有卡片

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

Create a card

创建卡片

bash
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"
bash
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

将卡片移动到另一个列表

bash
curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
  -d "idList={newListId}"
bash
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

给卡片添加评论

bash
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"
bash
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

归档卡片

bash
curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
  -d "closed=true"
bash
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/members
    endpoints are limited to 100 requests per 900 seconds
  • 看板/列表/卡片ID可以在Trello的URL中找到，也可以通过列表查询命令获取
  • API密钥和令牌拥有你的Trello账户的完全访问权限，请妥善保密！
  • 请求限制：每个API密钥每10秒最多300次请求；每个令牌每10秒最多100次请求；
    /1/members
    端点每900秒最多100次请求

Examples

示例

bash
undefined
bash
undefined

Get all boards

获取所有看板

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&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"))'
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}'
undefined
curl -s "https://api.trello.com/1/boards/{boardId}/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, list: .idList}'
undefined