自定义 AI 人设与身份配置

给你的龙虾一个灵魂

OpenClaw 不只是一个冰冷的工具——你可以给它取名字、设性格、定语气，让它成为一个有个性的 AI 伙伴。社区里有人叫它 Jarvis，有人叫它小虾，还有人给它设定了"毒舌但靠谱的极客朋友"的人设。

基础身份配置

在 ~/.openclaw/openclaw.json 中设置：

{
  agents: {
    list: [{
      id: "main",
      identity: {
        name: "小龙虾",           // AI 的名字
        theme: "热心的技术极客",   // 性格描述
        emoji: "🦞",             // 代表表情（用于消息回应）
        avatar: "avatars/lobster.png"  // 头像路径
      }
    }]
  }
}

系统会自动从 emoji 推导消息回应表情，从 name 推导聊天平台中的 @提及关键词。

时区和时间格式

{
  agents: {
    defaults: {
      userTimezone: "Asia/Shanghai",  // 时区（影响系统提示词，非消息时间戳）
      timeFormat: "24"                // 时间格式：auto | 12 | 24
    }
  }
}

思考模式

控制 AI 的推理深度：

{
  agents: {
    defaults: {
      thinkingDefault: "medium"  // off | low | medium | high
    }
  }
}

off：直接回答，速度最快
low：简单思考，适合日常对话
medium：中等推理，平衡速度和质量
high：深度推理，适合复杂编程和分析任务

多角色配置

你可以为不同场景创建不同的 AI 角色：

{
  agents: {
    list: [
      {
        id: "main",
        identity: { name: "小虾", theme: "轻松幽默的日常助手" }
      },
      {
        id: "coder",
        identity: { name: "Code虾", theme: "严谨的高级工程师" },
        thinkingDefault: "high"
      }
    ]
  }
}

提示

theme 字段会被注入到系统提示词中，直接影响 AI 的回复风格
修改 identity 后重载配置即可生效：openclaw gateway reload
头像文件放在 ~/.openclaw/ 目录下