Asana：通过 AI 智能体管理任务和项目 - Openclaw Skills

佚名 2026-07-31 09:30:01

什么是 Asana API 集成？

Asana 技能为 AI 智能体与 Asana 平台交互提供了一个强大的接口，无需手动管理 OAuth 令牌的开销。通过利用 Openclaw Skills，开发人员可以使用安全的代理网关，该网关会自动将授权令牌注入请求中。这允许以编程方式访问任务、项目和用户数据，从而更轻松地围绕团队工作流和项目跟踪构建智能自动化。

此集成专为需要弥合 AI 驱动逻辑与项目管理工具之间鸿沟的开发人员而设计。无论您是检索任务列表、更新项目状态还是管理组织工作区，此技能都通过提供统一的网关 URL 和通过 Maton API 进行的标准化身份验证来简化流程。

下载入口:https://github.com/openclaw/skills/tree/main/skills/byungkyu/asana-api

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install asana-api

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 <project>/skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 asana-api。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

Asana API 集成应用场景

根据对话记录或会议记录自动创建和分配任务。
构建 AI 驱动的项目状态仪表板，汇总多个 Asana 工作区的数据。
将外部开发工单与 Asana 任务同步，使非技术利益相关者保持更新。
配置自动 Webhook 器，以便在任务完成时触发通知或后续操作。

Asana API 集成工作原理

用户使用 MATON_API_KEY 环境变量向网关进行身份验证。
通过控制平面建立连接，以通过 OAuth 授权特定的 Asana 帐户。
API 请求被发送到网关端点，该端点镜像了原生的 Asana API 路径结构。
网关检索适当的 OAuth 令牌，将其注入请求头，并将调用转发给 Asana。
响应以干净的 JSON 格式返回给智能体，以便进行处理或进一步操作。

Asana API 集成配置指南

首先，从 Maton 设置页面获取您的 API 密钥。然后，设置您的环境变量：

export MATON_API_KEY="YOUR_API_KEY"

创建一个新连接以授权您的 Asana 帐户：

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'asana'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

在浏览器中打开 JSON 响应中提供的 URL 以完成 OAuth 流程。

Asana API 集成数据架构与分类体系

该技能根据 Asana 资源层次结构组织数据。所有资源 ID (GID) 均作为字符串返回。

资源	描述	常用字段
工作区	最高组织级别	gid, name, is_organization
项目	任务组	gid, name, owner, due_date
任务	个人工作单位	gid, name, assignee, completed, due_on
Webhook	事件订阅	gid, resource, target, active
用户	工作区成员	gid, name, email

name: asana
description: |
  Asana API integration with managed OAuth. Access tasks, projects, workspaces, users, and manage webhooks. Use this skill when users want to manage work items, track projects, or integrate with Asana workflows. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
compatibility: Requires network access and valid Maton API key
metadata:
  author: maton
  version: "1.0"
  clawdbot:
    emoji: ??
    requires:
      env:
        - MATON_API_KEY

Asana

Access the Asana API with managed OAuth authentication. Manage tasks, projects, workspaces, users, and webhooks for work management.

Quick Start

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/asana/api/1.0/tasks?project=PROJECT_GID')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Base URL

https://gateway.maton.ai/asana/{native-api-path}

Replace {native-api-path} with the actual Asana API endpoint path. The gateway proxies requests to app.asana.com and automatically injects your OAuth token.

Authentication

All requests require the Maton API key in the Authorization header:

Authorization: Bearer $MATON_API_KEY

Environment Variable: Set your API key as MATON_API_KEY:

export MATON_API_KEY="YOUR_API_KEY"

Getting Your API Key

Sign in or create an account at maton.ai
Go to maton.ai/settings
Copy your API key

Connection Management

Manage your Asana OAuth connections at https://ctrl.maton.ai.

List Connections

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=asana&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Create Connection

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'asana'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Get Connection

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response:

