← 返回
未分类 中文

Trello Projects

Manage Trello boards, lists, cards, comments, labels, checklists, and project workflows via the Trello API. Use this skill when users want to create boards,...
通过 Trello API 管理看板、列表、卡片、评论、标签、清单和项目工作流。在用户想要创建看板时使用此技能,...
hith3sh hith3sh 来源
未分类 clawhub v1.0.6 3 版本 99873.7 Key: 无需
★ 5
Stars
📥 1,482
下载
💾 1
安装
3
版本
#latest

概述

Trello Projects

!Trello Projects

Manage Trello boards, lists, cards, comments, labels, checklists, members, and project workflows from chat via the Trello API.

This skill uses ClawLink for hosted connection flows and credentials so you do not need to configure Trello API access yourself.

Setup in 3 Steps

Step 1: InstallStep 2: Pair AccountStep 3: Connect Trello
:---::---::---:
!Install!PairApp-specific connection GIF coming soon
Run the install command in OpenClawSign in and approve the deviceOpen the dashboard and connect Trello

How It Works

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│   Trello API     │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘
         │                       │                       │
         │  1. Install Plugin    │                       │
         │  2. Pair Device       │                       │
         │  3. Connect Trello   │                       │
         │                       │  4. Secure Token      │
         │                       │  5. Proxy Requests    │
         │                       │                       │
         ▼                       ▼                       ▼
   ┌──────────┐           ┌──────────┐           ┌──────────┐
   │  SKILL   │           │ Dashboard│           │  Trello │
   │  File    │           │ Auth     │           │ Account │
   └──────────┘           └──────────┘           └──────────┘

Install

Install the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Then tell the user: "OpenClaw has been restarted. Send /new as a standalone message to start a fresh chat, then ask for Trello again."

Quick Start

# List boards
clawlink_call_tool --tool "trello_get_boards" --params '{}'

# Get a board with lists and cards
clawlink_call_tool --tool "trello_get_board" --params '{"board_id": "BOARD_ID"}'

# Create a card
clawlink_call_tool --tool "trello_add_card" --params '{"id_list": "LIST_ID", "name": "New task"}'

Authentication

All Trello tool calls are authenticated automatically by ClawLink using the user's connected Trello account OAuth token.

No API key is required in chat. ClawLink stores the OAuth token securely and injects it into every Trello API request on the user's behalf.

Getting Connected

  1. Install the ClawLink plugin (see Install above).
  2. Pair the plugin with clawlink_begin_pairing if it is not configured yet.
  3. Open https://claw-link.dev/dashboard?add=trello and connect Trello.
  4. Call clawlink_list_integrations to verify the connection is active.

Connection Management

List Connections

clawlink_list_integrations

Response: Returns all connected integrations. Look for trello in the list.

Verify Connection

clawlink_list_tools --integration trello

Response: Returns the live tool catalog for Trello.

Reconnect

If Trello tools are missing or the connection shows an error:

  1. Direct the user to https://claw-link.dev/dashboard?add=trello
  2. After they confirm, call clawlink_list_integrations to verify
  3. Then call clawlink_list_tools --integration trello

Security & Permissions

  • Access is scoped to the Trello account connected during OAuth setup and the workspaces/boards accessible to that account.
  • All write operations require explicit user confirmation. Board deletion, card deletion, and list archiving are high-impact.
  • Confirm before bulk operations, member removals, or board deletions.
  • Board visibility and workspace permissions affect what operations are available.

Tool Reference

Boards

ToolDescriptionMode
-------------------------
trello_get_boardsList all boards the member is associated withRead
trello_get_boardGet board details including lists, cards, and membersRead
trello_add_boardCreate a new boardWrite
trello_update_boardUpdate board name, description, or preferencesWrite
trello_delete_boardPermanently delete a board and all its contentsWrite
trello_close_boardArchive a boardWrite
trello_get_board_actionsGet recent actions on a boardRead
trello_get_board_labelsList labels on a boardRead
trello_create_board_labelCreate a new label on a boardWrite
trello_update_board_labelUpdate a label's name or colorWrite
trello_delete_board_labelDelete a label from a boardWrite

Lists

ToolDescriptionMode
-------------------------
trello_get_listsList all lists on a boardRead
trello_add_listCreate a new list on a boardWrite
trello_update_listUpdate a list's name or positionWrite
trello_archive_listArchive a list and all its cardsWrite
trello_move_listMove a list to a different positionWrite
trello_archive_all_list_cardsArchive all cards in a listWrite

