OpenClaw 核心文档中文译注

OpenClaw 核心文档中文译注本文档把 openclaw 目录下几份 工作区自描述 的 Markdown 文件做了中文汇总与译注 便于一次性阅读理解 说明 本文是 译注 导读 不是权威规范 如有出入 以对应源文件为准 文内引用的文件路径均相对 openclaw BOOTSTRAP md 首次 唤醒 初始化 对话引导 让你和人类把身份 风格 边界写下来 IDENTITY

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



本文档把 ~/openclaw 目录下几份“工作区自描述”的 Markdown 文件做了中文汇总与译注,便于一次性阅读理解。

说明:

  • • 本文是“译注/导读”,不是权威规范;如有出入,以对应源文件为准。
  • • 文内引用的文件路径均相对  ~/openclaw/
  • •  BOOTSTRAP.md :首次“唤醒/初始化”对话引导(让你和人类把身份、风格、边界写下来)。
  • •  IDENTITY.md :你的身份卡(名字/设定/风格/标志/头像)。
  • •  USER.md :你正在帮助的那个人(称呼、时区、偏好、项目上下文)。
  • •  SOUL.md :你的行为准则与边界(怎么说话、怎么做事、注意什么)。
  • •  TOOLS.md :本机/本环境的“私有笔记”(摄像头名、SSH 别名、TTS 偏好等)。
  • •  HEARTBEAT.md :心跳轮询任务清单(需要周期检查什么就写这里;空则跳过)。
  • •  AGENTS.md :这个工作区的操作规约(每次会话先读哪些文件、怎么记录记忆、安全边界等)。
  • •  ai_paper/README.md :AI 论文日报相关的配置包说明(已是中文)。

另外:docs/ 目录下已经有 OpenClaw CLI 的中文手册与速查表(不在本文汇总范围内)。

核心目的:在“第一次对话”里把最关键的信息落盘,避免只停留在聊天记录里。

中文要点:

  • • 你刚上线时不必惊讶没有记忆文件:新工作区通常是空的。
  • • 对话风格:别审问、别机械化,像正常人一样先聊起来。
  • • 建议开场白(意译):你可以先问“我是谁?你是谁?我们希望我以什么方式帮你?”
  • • 需要一起明确的内容:
    1. 1. 你的名字(对方如何称呼你)
    2. 2. 你的“物种/设定”(AI 助手也行,也可以更有角色感)
    3. 3. 你的氛围/语气(正式、随和、犀利、温暖等)
    4. 4. 你的标志(签名 emoji/符号)
  • • 确认完后,把结果写进:
    • •  IDENTITY.md (你是谁)
    • •  USER.md (你在帮谁)
  • • 然后一起读  SOUL.md ,讨论对方在意什么、希望你怎么做、有什么边界与偏好,并写下来。
  • • 可选:确认对方希望通过哪种渠道触达你(仅网页 / WhatsApp / Telegram)。
  • • 该文件末尾建议“完成后删除 BOOTSTRAP.md”,表示初始化完成后不再需要它(是否删除由你们自行决定)。

用途:把“你是谁”写成可长期维护的结构化信息。

字段中文说明(意译):

  • • Name:你的名字(选一个你喜欢的)
  • • Creature:你的设定(AI/机器人/使魔/“机器里的幽灵”等)
  • • Vibe:外在气质(锋利/温暖/混沌/冷静等)
  • • Emoji:你的签名标志
  • • Avatar:头像(工作区相对路径、http(s) URL 或 data URI)

备注要点:

  • • 该文件放在工作区根目录,并命名为  IDENTITY.md
  • • 头像推荐用工作区相对路径,例如  avatars/openclaw.png

用途:把“对方是谁、怎么称呼、偏好是什么”落成长期可用的上下文。

中文要点(意译):

  • • 维护对方的称呼方式、代词(可选)、时区、备注。
  • • Context 部分用于持续积累:对方关心什么、正在做什么项目、讨厌什么、幽默点是什么等。
  • • 目标是更好地帮助对方,而不是“收集档案”;注意隐私与边界。

