Canva Connect

通过 Connect API 管理 Canva 设计、素材和文件夹。

此技能可做（与不可做）之事

实际用例

1. 素材流水线🖼️

Generate diagram → upload to Canva → organize in project folder

2. 导出自动化📤

Design finished in Canva → export via CLI → use in docs/website

3. 设计整理📁

Create project folders → move related designs → keep Canva tidy

4. 品牌模板自动填充📋

Set up template in Canva → pass data via API → get personalized output

快速开始

# Authenticate (opens browser for OAuth)
{baseDir}/scripts/canva.sh auth

# List your designs
{baseDir}/scripts/canva.sh designs list

# Create a new design
{baseDir}/scripts/canva.sh designs create --type doc --title "My Document"

# Export a design
{baseDir}/scripts/canva.sh export <design_id> --format pdf

设置

1. 创建 Canva 集成

1. 前往canva.com/developers/integrations
2. 点击创建集成
3. 设置权限范围：
   • design:content(读取 + 写入)
   • design:meta(读取)
   • asset(读取 + 写入)
   • brandtemplate:meta(读取)
   • brandtemplate:content(读取)
   • profile(读取)
4. 设置 OAuth 重定向：http://127.0.0.1:3001/oauth/redirect
5. 注意客户端 ID并生成客户端密钥

2. 配置环境

添加到~/.clawdbot/clawdbot.json下的skills.entries：

{
  "skills": {
    "entries": {
      "canva": {
        "clientId": "YOUR_CLIENT_ID",
        "clientSecret": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

或设置环境变量：

export CANVA_CLIENT_ID="your_client_id"
export CANVA_CLIENT_SECRET="your_client_secret"

3. 身份验证

{baseDir}/scripts/canva.sh auth

打开浏览器进行OAuth授权。令牌存储在~/.clawdbot/canva-tokens.json中。

命令

身份验证

设计

设计类型： 文档、演示文稿、白板、海报、Instagram帖文、Facebook帖文、视频、徽标、传单,横幅

导出

格式： pdf,png,jpg,gif,pptx,mp4

素材

品牌模板

文件夹

用户

示例

创建并导出海报

# Create
{baseDir}/scripts/canva.sh designs create --type poster --title "Event Poster"

# Export as PNG
{baseDir}/scripts/canva.sh export DAF... --format png --output ./poster.png

上传品牌资产

# Upload logo
{baseDir}/scripts/canva.sh assets upload ./logo.png --name "Company Logo"

# Upload multiple
for f in ./brand/*.png; do
  {baseDir}/scripts/canva.sh assets upload "$f"
done

自动填充模板

# List available templates
{baseDir}/scripts/canva.sh templates list

# Autofill with data
{baseDir}/scripts/canva.sh autofill TEMPLATE_ID --data '{
  "title": "Q1 Report",
  "subtitle": "Financial Summary",
  "date": "January 2026"
}'

API 参考

基础 URL:https://api.canva.com/rest

参见references/api.md获取详细的端点文档。

故障排除

令牌过期

{baseDir}/scripts/canva.sh auth  # Re-authenticate

速率限制

API 对每个端点都有速率限制。脚本会自动处理退避机制。

缺少权限范围

如果操作失败并返回 403 错误，请确保您的集成已启用所需的权限范围。

数据文件