Asana任务管理

技能简介

该技能通过Asana REST API将Clawdbot与Asana项目管理平台连接，支持个人本地OAuth授权方式，实现任务、项目和工作空间的查询与操作。

业务背景

将 Asana 项目数据无缝接入对话式工作流，业务人员无需切换平台即可查询任务进度、创建新事项或更新状态。本地 OAuth 授权保障个人账户安全，自动令牌刷新减少运维中断，让项目管理与日常沟通在同一界面完成。

落地案例：项目经理在对话中输入"/asana 列出本周截止的任务"，技能调用 API 返回分配给自己的任务清单，含优先级与截止日期。发现某任务需延期，直接指令"将网站改版任务截止日改为下周五"，系统自动同步至 Asana。全程无需打开浏览器登录 Asana 网页。

能做什么

• 生成Asana授权链接并完成OAuth令牌交换
• 自动刷新访问令牌，保持长期可用
• 列出、搜索、创建和更新Asana任务
• 查看项目列表和工作空间信息
• 为任务添加评论、标记完成状态

使用说明

前置准备：在Asana开发者控制台创建应用，启用所需权限范围（如tasks:read、tasks:write），并将重定向URI设置为urn:ietf:wg:oauth:2.0:oob。

安装步骤：

1. 配置凭证（二选一）：
   方式A（推荐）：node scripts/configure.mjs --client-id "..." --client-secret "..."
   方式B：设置环境变量ASANA_CLIENT_ID和ASANA_CLIENT_SECRET
2. 获取授权码：node scripts/oauth_oob.mjs authorize，打开输出的URL，点击允许后复制授权码
3. 交换令牌：node scripts/oauth_oob.mjs token --code "粘贴授权码"，令牌将保存至~/.clawdbot/asana/token.json

常用命令：

• 查看当前用户：node scripts/asana_api.mjs me
• 列出工作空间：node scripts/asana_api.mjs workspaces
• 设置默认工作空间：node scripts/asana_api.mjs set-default-workspace --workspace <gid>
• 列出项目：node scripts/asana_api.mjs projects
• 查看分配给我的任务：node scripts/asana_api.mjs tasks-assigned --assignee me
• 搜索任务：node scripts/asana_api.mjs search-tasks --text "关键词"
• 创建任务：node scripts/asana_api.mjs create-task --name "任务名称" --projects <gid>
• 更新任务：node scripts/asana_api.mjs update-task <gid> --name "新标题"
• 标记完成：node scripts/asana_api.mjs complete-task <gid>
• 添加评论：node scripts/asana_api.mjs comment <gid> --text "评论内容"

输入与输出

见下方输入与输出表格。

风险提示

• 访问令牌会过期，依赖刷新令牌自动续期
• 当前仅支持单人本地使用，多用户场景需改用真实回调地址
• 切勿在日志中输出或泄露令牌信息
• 部分操作需要指定工作空间ID，建议先设置默认工作空间简化命令

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/k0nkupa/asana/SKILL.md
来源类型：GitHub仓库