Cards

ToolDescriptionMode
-------------------------
trello_get_cardsList all cards on a boardRead
trello_get_cardGet card details including description, members, and checklistsRead
trello_add_cardCreate a new card in a listWrite
trello_update_cardUpdate a card's name, description, or positionWrite
trello_move_cardMove a card to a different list or positionWrite
trello_delete_cardPermanently delete an archived cardWrite
trello_archive_cardArchive a cardWrite
trello_close_cardArchive and close a cardWrite

Card Members & Labels

ToolDescriptionMode
-------------------------
trello_add_member_to_cardAssign a member to a cardWrite
trello_remove_member_from_cardRemove a member from a cardWrite
trello_add_label_to_cardAdd a label to a cardWrite
trello_remove_label_from_cardRemove a label from a cardWrite
trello_create_card_labelCreate and add a new label to a cardWrite

Comments & Activity

ToolDescriptionMode
-------------------------
trello_get_card_commentsList all comments on a cardRead
trello_add_commentAdd a text comment with optional @mentionsWrite
trello_delete_commentDelete a specific comment from a cardWrite
trello_get_card_actionsGet all actions on a cardRead
trello_add_reaction_to_actionAdd an emoji reaction to an actionWrite
trello_delete_reaction_from_actionRemove a reaction from an actionWrite

Checklists

ToolDescriptionMode
-------------------------
trello_get_card_checklistsList all checklists on a cardRead
trello_add_checklistAdd a checklist to a cardWrite
trello_add_checklist_itemAdd an item to an existing checklistWrite
trello_toggle_checklist_itemToggle a checklist item's completion stateWrite
trello_delete_checklistDelete a checklist from a cardWrite
trello_delete_checklist_itemRemove an item from a checklistWrite
trello_convert_checklist_item_to_cardConvert a checklist item to a new cardWrite

Attachments

ToolDescriptionMode
-------------------------
trello_get_card_attachmentsList all attachments on a cardRead
trello_add_attachmentAdd a file attachment or URL to a cardWrite
trello_delete_attachmentRemove an attachment from a cardWrite

Members

ToolDescriptionMode
-------------------------
trello_get_board_membersList members on a boardRead
trello_add_member_to_boardInvite a member to a boardWrite
trello_remove_member_from_boardRemove a member from a boardWrite
trello_get_memberGet a member's profileRead

Organizations (Workspaces)

ToolDescriptionMode
-------------------------
trello_get_organizationsList organizations the member belongs toRead
trello_get_organizationGet an organization's detailsRead
trello_create_organizationCreate a new organization/workspaceWrite
trello_update_organizationUpdate an organization's settingsWrite
trello_delete_organizationDelete an organizationWrite

Power-Ups

ToolDescriptionMode
-------------------------
trello_get_board_power_upsList enabled Power-Ups on a boardRead
trello_enable_board_power_upEnable a Power-Up on a boardWrite
trello_disable_board_power_upDisable a Power-Up on a boardWrite

Webhooks

ToolDescriptionMode
-------------------------
trello_create_webhookCreate a webhook for board/card changesWrite
trello_list_webhooksList all webhooks for the accountRead
trello_delete_webhookDelete a webhookWrite

Code Examples

Get a board with all lists and cards

clawlink_call_tool --tool "trello_get_board" \
  --params '{
    "board_id": "BOARD_ID"
  }'

Create a new card

clawlink_call_tool --tool "trello_add_card" \
  --params '{
    "id_list": "LIST_ID",
    "name": "Review Q2 budget proposal",
    "desc": "Please review and approve by Friday.",
    "pos": "bottom"
  }'

Add a checklist to a card

clawlink_call_tool --tool "trello_add_checklist" \
  --params '{
    "id_card": "CARD_ID",
    "name": "Definition of Done"
  }'

Add a comment with @mention

clawlink_call_tool --tool "trello_add_comment" \
  --params '{
    "id_card": "CARD_ID",
    "text": "@JaneDoe please review the updated design by EOD."
  }'

Move a card to a different list

clawlink_call_tool --tool "trello_move_card" \
  --params '{
    "card_id": "CARD_ID",
    "id_list": "TARGET_LIST_ID",
    "pos": "top"
  }'

Create a new board

clawlink_call_tool --tool "trello_add_board" \
  --params '{
    "name": "Project Alpha",
    "desc": "Tracking deliverables for the alpha release",
    "id_org": "ORGANIZATION_ID",
    "visibility": "org"
  }'

