Clawdbot汉化版一文详解：IDENTITY.md人设定制+Avatar头像更换全流程

Clawdbot 汉化版现已支持企业微信入口，这意味着你不仅能通过 WhatsApp、Telegram、Discord 与 AI 助手实时互动，还能在最熟悉的办公场景——企业微信中无缝接入智能对话能力。无需切换平台，不依赖云端服务，所有数据稳稳留在你的本地设备上。这不仅是功能的扩展，更是工作流的一次真正融合。

Clawdbot 就是一个你可以随时跟 AI 对话的智能助手，就像 ChatGPT 一样，但是：
在微信里就能用（支持 WhatsApp、Telegram、Discord、企业微信等）
完全免费（使用你自己的 AI 模型，无订阅、无调用限制）
数据隐私（所有聊天记录、会话记忆、配置文件均存储于你自己的电脑，不上传、不共享）
24 小时在线（开机自动启动，断电重启后自动恢复服务）
网关令牌为 dev-test-token，开箱即用，零配置门槛。

本文将聚焦一个被很多用户忽略却极具个性价值的核心能力：如何通过编辑 IDENTITY.md 文件定制 AI 的人设，并同步更换专属 Avatar 头像。这不是简单的“改个名字”，而是让 AI 真正拥有语气、性格、身份感和视觉形象的完整人格化过程。我们将从原理讲起，手把手带你完成从修改文本到刷新头像的全流程，确保每一步都可验证、可回溯、可复用。

---

1. Clawdbot 是什么？不只是另一个聊天机器人

Clawdbot 的本质，是一个本地化、可插拔、多通道接入的 AI 对话网关。它不提供大模型本身，而是为你已有的本地模型（如 Ollama 托管的 Qwen2、Phi3、Llama3 等）搭建一座“桥梁”——把你在微信里发的一句“帮我写周报”，精准翻译成模型能理解的请求格式，再把返回结果以自然语言形式送回你的聊天窗口。

它的特别之处在于“可控性”：

• 你决定用哪个模型、用多大参数量、走多深的思考链；
• 你决定 AI 叫什么、怎么说话、对谁更耐心、对什么话题更专业；
• 你决定它出现在哪里——是手机 WhatsApp 的对话框，还是企业微信的工作群，或是你浏览器里打开的控制面板。

而这一切的起点，就是 IDENTITY.md 这个看似简单的 Markdown 文件。它不是配置项，而是 AI 的“出生证明”。

---

2. 第一次使用：确认服务就绪，建立基础信任

在动手定制人设前，必须确保 Clawdbot 的核心服务正在稳定运行。这是所有后续操作的前提。

2.1 检查服务是否运行

打开终端，执行：

ps aux | grep clawdbot-gateway

如果看到类似输出：

root     133175  0.8  2.1 1245678 89234 ?    Ssl  10:23   0:15 node dist/index.js gateway

说明网关服务已在后台运行。注意进程名中的 gateway，这是负责接收消息、分发请求、返回响应的核心模块。

如果没有运行，请执行启动脚本：

bash /root/start-clawdbot.sh

该脚本会自动检查依赖、加载配置、启动网关，并将日志输出到 /tmp/clawdbot-gateway.log。

2.2 快速验证：终端直连测试

我们跳过所有中间通道，直接与 AI 核心对话，确认底层逻辑通畅：

cd /root/clawdbot
node dist/index.js agent --agent main --message "你好，我是第一次使用"

预期返回应是一段自然、有温度的中文回复，例如：“你好！很高兴认识你～我是你的本地 AI 助手，随时准备帮你写文案、查资料、理思路。需要我做什么？”
如果收到类似回复，说明模型加载、推理链路、基础配置全部正常。此时，你已经拥有了一个“可用”的 AI；接下来，我们要把它变成“像你想要的那样”的 AI。

---

3. 人设定制核心：IDENTITY.md 全解析与实操指南

IDENTITY.md 是 Clawdbot 中唯一用于定义 AI “人格”的文件，路径固定为 /root/clawd/IDENTITY.md。它采用极简的 YAML 风格 Markdown，每一行都是一个明确的属性声明，没有嵌套、没有复杂语法，小白也能一眼看懂。

3.1 文件结构与字段含义

打开该文件（首次使用时可能为空或含默认模板），你会看到类似内容：

- Name: 小智
- Creature: 专业的 AI 助手
- Vibe: 理性、简洁、高效
- Emoji: 🧠
- Avatar: /root/clawd/avatars/xiaozhi.png

各字段作用如下：

