ClawBot创建AI角色人设的详细步骤与技巧

想让你的ClawBot拥有独特的性格和身份，而不是千篇一律的通用回复风格吗？这完全可以通过自定义AI角色来实现。ClawBot将“人格”定义结构化地保存在一个纯文本文件中，所有定制都在本地完成，无需依赖任何网络或云端服务。下面，我们就来一步步拆解这个定制过程。

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

一切定制都始于一个核心文件：IDENTITY.md。它就像是ClawBot的“身份证”，里面定义了AI的姓名、生物属性、情绪基调、默认表情以及头像路径。这个文件通常位于 /root/clawd/ 目录下。动手修改前，务必要做好备份，这是避免配置出错后无法回退的关键一步。

操作很简单：打开终端，依次执行以下命令：

cp /root/clawd/IDENTITY.md /root/clawd/IDENTITY.md.backup

备份完成后，可以用 ls -l /root/clawd/IDENTITY.md* 命令来确认一下，确保输出列表中同时存在 IDENTITY.md 和它的备份文件 IDENTITY.md.backup。如果缺少备份，一旦配置出错，恢复起来可就麻烦了。

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

接下来就是赋予它“灵魂”的时刻了。用你熟悉的文本编辑器（比如nano）打开这个文件：

nano /root/clawd/IDENTITY.md

文件内容采用清晰的键值对结构。你需要做的，就是根据你的设想，修改等号右边的值。举个例子，你可以这样定义：

• name: 小张助理
• creature: 人类职场助手
• vibe: 专业、简洁、略带温度
• emoji: ?‍?
• a vatar: /root/clawd/a vatars/assistant.png

这里有两个细节需要特别注意：首先，确保每行末尾没有多余的空格；其次，emoji请直接使用UTF-8原生字符，而不是贴入图片链接。任何微小的语法错误，比如冒号缺失或缩进错乱，都可能导致网关服务无法启动。

编辑完成后，记得保存退出（在nano中按Ctrl+O，回车确认，再按Ctrl+X）。

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

一个独特的头像能让角色形象立刻鲜活起来。ClawBot支持使用本地的PNG或JPEG图片作为头像，它会显示在企业微信、Telegram等聊天界面中。

首先，确保头像的存放目录存在：

mkdir -p /root/clawd/a vatars/

然后，将你准备好的头像文件上传到这个目录，并确保文件名与上一步IDENTITY.md中a vatar字段设置的路径完全一致，例如assistant.png。

最后，别忘了给头像文件设置正确的读取权限：

chmod 644 /root/clawd/a vatars/assistant.png

对了，头像尺寸建议控制在512×512像素左右。尺寸过大，在某些客户端上可能会加载失败。

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

修改配置文件后，ClawBot并不会自动感知变化。你需要手动重启网关进程，新的角色设定才会被加载。重启会短暂中断当前的会话连接，但请放心，历史记录不会丢失。

执行重启命令：

bash /root/restart-gateway.sh

重启后，最好检查一下进程是否已经正常恢复：

ps aux | grep clawdbot-gateway

如果能在输出中看到clawdbot-gateway进程，并且其启动时间更新为了当前时刻，就说明重启成功了。如果服务没有响应，别慌，立刻去查看/tmp/clawdbot-gateway.log日志文件，里面通常会有具体的报错信息。

五、实时验证角色表现

配置是否真正生效，还得在实际对话中检验。不同的聊天渠道对角色字段的支持侧重点可能略有不同，比如企业微信会更直观地展示姓名和头像，而Telegram则对语气和表情符号更敏感。

验证方法很直接：

1. 在企业微信或你配置的其他渠道里，给机器人发条消息，比如简单的“你好”。
2. 观察回复消息：开头是否包含了你在name字段中设定的名字（例如“小张助理：您好！”）。
3. 同时检查消息气泡旁是否显示了新上传的头像，以及消息末尾是否附带了指定的emoji表情。

如果发现名字没出现，那很可能是IDENTITY.md文件中name字段的格式有误或者文件没有保存成功。如果头像不显示，则需要回头仔细核对a vatar字段的路径拼写是否正确，以及头像文件的读取权限是否设置妥当。