ClawBot怎么创建专属的AI角色和人设？

ClawBot可通过修改本地IDENTITY.md文件定义专属AI角色。需备份文件、编辑name/creature/vibe/emoji/avatar字段、配置512×512头像、重启网关，并在企业微信等渠道验证name、头像及emoji是否生效。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望ClawBot表现出特定的性格、语气或身份，而非使用默认的通用回复风格，则需要通过修改其人设配置文件来定义专属AI角色。ClawBot将AI的“人格”结构化地保存在纯文本文件中，所有定制均在本地完成，不依赖网络或云端服务。以下是具体操作步骤：

一、定位并备份IDENTITY.md文件

IDENTITY.md是ClawBot的核心人设定义文件，存储AI的姓名、生物属性（Creature）、情绪基调（Vibe）、默认表情（Emoji）及头像路径（Avatar）。该文件位于/root/clawd/目录下。修改前必须进行备份，以防配置错误导致服务异常。

1、打开终端，执行备份命令：
cp /root/clawd/IDENTITY.md /root/clawd/IDENTITY.md.backup

2、验证备份是否成功：
ls -l /root/clawd/IDENTITY.md*

3、确认输出中同时存在IDENTITY.md与IDENTITY.md.backup两个文件，缺少备份将无法回退错误配置。

二、编辑IDENTITY.md定义角色特征

该文件采用Markdown格式，每一项均为键值对结构。修改时需严格保持原始字段名（如name、creature、vibe等），仅替换右侧值内容。任何语法错误（如缺失冒号、缩进错位）将导致网关启动失败。

1、使用nano编辑器打开文件：
nano /root/clawd/IDENTITY.md

2、按需修改以下字段：
name: 小张助理
creature: 人类职场助手
vibe: 专业、简洁、略带温度
emoji: ?‍?
avatar: /root/clawd/avatars/assistant.png

3、保存并退出：按Ctrl+O → 回车确认 → Ctrl+X退出编辑器
4、确保每行末尾无空格，且emoji使用UTF-8原生字符而非图片链接。

三、准备并配置自定义头像

ClawBot支持为AI角色指定本地PNG或JPEG格式头像，该图像将显示在企业微信、Telegram等渠道的对话界面中。头像路径必须为绝对路径，且文件需具备可读权限。

1、创建头像存放目录（若不存在）：
mkdir -p /root/clawd/avatars/

2、将头像文件上传至该目录，命名为assistant.png（与IDENTITY.md中avatar字段一致）

3、设置文件权限：
chmod 644 /root/clawd/avatars/assistant.png

4、头像尺寸建议为512×512像素，过大可能导致部分客户端加载失败。

四、重启网关使新角色生效

ClawBot不会自动监听IDENTITY.md文件变更，必须手动重启网关进程才能加载最新人设配置。重启过程会中断当前所有会话连接，但不丢失历史记录。

1、执行重启命令：
bash /root/restart-gateway.sh

2、检查进程是否恢复：
ps aux | grep clawdbot-gateway

3、确认输出中出现clawdbot-gateway进程，并且启动时间更新为当前时刻
4、若重启后服务未响应，请立即检查/tmp/clawdbot-gateway.log中的报错信息。

五、实时验证角色表现

人设修改是否成功，需通过实际消息交互验证。不同渠道对字段的支持程度略有差异，例如企业微信优先展示name与avatar，Telegram则更强调vibe与emoji的语义表达。

1、在企业微信中向机器人发送任意消息（如“你好”）

2、观察回复开头是否包含设定的name（如“小张助理：您好！”）

3、检查消息气泡左侧是否显示新头像，且消息末尾是否附带指定emoji（如“?‍?”）

4、若name未出现，说明IDENTITY.md中name字段格式错误或未保存；若头像不显示，需确认avatar路径拼写与文件权限。