Clawdbot汉化版实操手册：IDENTITY.md人设定制+Avatar头像+Emoji风格化输出

Clawdbot汉化版现已支持企业微信入口，这意味着你不仅能通过WhatsApp、Telegram、Discord与AI助手实时互动，还能在最熟悉的办公场景——企业微信中无缝接入智能服务。无需切换平台，不依赖云端账号，所有对话都运行在你自己的设备上，真正实现“私有化AI助手”的最后一公里落地。

Clawdbot不是一个需要注册、订阅或等待审核的SaaS工具，它是一套可完全掌控的本地化AI通信网关。你既是使用者，也是部署者；既是提问者，也是规则制定者。它不收集你的数据，不上传你的会话，不分析你的习惯——它只忠实地执行你的指令，并把结果交还给你。而今天这份手册，将带你从零开始，亲手为这个AI助手注入个性：定义它的名字、性格、语气、头像，甚至让它用一朵小花🌸或一盏灯来代替冷冰冰的文字回应。

---

1. 什么是Clawdbot？

Clawdbot本质上是一个本地运行的AI消息代理系统。它不提供大模型本身，而是为你已有的本地模型（如Ollama托管的Qwen2、Phi3、Llama3等）搭建一座“桥梁”，让这些模型能听懂微信消息、理解Telegram指令、响应Discord命令，并以符合你预期的方式表达出来。

它和ChatGPT的区别，不是能力高低，而是控制权归属：

• 在微信里就能用：企业微信、WhatsApp、Telegram、Discord全部原生支持，无需网页跳转或App下载
• 完全免费：不收月费、不限次数、不卡额度——只要你本地有模型，它就永远在线
• 数据隐私：聊天记录存在/root/.clawdbot/agents/main/sessions/下，日志写入/tmp/clawdbot-gateway.log，全程不触网、不外传
• 24小时在线：开机自启，断电恢复后自动重连，真正属于你个人的“数字同事”

更重要的是，Clawdbot把AI从“回答机器”升级为“可塑角色”。它不只输出文字，还能承载身份、情绪、视觉符号——而这，正是本手册要带你深入实践的核心：人设（IDENTITY.md）、头像（Avatar）、风格化输出（Emoji）三位一体的个性化配置。

---

2. 第一次使用：确认服务状态与基础验证

在动手定制前，先确保Clawdbot网关正在稳定运行。这不是可选步骤，而是所有个性化生效的前提。

2.1 检查服务是否运行

打开终端，执行：

ps aux | grep clawdbot-gateway

如果看到类似输出，说明网关进程已在后台运行：

root     133175  0.8  2.1 1245678 89234 ?    Ssl  Jan15  12:45 /usr/bin/node /root/clawdbot/dist/index.js gateway

注意：不要只看clawdbot字样，重点确认clawdbot-gateway进程是否存在。agent或whatsapp等子进程可能未启动，但网关必须在线。

若无结果，说明服务未运行。此时执行启动脚本：

bash /root/start-clawdbot.sh

该脚本会依次启动网关、加载配置、初始化模型连接。首次运行约需10–20秒，请耐心等待。

2.2 验证AI响应能力

服务启动后，立即测试最基础的交互链路：

cd /root/clawdbot
node dist/index.js agent --agent main --message "你好"

你将看到类似这样的结构化输出：

{
  "session_id": "sess_abc123",
  "response": "你好！我是你的AI助手，很高兴见到你 ",
  "timestamp": "2025-01-28T09:15:22Z"
}

出现response字段且内容合理，代表模型调用通路已打通。
❌ 若报错Error: model not found，请先检查Ollama是否运行（ollama list），并确保clawdbot.json中配置了可用模型。

---

3. 人设定制：从IDENTITY.md开始塑造AI性格

Clawdbot的“人格”并非硬编码在程序里，而是由一个纯文本文件——/root/clawd/IDENTITY.md——动态驱动。修改它，就是给AI换上新皮肤、新声线、新态度。

3.1 IDENTITY.md文件结构解析

该文件采用YAML风格的Markdown语法，共5个核心字段，缺一不可：

字段	说明	示例
Name	AI对外显示的名称	小红
Creature	角色本质定位	友善的AI助手
Vibe	语气与情绪基调	温暖、耐心、爱开玩笑
Emoji	默认风格化符号	🌸
Avatar	头像路径（绝对路径）	/root/clawd/avatars/xiaohong.png