Discovery Workflow

  1. Call clawlink_list_integrations to confirm Trello is connected.
  2. Call clawlink_list_tools --integration trello to see the live catalog.
  3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.
  4. If the user describes a capability but the exact tool is unclear, call clawlink_search_tools with a short query and integration trello.
  5. If no Trello tools appear, direct the user to https://claw-link.dev/dashboard?add=trello.

Execution Workflow

┌─────────────────────────────────────────────────────────────┐
│  READ OPERATIONS (Safe)                                     │
│  list → get → describe → search                             │
│                                                             │
│  Example: List boards → Get board → Get card → Show details│
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  WRITE OPERATIONS (Require Confirmation)                    │
│  describe → preview → confirm → call                        │
│                                                             │
│  Example: Preview card creation → User approves → Create   │
└─────────────────────────────────────────────────────────────┘
  1. For unfamiliar tools, ambiguous requests, or any write action, call clawlink_describe_tool first.
  2. Use the returned guidance, schema, whenToUse, askBefore, safeDefaults, examples, and followups to shape the call.
  3. Prefer read, list, get, and search operations before writes when that reduces ambiguity.
  4. For writes or anything marked as requiring confirmation, call clawlink_preview_tool first.
  5. Execute with clawlink_call_tool. Pass confirmation only after the preview matches the user's intent.
  6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.

Notes

  • Board, list, and card IDs are required for most operations — resolve them from board/card lookups first.
  • Card moves between boards require both card_id and id_board parameters.
  • Checklist items converted to cards cannot be customized during conversion — the card inherits basic properties.
  • Archived cards and boards can be restored via the Trello web UI but not via the API.
  • Webhooks require a publicly accessible callback URL — they will not work with localhost.
  • Label operations on cards require knowing the label ID, which comes from trello_get_board_labels.
  • Organization (workspace) membership determines which boards are accessible.

Error Handling

Status / ErrorMeaning
-------------------------
Tool not foundThe tool name does not exist in the current catalog. Verify with clawlink_list_tools --integration trello.
Missing connectionTrello is not connected. Direct the user to https://claw-link.dev/dashboard?add=trello.
board_not_foundThe board ID does not exist or is not accessible.
list_not_foundThe list ID does not exist on the target board.
card_not_foundThe card ID does not exist or was archived.
member_not_foundThe member ID or username does not match any board member.
invalid_tokenThe OAuth token is invalid or expired. Reconnect Trello.
webhook_not_foundThe webhook ID does not exist.
model_not_foundThe target resource (card, board, etc.) was not found.
Write rejectedUser did not confirm a write action. Always confirm before executing writes.

Troubleshooting: Tools Not Visible

  1. Check that the ClawLink plugin is installed:

```bash

openclaw plugins list

```

  1. If the plugin is installed but tools are missing, tell the user to send /new as a standalone message to reload the catalog.
  2. If a fresh chat does not help, run:

```bash

openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json

openclaw gateway restart

```

  1. After restart, tell the user to send /new again and retry.

Troubleshooting: Card Operations Fail

  1. Verify the list ID exists on the target board — use trello_get_lists to confirm.
  2. Check that the card is not already archived — archived cards cannot be moved, only deleted.
  3. Confirm the board's permission settings allow the operation.

Resources


Powered by ClawLink — an integration hub for OpenClaw

!ClawLink Logo

版本历史

共 3 个版本

  • v1.0.6 当前
    2026-06-09 16:15 安全 安全
  • v0.1.1
    2026-05-21 13:55 安全 安全
  • v0.1.0
    2026-05-08 04:17 安全 安全

安全检测

腾讯云安全 (Keen)

安全,无风险
查看报告

腾讯云安全 (Sanbu)

安全,无风险
查看报告

🔗 相关推荐

business-ops

Trello

steipete
使用 Trello REST API 管理看板、列表和卡片
★ 162 📥 41,296
dev-programming

GitHub

hith3sh
通过 GitHub REST 和GraphQL API 与仓库、议题、拉取请求、提交、分支、发布和工作流进行交互。在需要时使用此技能。
★ 6 📥 1,950
business-ops

Discord

steipete
当需要通过discord工具控制Discord时使用:发送消息、添加反应、发布或上传表情包、上传表情、创建投票、管理帖子/置顶/搜索、获取权限或成员/角色/频道信息,或在Discord私信或频道中处理管理操作。
★ 78 📥 38,058