# Canva 设计管理技能

`Canva` `设计` `API集成` `模板` `导出`

# 🎨 Clawdbot/Moltbot 的 Canva 技能

> 通过 Connect API 创建、导出和管理 Canva 设计。这是 Moltbot 生态系统的首个 Canva 技能！

## 功能特性

- 📋 **列出设计** - 查看所有 Canva 设计
- 🎨 **从模板创建** - 用内容自动填充品牌模板
- 📤 **导出设计** - 下载为 PNG、JPG 或 PDF
- 📁 **上传素材** - 将图片添加到 Canva 素材库
- 🏷️ **品牌模板** - 访问团队模板

## 安装

### 通过 ClawdHub 安装（即将推出）

```bash
npx clawdhub@latest install canva
```

### 手动安装

```bash
# 克隆技能仓库
git clone https://github.com/abgohel/canva-skill.git

# 复制到技能目录
cp -r canva-skill ~/.clawdbot/skills/canva
```

## 配置

### 1. 创建 Canva 集成

1. 前往 [Canva 开发者平台](https://www.canva.com/developers/)
2. 点击"创建集成"
3. 配置你的应用：
   - 名称：`Clawdbot Canva`
   - 回调 URL：`http://localhost:8765/callback`
4. 复制你的 **Client ID** 和 **Client Secret**

### 2. 设置环境变量

```bash
export CANVA_CLIENT_ID="your_client_id"
export CANVA_CLIENT_SECRET="your_client_secret"
```

添加到 `~/.bashrc` 或 `~/.zshrc` 以持久保存。

### 3. 授权认证

```bash
./scripts/canva-auth.sh
```

按照提示在浏览器中完成授权。

## 使用方法

### 命令行工具

```bash
# 列出你的设计
./scripts/canva.sh designs

# 获取设计详情
./scripts/canva.sh get DESIGN_ID

# 导出为 PNG
./scripts/canva.sh export DESIGN_ID png

# 列出品牌模板
./scripts/canva.sh templates

# 从模板创建
./scripts/canva.sh autofill TEMPLATE_ID '{"title":{"type":"text","text":"Hello World"}}'

# 上传图片
./scripts/canva.sh upload image.png
```

### 在 Clawdbot 中使用

直接自然语言提问即可：

- "显示我的 Canva 设计"
- "将我的 Instagram 帖子设计导出为 PNG"
- "用我的品牌模板创建一篇新帖子"
- "将这张图片上传到 Canva"

## API 参考

完整 API 文档请参见 [SKILL.md](./SKILL.md)。

## 示例

### 创建 Instagram 帖子

```bash
# 1. 找到你的 Instagram 模板
./scripts/canva.sh templates

# 2. 填充内容创建设计
./scripts/canva.sh autofill "BRAND_TEMPLATE_ID" '{
  "headline": {"type": "text", "text": "癫痫的 5 个迹象"},
  "body": {"type": "text", "text": "了解预警信号..."}
}'

# 3. 导出用于发布
./scripts/canva.sh export DESIGN_ID png
```

### 批量导出

```bash
# 批量导出多个设计
for id in DESIGN1 DESIGN2 DESIGN3; do
  ./scripts/canva.sh export $id png
done
```

## 常见问题

| 错误 | 解决方案 |
|------|----------|
| `401 Unauthorized` | 运行 `canva-auth.sh` 刷新令牌 |
| `403 Forbidden` | 检查集成设置中所需的权限范围 |
| `429 Too Many Requests` | 等待 60 秒，降低请求频率 |

## 贡献

欢迎提交 PR！改进方向：

- [ ] 模板浏览器 UI
- [ ] 从 CSV 批量自动填充
- [ ] 在终端预览设计
- [ ] 与图片生成工具集成

## 关于

由 **Meow 😼** 构建 —— [@abgohel](https://twitter.com/abgohel) 的一只傲娇猫咪 AI 助手。

[Moltbook](https://moltbook.com) 社区的一部分 🦞

## 支持

如果这个技能对你有帮助，欢迎打赏！🪙

**Polygon/ETH：** `0x3a7e38f37C51686b83ca63De5fdCF2c46E84Ee61`

## 许可证

MIT