提示：Emoji字段不单是装饰，它会自动插入每条回复末尾（除非显式禁用）；Avatar路径必须真实存在且可读，否则头像将回退为默认图标。

3.2 实操：创建专属人设“技术顾问老张”

我们以一位沉稳务实的技术顾问形象为例，逐步完成定制：

第一步：创建目录与文件

mkdir -p /root/clawd/avatars
nano /root/clawd/IDENTITY.md

第二步：填入人设定义

- Name: 老张
- Creature: 资深全栈工程师
- Vibe: 直接、务实、略带幽默感，讨厌废话
- Emoji: 
- Avatar: /root/clawd/avatars/laozhang.png

第三步：准备头像文件

将一张尺寸建议为128×128像素的PNG头像（如戴眼镜的程序员简笔画）放入指定路径：

# 假设你已将图片上传至服务器临时目录
cp /tmp/laozhang.png /root/clawd/avatars/xiaohong.png
# 注意：文件名必须与IDENTITY.md中Avatar路径一致

第四步：重启网关使配置生效

bash /root/restart-gateway.sh

验证方式：再次执行终端对话命令，观察回复是否带上``符号，并检查返回JSON中name字段是否为“老张”。

3.3 进阶技巧：动态Emoji与条件化头像

Clawdbot支持在提示词中覆盖默认Emoji。例如：

node dist/index.js agent --agent main --message "用开心的语气说‘搞定！’" --emoji ""

此时AI会输出：搞定！，而非默认的``。

同样，你也可以在代码中动态指定头像URL（适用于Web面板或API调用），但IDENTITY.md始终是全局基准。

---

4. Avatar头像配置：让AI拥有视觉面孔

头像不仅是装饰，更是建立信任感的关键触点。Clawdbot对Avatar的支持极为轻量——它不处理图像压缩或格式转换，只做一件事：在消息元数据中标记头像路径，由前端（微信/Telegram/网页面板）负责渲染。

4.1 头像文件要求

• 格式：仅支持.png（推荐）或.jpg
• 尺寸：建议128×128像素（过大会拖慢加载，过小则模糊）
• 路径：必须为绝对路径，且clawdbot进程用户（通常是root）有读取权限
• 命名：无特殊要求，但建议语义化（如xiaohong.png, robot-prod.png）

4.2 验证头像是否生效

最直接的验证方式是访问网页控制面板：

1. 浏览器打开 http://你的服务器IP:18789
2. 输入令牌 dev-test-token
3. 在对话框发送任意消息（如“测试头像”）
4. 观察左侧用户栏是否显示你设置的头像

若显示为灰色机器人图标，则检查：

• 文件路径拼写是否正确（区分大小写）
• ls -l /root/clawd/avatars/xiaohong.png 是否返回文件详情
• cat /root/.clawdbot/clawdbot.json | grep avatar 是否为空（应无此项，因头像由IDENTITY.md驱动）

4.3 多角色头像管理（可选）

你可为不同Agent配置不同头像。例如：

• /root/clawd/IDENTITY.md → 主助手“老张”，头像laozhang.png
• /root/clawd/IDENTITY-dev.md → 开发专用助手，头像dev-icon.png

只需在调用时指定Agent名：

node dist/index.js agent --agent dev --message "编译报错怎么办？"

Clawdbot会自动加载对应IDENTITY文件。

---

5. Emoji风格化输出：用符号传递情绪温度

Emoji是Clawdbot人设的“点睛之笔”。它让冷峻的技术输出瞬间拥有了呼吸感和亲和力。而Clawdbot的设计哲学是：Emoji不是随机添加，而是情绪策略的一部分。

5.1 默认Emoji机制

只要IDENTITY.md中定义了Emoji字段，Clawdbot就会在每条自然语言回复末尾自动追加该符号，且保证：

• 不破坏句子语法（始终在标点后）
• 不重复添加（即使回复本身含Emoji，也只加1次）
• 可被--emoji ""参数强制关闭

例如，当Emoji: 时：

• 输入：“今天有什么安排？”
• 输出：“我帮你规划了三件事：① 查邮件 ② 写周报 ③ 会议复盘 ”

5.2 场景化Emoji映射（手动配置）

Clawdbot不内置复杂的情绪识别，但允许你在提示词中引导AI匹配Emoji。这是更可控的方式：