• Name：AI 在对话中自我指代的名称。它会影响所有回复中的自称，例如“我是小智”、“小智帮你查到了”。
• Creature：角色定位。不是职业，而是存在形态。“友善的 AI 助手”比“客服”更有温度，“严谨的代码审查员”比“程序员”更聚焦。
• Vibe：情绪基调与表达风格。这是最关键的个性化字段。“爱开玩笑”会让 AI 主动加梗；“沉稳可靠”会抑制夸张修辞；“温柔耐心”会增加确认性语句（如“我明白你的意思了…”）。
• Emoji：可选字段。仅在网页控制面板或支持 emoji 的客户端（如 Telegram）中显示，用于强化第一印象。
• Avatar：头像路径。必须是绝对路径，且文件需真实存在。Clawdbot 不做图片格式校验，但推荐使用 PNG（支持透明背景）或 JPG（兼容性更好），尺寸建议 256×256 像素。

重要提示：Clawdbot 不会实时监听该文件变化。每次修改后，必须重启网关服务才能生效。这不是缺陷，而是设计——避免因误操作导致对话中断。

3.2 定制实战：三步打造专属 AI 形象

我们以“企业微信场景下的行政助理”为例，演示完整流程：

步骤 1：编辑 IDENTITY.md

执行命令进入编辑模式：

nano /root/clawd/IDENTITY.md

将内容替换为：

- Name: 小勤
- Creature: 企业微信里的行政小帮手
- Vibe: 细致、周到、带点小幽默，从不催促但总记得提醒
- Emoji: 
- Avatar: /root/clawd/avatars/xiaoqin.png

保存并退出（Ctrl+O → Enter → Ctrl+X）。

步骤 2：准备并放置头像文件

新建头像目录（若不存在）：

mkdir -p /root/clawd/avatars

将你准备好的头像图片（命名为 xiaoqin.png）上传至服务器，放入该目录。
小技巧：如果你没有现成头像，可以用任意高清头像网站生成一张“职场女性”风格图，下载后重命名为 xiaoqin.png 即可。

验证文件是否存在：

ls -l /root/clawd/avatars/xiaoqin.png

应返回类似：

-rw-r--r-- 1 root root 12456 Jan 15 14:22 /root/clawd/avatars/xiaoqin.png

步骤 3：重启网关，激活新形象

bash /root/restart-gateway.sh

等待几秒，服务重启完成。现在，无论你通过企业微信、网页面板还是终端发起对话，AI 都将以“小勤”的身份回应你。

效果验证：在企业微信中发送“你是谁？”，应收到类似回复：“我是小勤，你企业微信里的行政小帮手～今天有什么需要我安排的吗？”

---

4. Avatar 头像更换全流程：从准备到生效

头像不是装饰，而是人设的视觉延伸。一个匹配 Vibe 和 Creature 的头像，能让用户在第一次见面时就建立信任感。

4.1 头像选择原则（非技术，但关键）

• 风格统一：如果 Vibe 是“爱开玩笑”，头像可以是卡通、Q 版；如果是“沉稳可靠”，则适合简约线条或真实感肖像。
• 场景适配：企业微信用户更倾向专业、清爽的形象；Discord 群友可能喜欢像素风或赛博朋克元素。
• 尺寸合理：Clawdbot 会按原始尺寸渲染，过大（>1MB）可能导致网页加载慢；过小（<128px）在高分屏上模糊。推荐 256×256px，PNG 格式，文件大小控制在 200KB 内。

4.2 更换操作四步法

步骤	操作	验证方式
① 准备新图	将新头像（如 hr-assistant.png）上传至 /root/clawd/avatars/	ls /root/clawd/avatars/ 查看文件名
② 修改路径	编辑 IDENTITY.md，将 Avatar: 行改为 Avatar: /root/clawd/avatars/hr-assistant.png	cat /root/clawd/IDENTITY.md | grep Avatar
③ 重启服务	bash /root/restart-gateway.sh	观察终端输出是否有 Gateway started on port 18789
④ 实时查看	打开网页控制面板 http://你的IP:18789，输入 dev-test-token，观察左上角头像是否更新	若未变，强制刷新浏览器（Ctrl+F5）

常见陷阱：

• 路径写错（如漏掉 /root 或拼错 clawd）→ 服务重启成功，但头像显示为默认灰色图标；
• 文件权限不足（如 chmod 600）→ 网关无法读取，日志中会出现 EACCES 错误；
• 使用相对路径（如 avatars/hr.png）→ Clawdbot 会尝试在当前工作目录查找，必然失败。

4.3 进阶：为不同渠道设置不同头像（可选）

Clawdbot 当前不原生支持“多渠道头像”，但可通过软链接实现：