{
  "connection": {
    "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80",
    "status": "ACTIVE",
    "creation_time": "2025-12-08T07:20:53.488460Z",
    "last_updated_time": "2026-01-31T20:03:32.593153Z",
    "url": "https://connect.maton.ai/?session_token=...",
    "app": "asana",
    "metadata": {}
  }
}

Open the returned url in a browser to complete OAuth authorization.

Delete Connection

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Specifying Connection

If you have multiple Asana connections, specify which one to use with the Maton-Connection header:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/asana/api/1.0/tasks?project=PROJECT_GID')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

If omitted, the gateway uses the default (oldest) active connection.

API Reference

Tasks

Get Multiple Tasks

GET /asana/api/1.0/tasks

Query parameters:

project - Project GID to filter tasks
assignee - User GID or "me" for assigned tasks
workspace - Workspace GID (required if no project specified)
completed_since - ISO 8601 date to filter tasks completed after this date
opt_fields - Comma-separated list of fields to include

Example:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/asana/api/1.0/tasks?project=1234567890&opt_fields=name,completed,due_on')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response:

{
  "data": [
    {
      "gid": "1234567890",
      "name": "Review quarterly report",
      "completed": false,
      "due_on": "2025-03-15"
    }
  ]
}

Get a Task

GET /asana/api/1.0/tasks/{task_gid}

Example:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/asana/api/1.0/tasks/1234567890')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Create a Task

POST /asana/api/1.0/tasks
Content-Type: application/json

{
  "data": {
    "name": "New task",
    "projects": ["PROJECT_GID"],
    "assignee": "USER_GID",
    "due_on": "2025-03-20",
    "notes": "Task description here"
  }
}

Example:

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'data': {'name': 'Complete API integration', 'projects': ['1234567890'], 'due_on': '2025-03-20'}}).encode()
req = urllib.request.Request('https://gateway.maton.ai/asana/api/1.0/tasks', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Update a Task

PUT /asana/api/1.0/tasks/{task_gid}

Example:

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'data': {'completed': True}}).encode()
req = urllib.request.Request('https://gateway.maton.ai/asana/api/1.0/tasks/1234567890', data=data, method='PUT')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Delete a Task

DELETE /asana/api/1.0/tasks/{task_gid}

Get Tasks from a Project

GET /asana/api/1.0/projects/{project_gid}/tasks

Get Subtasks

GET /asana/api/1.0/tasks/{task_gid}/subtasks

Create Subtask

POST /asana/api/1.0/tasks/{task_gid}/subtasks
Content-Type: application/json

{
  "data": {
    "name": "Subtask name",
    "assignee": "USER_GID",
    "due_on": "2025-03-20"
  }
}

Search Tasks (Premium)

Note: This endpoint requires an Asana Premium subscription.

GET /asana/api/1.0/workspaces/{workspace_gid}/tasks/search

Query parameters:

text - Text to search for
assignee.any - Filter by assignees
projects.any - Filter by projects
completed - Filter by completion status

Projects

Get Multiple Projects

GET /asana/api/1.0/projects

Query parameters:

workspace - Workspace GID
team - Team GID
opt_fields - Comma-separated list of fields

Example:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/asana/api/1.0/projects?workspace=1234567890&opt_fields=name,owner,due_date')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response:

{
  "data": [
    {
      "gid": "1234567890",
      "name": "Q1 Marketing Campaign",
      "owner": {
        "gid": "0987654321",
        "name": "Alice Johnson"
      },
      "due_date": "2025-03-31"
    }
  ]
}

Get a Project

GET /asana/api/1.0/projects/{project_gid}

Create a Project

POST /asana/api/1.0/projects