node dist/index.js agent --agent main \
  --message "用鼓励的语气告诉我‘坚持就是胜利’，结尾加一个💪" \
  --emoji ""

此处--emoji ""关闭默认符号，让AI严格按指令输出💪，避免出现💪双符号。

5.3 Emoji使用避坑指南

场景	推荐做法	原因
技术文档类回复	使用 ⚙等中性符号	避免😄 ❤等过度情感化符号削弱专业感
错误提示	固定用``或❌	统一视觉信号，便于快速识别问题
成功反馈	用 ``	强化正向反馈，提升操作信心
企业微信场景	优先选用微信原生支持Emoji（如 ）	避免安卓/iOS端显示为方块

小技巧：在网页面板中，长按消息可复制纯文本（不含Emoji），方便粘贴到正式文档中。

---

6. 企业微信接入实战：打通办公最后一环

Clawdbot汉化版新增的企业微信支持，采用自建应用+消息接收API模式，无需企业认证，适合中小团队快速落地。

6.1 前置准备

1. 登录企业微信管理后台
2. 进入「应用管理」→「自建」→「创建应用」
3. 填写应用名称（如“AI技术助手”）、可见范围（建议选“全体成员”）
4. 记录下生成的：
   • CorpID（企业ID）
   • Secret（密钥）
   • AgentId（应用ID）

6.2 配置Clawdbot企业微信网关

编辑Clawdbot配置文件：

nano /root/.clawdbot/clawdbot.json

在connections节点下添加：

"wechatwork": {
  "enabled": true,
  "corp_id": "ww1234567890abcdef",
  "secret": "your_app_secret_here",
  "agent_id": 1000001,
  "token": "clawd_token_2025",
  "encoding_aes_key": "your_encoding_aes_key"
}

encoding_aes_key为32位随机字符串（可用openssl rand -base64 24生成），用于消息体加密。

6.3 启动并验证

bash /root/restart-gateway.sh

登录企业微信，在「工作台」找到刚创建的应用，点击进入。发送任意消息（如“你好”），若收到带``符号的回复，即表示接入成功。

---

7. 常见问题解决：人设与风格化专项

7.1 问题：修改IDENTITY.md后Emoji不更新

原因：Clawdbot仅在启动时读取IDENTITY.md，运行中修改需重启网关。
解决：执行bash /root/restart-gateway.sh，勿仅重启agent进程。

7.2 问题：头像在微信显示为链接而非图片

原因：企业微信要求头像URL必须为HTTPS且可公开访问。
解决：将头像上传至图床（如SM.MS），在IDENTITY.md中填写完整HTTPS链接：

- Avatar: https://s2.ax1x.com/2025/01/28/123456.png

7.3 问题：Emoji出现在代码块或JSON中，破坏格式

原因：默认Emoji追加逻辑作用于整个response字符串。
解决：对结构化输出禁用Emoji：

# JSON输出（自动关闭Emoji）
node dist/index.js agent --agent main --message "列出Python常用库" --json

# 代码块输出（手动关闭）
node dist/index.js agent --agent main --message "写一个冒泡排序" --emoji ""

7.4 问题：多人使用同一Clawdbot，人设混淆

原因：IDENTITY.md是全局配置，所有会话共享。
解决：启用会话级人设（需v2.3+版本）：

# 为特定用户ID绑定人设
node dist/index.js config set agents.main.personas.user_123456.name "小王"
node dist/index.js config set agents.main.personas.user_123456.emoji ""

其中user_123456为企业微信成员UserID或Telegram ChatID。

---

8. 总结：你已掌握AI助手的“人格铸造术”

到此，你已完成Clawdbot汉化版最富创造性的部分：不再把AI当作工具，而是作为可定义、可信赖、有温度的数字伙伴。

回顾关键动作：

• 通过IDENTITY.md赋予AI姓名、身份、语气与默认Emoji
• 用真实头像文件建立视觉信任，支持多角色灵活切换
• 掌握Emoji的默认机制与手动覆盖技巧，让表达更精准
• 成功接入企业微信，让AI走进日常办公流

下一步，你可以尝试：

• 用--thinking high让“老张”为你设计数据库表结构
• 将aideep快捷命令绑定到企业微信关键词（如“深度分析”）
• 为客服场景创建IDENTITY-customer.md，搭配📞Emoji

真正的AI生产力，始于你敢于定义它“是谁”。

---

获取更多AI镜像

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