出海助手-Trello看板 / Trello Skill

> 本技能改造自开源技能 trello（来源：openclaw/openclaw，openclaw 开源技能生态）。已完整保留原始运行文件（scripts/references/assets 与 LICENSE），并新增中文出海使用说明。原始英文说明见文末「English (Original)」与同目录 SKILL.original.md。

功能说明 / Functional Overview

通过 Trello REST API（curl）直接管理看板（Board）、列表（List）与卡片（Card）：列出、创建、移动、评论、归档。

适用场景 / Use Cases

• 海外团队协作看板的自动化维护
• 把任务同步进 Trello、批量建卡 / 移动

使用方法 / How to Use

1. 申请 API Key（trello.com/app-key）并生成 Token，设置环境变量 TRELLO_API_KEY、TRELLO_TOKEN
2. 列看板：curl ".../1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq
3. 列卡片：curl ".../1/lists/{listId}/cards?..."
4. 建卡：curl -X POST ".../1/cards?..." -d "idList={listId}" -d "name=标题" -d "desc=描述"
5. 移动：curl -X PUT ".../1/cards/{cardId}?..." -d "idList={newListId}"；评论 / 归档同理

示例 / Examples

• 按名称找看板：jq '.[] | select(.name | contains("Work"))'

限制说明 / Limitations

• API Key 与 Token 拥有你 Trello 账户的完整权限，务必保密。
• 速率限制：每 Key 300 次 / 10 秒，每 Token 100 次 / 10 秒，/1/members 端点 100 次 / 900 秒。
• Board / List / Card 的 ID 可从 Trello URL 或列表命令中获取。

English (Original) / 英文原文（完整保留）

> The section below is the original skill definition, preserved verbatim for traceability and full functionality.

Trello Skill

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

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"

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/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}'