Example:

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'data': {'name': 'New Project', 'workspace': '1234567890', 'notes': 'Project description'}}).encode()
req = urllib.request.Request('https://gateway.maton.ai/asana/api/1.0/projects', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Update a Project

PUT /asana/api/1.0/projects/{project_gid}

Delete a Project

DELETE /asana/api/1.0/projects/{project_gid}

Workspaces

Get Multiple Workspaces

GET /asana/api/1.0/workspaces

Example:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/asana/api/1.0/workspaces')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response:

{
  "data": [
    {
      "gid": "1234567890",
      "name": "Acme Corp",
      "is_organization": true
    }
  ]
}

Get a Workspace

GET /asana/api/1.0/workspaces/{workspace_gid}

Update a Workspace

PUT /asana/api/1.0/workspaces/{workspace_gid}

Add User to Workspace

POST /asana/api/1.0/workspaces/{workspace_gid}/addUser

Remove User from Workspace

POST /asana/api/1.0/workspaces/{workspace_gid}/removeUser

Users

Get Multiple Users

GET /asana/api/1.0/users

Query parameters:

workspace - Workspace GID to filter users

Example:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/asana/api/1.0/users?workspace=1234567890&opt_fields=name,email')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response:

{
  "data": [
    {
      "gid": "1234567890",
      "name": "Alice Johnson",
      "email": "[email protected]"
    }
  ]
}

Get Current User

GET /asana/api/1.0/users/me

Get a User

GET /asana/api/1.0/users/{user_gid}

Get Users in a Team

GET /asana/api/1.0/teams/{team_gid}/users

Get Users in a Workspace

GET /asana/api/1.0/workspaces/{workspace_gid}/users

Webhooks

Get Multiple Webhooks

GET /asana/api/1.0/webhooks

Query parameters:

workspace - Workspace GID (required)
resource - Resource GID to filter by

Example:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/asana/api/1.0/webhooks?workspace=1234567890')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Create Webhook

Note: Asana verifies the target URL is reachable and responds with a 200 status during webhook creation.

POST /asana/api/1.0/webhooks
Content-Type: application/json

{
  "data": {
    "resource": "PROJECT_OR_TASK_GID",
    "target": "https://example.com/webhook",
    "filters": [
      {
        "resource_type": "task",
        "action": "changed",
        "fields": ["completed", "due_on"]
      }
    ]
  }
}

Example:

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'data': {'resource': '1234567890', 'target': 'https://example.com/webhook'}}).encode()
req = urllib.request.Request('https://gateway.maton.ai/asana/api/1.0/webhooks', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response:

{
  "data": {
    "gid": "1234567890",
    "resource": {
      "gid": "1234567890",
      "name": "Q1 Project"
    },
    "target": "https://example.com/webhook",
    "active": true
  }
}

Get a Webhook

GET /asana/api/1.0/webhooks/{webhook_gid}

Update a Webhook

PUT /asana/api/1.0/webhooks/{webhook_gid}

Delete a Webhook

DELETE /asana/api/1.0/webhooks/{webhook_gid}

Returns 200 OK with empty data on success.

Pagination

Asana uses cursor-based pagination. Use offset for pagination:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/asana/api/1.0/tasks?project=1234567890&limit=50&offset=OFFSET_TOKEN')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response includes next_page when more results exist:

{
  "data": [...],
  "next_page": {
    "offset": "eyJ0eXBlIjoib2Zmc2V0IiwidmFsdWUiOjUwfQ",
    "path": "/tasks?project=1234567890&limit=50&offset=eyJ0eXBlIjoib2Zmc2V0IiwidmFsdWUiOjUwfQ",
    "uri": "https://app.asana.com/api/1.0/tasks?project=1234567890&limit=50&offset=eyJ0eXBlIjoib2Zmc2V0IiwidmFsdWUiOjUwfQ"
  }
}

Code Examples

JavaScript

const response = await fetch(
  'https://gateway.maton.ai/asana/api/1.0/tasks?project=1234567890',
  {
    headers: {
      'Authorization': `Bearer ${process.env.MATON_API_KEY}`
    }
  }
);
const data = await response.json();

Python

import os
import requests

response = requests.get(
    'https://gateway.maton.ai/asana/api/1.0/tasks',
    headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'},
    params={'project': '1234567890'}
)
data = response.json()

Notes

Resource IDs (GIDs) are strings
Timestamps are in ISO 8601 format
Use opt_fields to specify which fields to return
Workspaces are the highest-level organizational unit
Organizations are specialized workspaces representing companies
IMPORTANT: When using curl commands, use curl -g when URLs contain brackets (fields[], sort[], records[]) to disable glob parsing
IMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments. You may get "Invalid API key" errors when piping.

Error Handling

Status	Meaning
400	Bad request or missing Asana connection
401	Invalid or missing Maton API key
403	Forbidden - insufficient permissions
404	Resource not found
429	Rate limited
4xx/5xx	Passthrough error from Asana API

Troubleshooting: API Key Issues

Check that the MATON_API_KEY environment variable is set:

echo $MATON_API_KEY

Verify the API key is valid by listing connections:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Troubleshooting: Invalid App Name

Ensure your URL path starts with asana. For example:

Correct: https://gateway.maton.ai/asana/api/1.0/tasks
Incorrect: https://gateway.maton.ai/api/1.0/tasks

专题三国战纪-风云再起整合版
专题三国战纪-乱世枭雄

热门阅读

推荐下载

下载

|
下载
《行尸走肉第一章》免安装中文汉化硬盘版下载

单机|436 MB

一款以动作冒险为主题的游戏
下载
《街头霸王X铁拳》免安装中文汉化硬盘版下载

单机|111MB

一款非常好玩的格斗游戏
下载

|
下载
《暗黑破坏神3》免安装繁体中文正式版下载

单机|7630 MB

一款以角色扮演为主题的游戏
下载
《马克思佩恩3》免安装硬盘版下载

单机|27033 MB

一款以第三人称射击为主题的游戏

详情

导航

详情

Asana：通过 AI 智能体管理任务和项目 - Openclaw Skills

什么是 Asana API 集成？

安装与下载

1. ClawHub CLI

2. 手动安装

3. 提示词安装

Asana API 集成 应用场景

Asana API 集成 配置指南

Asana API 集成 数据架构与分类体系

Asana

Quick Start

Base URL

Authentication

Getting Your API Key

Connection Management

List Connections

Create Connection

Get Connection

Delete Connection

Specifying Connection

API Reference

Tasks

Get Multiple Tasks

Get a Task

Create a Task

Update a Task

Delete a Task

Get Tasks from a Project

Get Subtasks

Create Subtask

Search Tasks (Premium)

Projects

Get Multiple Projects

Get a Project

Create a Project

Update a Project

Delete a Project

Workspaces

Get Multiple Workspaces

Get a Workspace

Update a Workspace

Add User to Workspace

Remove User from Workspace

Users

Get Multiple Users

Get Current User

Get a User

Get Users in a Team

Get Users in a Workspace

Webhooks

Get Multiple Webhooks

Create Webhook

Get a Webhook

Update a Webhook

Delete a Webhook

Pagination

Code Examples

JavaScript

Python

Notes

Error Handling

Troubleshooting: API Key Issues

Troubleshooting: Invalid App Name

Resources

魔兽世界晋升堡垒真正的考验任务攻略

7.30三角洲今日密码多少？三角洲每日密码与今日特情处制造物品更新

指间山海墟海洄渊玩法攻略

《江湖秘籍》一分钟教你如何穿戴仙羽！

《江湖秘籍》全民杀怪你不能错过的超详细攻略！

《江湖秘籍》为您奉上每日目标小实用技巧！

咕咚跑步记录

小媒婆

西西证件照生成

无尽卡牌

襄阳日报

靠谱AI

王者荣耀最新版本

Asana API 集成应用场景

Asana API 集成配置指南

Asana API 集成数据架构与分类体系