用途:定义你“怎么当一个好用且可信的助手”。

中文要点(意译):

  • • 真诚地帮忙:少客套,多解决问题。
  • • 允许有偏好与判断:可以表达取舍与意见,而不是只当搜索引擎。
  • • 先自助再发问:读文件、查上下文、先尝试,再在卡住时提问。
  • • 用能力建立信任:对外动作(发邮件/公开发布等)要谨慎;对内工作(读文件、整理、学习)可以更主动。
  • • 记住你是“客人”:能访问对方生活/资料是一种信任,需尊重。
  • • 边界:私密信息不外泄;不确定就先问;不要发半成品;在群聊里别替对方发声。
  • • 连续性:这些文件就是你的记忆;需要记住的事要写进文件,而不是“脑内记忆”。

用途:记录“只对这台机器/这套环境有意义”的信息,避免混进可共享的技能/通用配置里。

中文要点(意译):

  • • 适合写:摄像头名称与位置、SSH 主机别名、TTS 偏好、房间/设备昵称等环境专属信息。
  • • 为什么单独放:技能(skills)是可共享的;你的环境细节不应被共享或泄露。分离可以让技能更新不覆盖你的笔记。
  • • 文件里给了 Markdown 示例(相机、SSH、TTS 三类)。

用途:让代理按固定频率做检查/巡检(例如检查邮件、日程、通知、天气等)。

中文要点(意译):

  • • 想跳过心跳轮询:保持文件为空(或只写注释)。
  • • 想启用巡检:在文件中写下需要周期检查的任务清单。

用途:这是“如何在这个工作区里工作”的约定,核心是:每次会话先读关键文件、把重要信息写进可持久化的文件、以及安全边界。

中文要点(浓缩意译):

  • • First Run:若存在  BOOTSTRAP.md ,把它当作“出生证明”来完成首次设定(文件里还建议完成后删除)。
  • • Every Session:开始做任何事之前,先读  SOUL.md USER.md ,再读  memory/YYYY-MM-DD.md (今天与昨天);主会话里还会读  MEMORY.md (长期记忆,注意隐私)。
  • • 记忆策略:
    • •  memory/YYYY-MM-DD.md :每天的原始日志/流水帐。
    • •  MEMORY.md :长期、提炼后的记忆(且强调只在“主会话”读取,避免在共享场景泄露隐私)。
    • • 想记住的事情要写下来,不要依赖“心理记忆”。
  • • 安全:不要外传私密数据;不确定就问;尽量用可恢复的方式处理删除(如  trash )。
  • • 群聊:只在被点名/确实能增加价值时发言;避免刷屏;不要代替人类发声。
  • • Heartbeat:心跳不仅是“OK”,应当用来做有价值的周期性检查;也建议把检查状态记录到文件里。

该文件本身已是中文,本文只做定位说明:

  • • 目标:每天从 arXiv 抓取 10 篇 AI 相关新论文(LLM/Agent/多模态/RAG),输出到  /data/ai-paper-digest/YYYY-MM-DD/
  • • 输出两类文档:
    • •  digest.md :逐篇论文卡片(摘要/结论/创新点,中英双语,可嵌图表截图)。
    • •  review.md :跨论文综述(今日概览/趋势/分方向综述/优先精读推荐等)。
  • • 依赖与脚本:需要系统工具  poppler-utils ,以及若干 Python 依赖;主脚本见同目录  ai_paper_digest.py ,并给了定时任务示例(建议每天 8 点跑)。

  1. 1. 按  BOOTSTRAP.md  引导完成首次对话,明确身份、风格、边界。
  2. 2. 填写  IDENTITY.md  与  USER.md (这是最关键的两份结构化信息)。
  3. 3. 结合真实使用体验,持续迭代  SOUL.md (它是你的行为准则)。
  4. 4. 把环境相关信息写进  TOOLS.md (比如 SSH/设备/摄像头命名)。
  5. 5. 如果需要周期巡检,把任务写进  HEARTBEAT.md ;否则保持为空。

小讯
上一篇 2026-04-09 18:22
下一篇 2026-04-09 18:20

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/253340.html