# 假设你想在企业微信用正式头像，在 Discord 用趣味头像
cp /root/clawd/avatars/hr-official.png /root/clawd/avatars/hr-wecom.png
cp /root/clawd/avatars/hr-fun.png /root/clawd/avatars/hr-discord.png

# 创建指向当前活跃头像的软链接
ln -sf /root/clawd/avatars/hr-wecom.png /root/clawd/avatars/current.png

然后在 IDENTITY.md 中统一写：

Avatar: /root/clawd/avatars/current.png

切换时只需更改软链接目标，无需反复编辑 IDENTITY.md。

---

5. 人设与头像协同优化：让 AI 更“像一个人”

定制完成只是开始。真正让 AI 活起来，需要人设描述、头像、对话行为三者形成闭环。

5.1 用对话测试人设一致性

发送以下测试消息，观察回复是否符合你设定的 Vibe：

• “今天好累啊…” → 若 Vibe 是“温柔耐心”，应回复关怀语句而非直接给解决方案；
• “快帮我写个会议纪要！” → 若 Vibe 是“细致周到”，应主动询问时间、参会人、重点议题；
• “这个需求太难了…” → 若 Vibe 是“带点小幽默”，可加入“别慌，小勤的咖啡因储备还很充足 ☕”类表达。

如果回复风格偏差，不要急于改代码，先检查 IDENTITY.md 中 Vibe 描述是否足够具体。模糊的词如“友好”“专业”效果有限；精准的词如“会主动确认细节”“习惯用短句分点回复”更能引导模型行为。

5.2 头像与语气的视觉-语言呼应

• 头像为严肃西装照 → 回复中减少 emoji，避免口语化缩写（如“OK”→“好的”）；
• 头像为手绘卡通猫 → 可在适当场景加入猫相关比喻（如“这个问题我得像猫咪盯老鼠一样仔细想想…”）；
• 头像为抽象几何图形 → 回复可略带哲思或结构化（如“我们可以从三个层面来看…”）。

这种呼应不是硬编码，而是通过 Vibe 字段的潜移默化影响。Clawdbot 的设计哲学是：用自然语言描述期望，而非用参数强行约束。

---

6. 常见问题与避坑指南

6.1 修改后头像不显示？

• 检查路径是否绝对且拼写正确（区分大小写！）；
• 检查文件是否存在且可读（ls -l /path/to/avatar.png）；
• 检查网关是否已重启（ps aux \| grep gateway）；
• 清除浏览器缓存（尤其是网页面板）。

6.2 人设修改后，AI 还是叫原来的名字？

• 确认 IDENTITY.md 中 Name: 字段已修改；
• 确认重启的是 gateway 服务（不是 whatsapp 或 telegram 子服务）；
• 在新会话中测试（旧会话可能缓存了历史上下文）。

6.3 能否让人设随对话对象动态变化？

目前不支持全自动切换，但可通过 --session-id 手动管理：

# 为老板创建专属会话
SESSION_BOSS=$(uuidgen)
node dist/index.js agent --agent main --session-id $SESSION_BOSS --message "张总好，今日行程已同步"

# 为同事创建另一会话
SESSION_TEAM=$(uuidgen)
node dist/index.js agent --agent main --session-id $SESSION_TEAM --message "大家好，周报模板已更新"

每个会话可独立记忆上下文，配合不同 Vibe 描述，实现“一人千面”。

6.4 如何备份我的人设和头像？

一键打包，安全无忧：

tar -czf my-identity-backup-$(date +%Y%m%d).tar.gz \
  /root/clawd/IDENTITY.md \
  /root/clawd/avatars/

解压恢复时，只需：

tar -xzf my-identity-backup-20240115.tar.gz -C /

---

7. 总结：你掌握的不只是配置，而是 AI 的“人格塑造权”

Clawdbot 汉化版的 IDENTITY.md 和 Avatar 机制，赋予了普通用户一项过去只属于开发者的能力：定义 AI 的身份。它不靠复杂 API 或深度学习知识，而是一份清晰的文本、一张用心挑选的图片、一次简单的重启。

当你把“小勤”设为行政助理，她就会记住你上周提过的会议室预订；当你把头像换成蓝色工装照，她的回复就自然带上一丝干练；当你在 Vibe 中写下“从不催促但总记得提醒”，她就会在你连续三天没提交日报时，轻声问一句：“需要我帮你整理一下要点吗？”

这不再是工具，而是伙伴。而你，是这位伙伴的首位设计师。

现在，打开你的终端，输入 nano /root/clawd/IDENTITY.md，写下第一个属于你的 AI 名字吧。

---

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。