English | 中文
为 OpenClaw 添加一个有温度的角色伴侣。
她知道现在几点，知道你在做什么。你问她在哪，她就告诉你；你不问，她也可能随手发来一张自拍。
- 时间感知 — 早晨、上课、午休、傍晚、深夜，场景和穿搭随时间自动切换
- 情境生图 — 根据对话内容和当前状态生成自拍（支持写实和动漫风格），非模板套用
- 主动发图 — 可配置触发频率，日常聊天中随机发自拍表示关心
- 多角色 — 每个角色有独立人设、时间状态和参考图，通过配置一键切换
- 自定义角色 — 通过对话创建自定义角色，LLM 引导生成完整角色定义并写盘
- 多图像服务 — 支持阿里云百炼、火山引擎 ARK、fal.ai、OpenAI 兼容接口
- 个人伴侣 — 日常陪伴、情感交流、生活助手
- 虚拟导师 — 学习辅导、知识答疑、进度跟踪
- 智能客服 — 企业服务、品牌形象、客户互动
- 专业顾问 — 健康管理、心理咨询、职业指导
- 更多角色 — 添加不同性格和背景的内置角色
- 语音交互 — 角色语音合成，支持语音对话
- 视频生成 — 短视频片段和动态表情
- 社区角色 — 角色分享和下载平台
左：指定场景 | 右：不指定场景
更多样例图片见 完整图片展示
不同时间状态和场景下的自动生成效果
确保已安装 OpenClaw。
首次安装与后续更新使用同一命令：
npx github:BytePioneer-AI/clawmate交互式安装向导会引导你完成角色选择、主动发图配置和图像服务配置。
安装完成后，对你的 Agent 说：
发张自拍看看
你现在在干嘛？
晚上在卧室穿着粉色睡衣拍一张
创建自定义角色:
帮我创建一个[动漫/写实]风格的新角色，她是一个[描述职业/性格/背景]的女生
# 例：
帮我创建一个动漫风格的新角色，她是一个喜欢画画的大学生
帮我创建一个写实风格的新角色，她是一个热爱咖啡的独立书店店长
git clone https://github.com/BytePioneer-AI/clawmate.git
cd clawmate
npm install
npm run clawmate:setup在 ~/.openclaw/openclaw.json 的 plugins.entries.clawmate-companion.config 下配置：
- 写实风格建议使用 Nano Banana。
- 除 Nano Banana 外，其他模型更建议搭配动漫角色。
| 服务 | 费用特性 |
|---|---|
| ModelScope | 完全免费 |
| 阿里云百炼 | 有免费额度（以官方控制台为准） |
| 火山引擎 ARK | 有免费额度（以官方控制台为准） |
| OpenAI 兼容接口 | 取决于接入服务商 |
| fal.ai | 取决于平台计费策略 |
OpenAI 兼容接口
{
"defaultProvider": "openai",
"providers": {
"openai": {
"name": "openai",
"apiKey": "YOUR_OPENAI_API_KEY",
"baseUrl": "https://api.openai.com/v1",
"model": "gpt-image-1.5"
}
}
}支持任何兼容 OpenAI /v1/images/edits 接口的服务，可通过 baseUrl 指定自定义端点。
阿里云百炼
{
"defaultProvider": "aliyun",
"providers": {
"aliyun": {
"apiKey": "YOUR_DASHSCOPE_API_KEY",
"model": "wan2.6-image"
}
}
}火山引擎 ARK（API申请文档）
{
"defaultProvider": "volcengine",
"providers": {
"volcengine": {
"apiKey": "YOUR_ARK_API_KEY",
"model": "doubao-seedream-4-5-251128"
}
}
}fal.ai
{
"defaultProvider": "fal",
"providers": {
"fal": {
"apiKey": "YOUR_FAL_KEY",
"model": "fal-ai/flux/dev/image-to-image"
}
}
}{
"proactiveSelfie": {
"enabled": true,
"probability": 0.1
}
}probability 为每条消息的触发概率，推荐范围 0.1–0.3。
在 assets/characters/ 下新建角色目录，包含：
{character-id}/
├── meta.json # id、name、style（photorealistic/anime）、timeStates
├── character-prompt.md # 角色人设（英文）
├── README.md # 角色档案（中文）
├── images/ # 参考图文件夹
│ └── reference.png
└── *.png # 其他参考图（可选）
然后在配置中切换：
{
"selectedCharacter": "your-character-id"
}直接对 Agent 说：
帮我创建一个新角色，她是一个喜欢画画的大学生
Agent 会调用 clawmate_prepare_character 获取角色定义模板和样例，引导你补充细节，然后调用 clawmate_create_character 将角色写入 ~/.openclaw/clawmeta/。
自定义角色目录与内置角色分离，加载时用户目录优先。也可以通过配置 userCharacterRoot 自定义存储路径。
ClawMate/
└── packages/clawmate-companion/
├── src/core/ # 核心逻辑（pipeline、router、providers）
├── skills/ # Skill 定义与角色素材
│ └── clawmate-companion/
│ ├── SKILL.md
│ └── assets/characters/
│ └── brooke/
└── bin/cli.cjs # 安装向导
MIT