【OpenClaw】图像配置指南

OpenClaw 图像配置指南

概述

OpenClaw 支持多种方式配置 Agent 的头像图像，包括本地文件、HTTP(S) URL 和 Data URI。

配置位置

图像配置在 IDENTITY.md 文件中，字段为 Avatar。

文件路径： ~/.openclaw/workspace/IDENTITY.md

支持的图像格式

1. 本地文件路径（推荐）

- **Avatar:** avatars/claw.png

• 相对路径：相对于 workspace 根目录
• 绝对路径：完整文件系统路径
• 支持格式：PNG、JPEG、WebP、GIF

2. HTTP(S) URL

- **Avatar:** https://example.com/avatar.png

• 直接使用网络图像 URL
• 支持格式：PNG、JPEG、WebP

3. Data URI

- **Avatar:** data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...

• Base64 编码的图像数据
• 适合小图标或需要嵌入的场景

实际示例

示例 1：本地泰迪熊图像

- **Avatar:** avatars/teddy_claw.jpg

图像文件应放在：~/.openclaw/workspace/avatars/teddy_claw.jpg

示例 2：网络图像

- **Avatar:** https://img1.doubanio.com/view/photo/l/public/p2578519489.webp

示例 3：转换 WebP 为 PNG（兼容性优化）

# 安装 ImageMagick
sudo apt-get install imagemagick

# 转换格式
convert teddy_bear.webp avatars/teddy_claw.png

图像要求

• 推荐尺寸： 512x512 或 1024x1024（正方形）
• 文件大小： 建议 < 500KB
• 格式： PNG（透明背景）、JPEG、WebP

修改步骤

1. 编辑 IDENTITY.md 文件
2. 修改 Avatar 字段为新图像路径
3. 重启 OpenClaw 服务或重新加载配置

故障排查

图像不显示

1. 检查文件路径是否正确
2. 确认文件权限（可读）
3. 验证图像格式是否支持
4. 查看 OpenClaw 日志获取详细错误

网络图像加载失败

1. 检查网络连接
2. 确认 URL 可访问
3. 某些网站可能需要 Referer 头（如豆瓣）

相关文件

• IDENTITY.md - Agent 身份配置
• SOUL.md - Agent 人格设定
• MEMORY.md - 长期记忆