@clawmate/clawmate
Advanced tools
English | 中文
为 OpenClaw 添加一个有温度的角色伴侣。
她知道现在几点，知道你在做什么。你问她在哪，她就告诉你；你不问，她也可能随手发来一张自拍。
更多样例图片见 完整图片展示
社群优秀样例哈哈，真的很不错
主动发图、主动关环，给你的 OpenClaw 注入一个有温度的灵魂
确保已安装 OpenClaw。
首次安装与后续更新使用同一命令：
npx @clawmate/clawmate
交互式安装向导会引导你完成角色选择、主动发图配置、语音配置和图像服务配置；多 Agent 场景下也支持只配置某个 Agent。
如果你在安装向导中选择 复刻音色，建议先理解下面几个字段。
cosyvoice-v3.5-pluscosyvoice-v3.5-plus、cosyvoice-v2modelId 填进来。cosyvoice-clone-v1 即可。mghus。https://bailian.console.aliyun.com/cn-beijing?spm=5176.29619931.J_PvCec88exbQTi-U433Fxg.5.9f2110d7c0UDIv&tab=model#/efm/model_experience_center/voice?currentTab=voiceTts&primary=cloning&secondary=clone推荐用阿里云 OSS：
https://oss.console.aliyun.com/overview示例音频 URL建议参考音频满足：
npm run clawmate:setup复刻音色npm run clawmate:probe:tts:clone安装完成后，对你的 Agent 说：
发张自拍看看
你现在在干嘛？
晚上在卧室穿着粉色睡衣拍一张
创建自定义角色:
帮我创建一个[动漫/写实]风格的新角色，她是一个[描述职业/性格/背景]的女生
# 例：
帮我创建一个动漫风格的新角色，她是一个喜欢画画的大学生
帮我创建一个写实风格的新角色，她是一个热爱咖啡的独立书店店长
git clone https://github.com/BytePioneer-AI/clawmate.git
cd clawmate
npm install
npm run clawmate:setup
多 Agent 配置示例：
{
"selectedCharacter": "brooke-anime",
"defaultProvider": "volcengine",
"agents": {
"ding-main": {
"selectedCharacter": "brooke-anime",
"defaultProvider": "volcengine"
},
"ding-work": {
"selectedCharacter": "brooke",
"defaultProvider": "aliyun"
}
}
}
插件会按当前 Agent 的 workspace 分别写入各自的 SOUL.md，不会再共用同一份人格文件。
在 ~/.openclaw/openclaw.json 的 plugins.entries.clawmate-companion.config 下配置：
- 写实风格建议使用 Nano Banana。
- 除 Nano Banana 外，其他模型更建议搭配动漫角色。
| 服务 | 费用特性 |
|---|---|
| Gemini 官方 SDK | 取决于 Gemini API 或代理服务额度 |
| ModelScope | 完全免费 |
| 阿里云百炼 | 有免费额度（以官方控制台为准） |
| 火山引擎 ARK | 有免费额度（以官方控制台为准） |
| OpenAI 兼容接口 | 取决于接入服务商 |
| fal.ai | 取决于平台计费策略 |
Gemini 官方 SDK（官方默认地址）
{
"defaultProvider": "gemini",
"providers": {
"gemini": {
"type": "gemini",
"apiKey": "YOUR_GEMINI_API_KEY",
"model": "gemini-3.1-flash-image-preview"
}
}
}
Gemini 官方 SDK（自定义 BaseURL）
{
"defaultProvider": "gemini",
"providers": {
"gemini": {
"type": "gemini",
"apiKey": "YOUR_GEMINI_API_KEY",
"baseUrl": "https://your-proxy.example.com",
"model": "gemini-3.1-flash-image-preview"
}
}
}
Gemini provider 走 Google GenAI SDK 原生图片请求，不复用 OpenAI-compatible 适配层。
baseUrl 为空或不写时，使用 Gemini SDK 官方默认 API 地址baseUrl 有值时，改走你提供的自定义地址baseUrl 需要兼容 Google GenAI SDK 的请求路径和鉴权语义CLI 当前内置以下 Gemini 预设模型，也支持手动输入自定义模型名：
gemini-3-pro-image-previewgemini-3.1-flash-image-previewgemini-2.5-flash-imagegemini-2.5-flash-image-previewOpenAI 兼容接口
{
"defaultProvider": "openai",
"providers": {
"openai": {
"name": "openai",
"apiKey": "YOUR_OPENAI_API_KEY",
"baseUrl": "https://api.openai.com/v1",
"model": "gpt-image-1.5"
}
}
}
支持兼容 OpenAI 的图片模型服务，可通过 baseUrl 指定自定义端点。
有输入图片时优先尝试 /v1/images/edits，失败后回退到 /v1/chat/completions；没有输入图片时直接调用 /v1/chat/completions。
阿里云百炼
{
"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/
├── bin/clawmate.cjs # 安装向导
└── packages/clawmate-companion/
├── src/core/ # 核心逻辑（pipeline、router、providers）
├── skills/ # Skill 定义与角色素材
│ └── clawmate-companion/
│ ├── SKILL.md
│ └── assets/characters/
│ └── brooke/
执行链路如下：
Agent 判断 -> Tool 合成 -> 插件落盘 -> 返回本地路径
before_agent_start 会注入角色 SOUL.md；启用 TTS 时，还会追加一条轻量提示，让 Agent 在合适的时候使用 clawmate-companion-tts skill。clawmate_generate_tts。clawmate_generate_tts 会调用阿里云千问 TTS 的 DashScope 原生接口进行合成，当前默认模型为 qwen3-tts-flash，默认音色为 Chelsie。~/.openclaw/media/clawmate-voice/YYYY-MM-DD/。audioPath；具体如何把这段音频发到不同渠道，由上层运行时决定。成功时不应重复发送同内容文字，失败时则降级为普通文字回复。MIT
FAQs
One-click installer for the ClawMate OpenClaw companion plugin
The npm package @clawmate/clawmate receives a total of 22 weekly downloads. As such, @clawmate/clawmate popularity was classified as not popular.
We found that @clawmate/clawmate demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Company News
Replit is integrating Socket Firewall into its AI-powered development experience to help protect builders from malicious open source packages.
Security News
npm confirmed a tooling bug incorrectly marked several one-character packages as security holders and said it was working on a rollback.
Research
/Security News
Newer packages in this compromise use native extensions and .pth loaders to execute JavaScript stealers in developer environments.