trello

Trello 技能

直接從 OpenClaw 管理 Trello 看板、列表與卡片。

設定

1. 取得 API 金鑰：https://trello.com/app-key
2. 產生權杖（點擊該頁面上的「Token」連結）
3. 設定環境變數：

   export TRELLO_API_KEY="your-api-key"
   export TRELLO_TOKEN="your-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}'

列出列表中的卡片

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

建立卡片

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

移動卡片到其他列表

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

在卡片上新增留言

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

封存卡片

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

備註

• 看板/列表/卡片的 ID 可從 Trello 網址或透過列出指令取得
• API 金鑰與權杖可完整存取您的 Trello 帳號，請妥善保管！
• 速率限制：每 10 秒 300 次請求（每組 API 金鑰）；每 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}'