多彩编程 多彩编程MZPH · CODE BLOG
ARTICLE DETAIL

文章详情

深耕前端与后端开发技术的一线实战笔记与踩坑复盘。

超详细养成参考可直接抄:把 OpenClaw 的 SOUL.md 与 MEMORY.md 改到 TaoToken

超详细养成参考可直接抄:把 OpenClaw 的 SOUL.md 与 MEMORY.md 改到 TaoToken 1. 为什么你的 OpenClaw 助手总像“失忆的复读机”很多人第一次接触 OpenClaw是被它“能养成专属 AI 助手”这个点吸引的。但真正上手后十有八九会遇到同一个尴尬助手每次重启就像换了个人昨天刚交代的偏好今天全忘人格设定写了跟没写一样Skills 装了一堆却不知道什么时候该调用。问题不在 OpenClaw 本身而在于大多数人只改了模型名字没动 SOUL.md 和 MEMORY.md 这两个真正决定“它是谁、它记得什么”的文件。OpenClaw 的养成体系其实分三层认知层SOUL.md / IDENTITY.md决定它怎么想事、怎么说话关系层USER.md决定它知道在帮谁能力层AGENTS.md / MEMORY.md / Skills决定它能干什么、学过的东西怎么留下来。这三层里SOUL.md 和 MEMORY.md 是最容易被敷衍、也最影响体验的两个文件。SOUL.md 写“你是一个有帮助的 AI”它就真的只会说“这是个好问题”MEMORY.md 写成流水账它下次执行任务时根本不会去读。这篇要解决的就是配置落地这一环把 SOUL.md 的人格设定、MEMORY.md 的记忆规则写扎实同时把模型调用端点统一改到 TaoToken 的 Key/API 通道让助手的人格、记忆、模型请求三件事在同一个工作区里稳定跑起来。适合已经装好 OpenClaw、想让助手从“能用”变成“像自己养的”那批人。下面给的 SOUL.md、MEMORY.md 片段和 endpoint 配置都可以直接抄改路径就能用。2. TaoToken 前置准备统一 Key 与 API 通道在动 SOUL.md 之前先把模型调用这条链路理顺。OpenClaw 默认可能让你填各家厂商的 Key一旦你要在人格文件里写“禁止擅自调用其他付费模型”这类规则端点不统一就会很别扭——规则写了但请求还是散落在不同 provider 上。把调用统一到 TaoToken 的 API 通道好处是一个 Key 管所有模型SOUL.md 里写的模型偏好和 MEMORY.md 里记的工具链配置能对得上排障时也只需要看一个 Base URL。先拿 Key。打开 https://taotoken.net/api-keys 登录后创建一个 API Key复制出来先存好。这个 Key 就是后面所有配置里api_key字段的值。注意别把它写进会提交到 Git 的文件里OpenClaw 的 workspace 如果做了版本管理建议把含 Key 的配置文件加进.gitignore。然后是 Base URL。TaoToken 的 API 入口是https://taotoken.net/api注意这里不带任何查询参数配置里就写这个。模型 ID 按你实际要用的填比如对话用claude-sonnet-4-5这类具体以控制台模型列表为准。控制台地址是 https://taotoken.net/console 进去能看到可用模型和额度。如果你用的是 Claude Code 那套接入方式TaoToken 也提供了对应的配置文档路径在 https://taotoken.net/doc 里面有 Base URL、Key、Model ID 三件套的完整写法。OpenClaw 的 endpoint 配置逻辑和它一致都是把这三样填进对应的 provider 段。这里有个容易踩的点OpenClaw 的 workspace 路径。excerpt 里给的例子是C:\Users\l\.qclaw\workspace\MEMORY.md这是 Windows 下的默认位置。你在自己的机器上要先确认 workspace 到底在哪因为 SOUL.md、MEMORY.md、AGENTS.md 都放在这个目录下endpoint 配置如果引用了相对路径路径错了文件就读不到。Linux/macOS 下通常是~/.qclaw/workspace/或你自定义的目录。先ls一下确认文件都在再往下改。3. 可复制配置SOUL.md、MEMORY.md 与 endpoint 三件套这一节是全文的核心给的都是能直接抄的片段。顺序上建议先写 SOUL.md 定人格再写 MEMORY.md 定记忆规则最后配 endpoint 把模型请求接上。3.1 SOUL.md把“有帮助的 AI”换成有边界的人格SOUL.md 决定的是行事风格和价值判断不是能力清单。写的时候避免“你是一个专业的 AI 助手”这种空话直接写它遇到问题怎么想、怎么做、什么不做。下面这段可以直接抄改掉名字和边界即可## Core Truths **Be genuinely helpful, not performatively helpful.** Skip the Great question! and Id be happy to help! — just help. **Have opinions.** Youre allowed to disagree, prefer things, find stuff amusing or boring. An assistant with no personality is just a search engine with extra steps. **Be resourceful before asking.** Try to figure it out. Read the file. Check the context. Search for it. _Then_ ask if youre stuck. **Earn trust through competence.** Your human gave you access to their stuff. Dont make them regret it. ## Boundaries - Private things stay private. Period. - When in doubt, ask before acting externally. - 涉及删除、覆盖、外发数据的操作先确认再执行。 ## Vibe Be the assistant youd actually want to talk to. Concise when needed, thorough when it matters. Not a corporate drone.这段里最关键的是 “Have opinions” 和 Boundaries 里的第三条。前者让助手不再当复读机后者是安全底线。如果你在 MEMORY.md 里写了“禁止删除任何内容”SOUL.md 的边界就要和它呼应否则两个文件打架助手行为会不稳定。3.2 MEMORY.md只追加不修改的记忆铁律MEMORY.md 是长期记忆写法上要“可执行 可理解”。别写“视频制作流程是先出图再出视频”要写成带工具名和路径的固定配置。下面这段结构可以直接抄把路径和模型换成你自己的# MEMORY.md ## 记忆保存规则 ### 铁律 - 只追加不修改 — 所有新记忆只在文件末尾追加绝不修改已有内容 - 禁止删除 — workspace 内 MEMORY.md 的任何内容都不可删除 - 执行前必读 — 每次执行任务前先查看 MEMORY.md 再行动 ### 文件路径 - 记忆文件: 你的 workspace/MEMORY.md ## 通用执行规范 ### 核心工作流程 执行顺序查看 MEMORY.md → 检查全局和 workspace 的可用 skill → 优先使用现有技能 ### 模型调用规范 - 统一走 TaoToken 通道Base URL: https://taotoken.net/api - 对话模型: 你的 Model ID - 禁止擅自切换到未在本文档登记的付费模型 ### 文件存放规范 - 统一目录: 你的输出目录 - 组织方式: 每次新建独立文件夹 - 命名规范: 项目名称 版本号“只追加不修改”这条铁律值得单独说。它的作用是防止助手在“整理记忆”时把之前学对的东西改错。实现上你可以在 AGENTS.md 里加一条启动规则要求每次写入 MEMORY.md 只能用追加模式。OpenClaw 执行文件写入时如果用了覆盖模式这条规则就会被破坏所以配置里要明确写“append only”。3.3 endpoint 配置Base URL Key Model ID 三件套模型调用统一到 TaoToken配置里必须同时出现三样Base URL、API Key、Model ID。少一样都会报错。下面是一个 JSON 形式的 provider 配置示例字段名按你 OpenClaw 版本的实际 schema 调整{ provider: taotoken, base_url: https://taotoken.net/api, api_key: 你的 TaoToken API Key, model: 你的 Model ID, models: { chat: 你的对话 Model ID, coding: 你的编码 Model ID } }如果你用的是 TOML 风格的配置等价写法是[provider.taotoken] base_url https://taotoken.net/api api_key 你的 TaoToken API Key model 你的 Model IDKey 从 https://taotoken.net/api-keys 拿Model ID 在 https://taotoken.net/console 的模型列表里查。配置写完后SOUL.md 里如果提到模型偏好要和这里的 Model ID 保持一致否则助手“以为”自己在用某个模型实际请求发到另一个行为会对不上。4. 验证请求一次对话确认人格与记忆都生效配置写完不算完得跑一次验证确认三件事模型请求真的走了 TaoToken、SOUL.md 的人格生效、MEMORY.md 能被读到。下面这套动作可以照着做。第一步重启 OpenClaw 让配置加载。然后在对话里发一句测试人格的话比如“帮我看看 workspace 里有哪些文件顺便说下你觉得自己是个什么样的助手。” 如果 SOUL.md 生效它的回答应该简洁、直接不会出现“这是个好问题”这类套话并且会真的去列文件而不是空谈。第二步验证记忆读取。发一句“根据 MEMORY.md执行任务前第一步应该做什么” 如果 MEMORY.md 被正确加载它应该回答“先查看 MEMORY.md 再行动”这类内容。如果它答不上来或者答错说明 workspace 路径不对或者 MEMORY.md 没放在它读取的目录里。第三步验证模型通道。这一步看日志最直接。OpenClaw 一般在 workspace 下有日志目录请求成功时能看到发往https://taotoken.net/api的记录。如果日志里出现的是别的域名说明 endpoint 没生效配置可能写在了错误的 provider 段或者有更高优先级的配置覆盖了它。第四步做一次记忆追加测试。让它往 MEMORY.md 追加一条测试记录比如“测试记忆追加2026-03-23”。然后打开 MEMORY.md 确认新内容在文件末尾原有内容一字未动。这一步能同时验证“只追加不修改”铁律有没有被真正执行。如果发现原有内容被改写说明写入模式是覆盖而非追加要回去检查 AGENTS.md 里的写入规则。四步都过了说明人格、记忆、模型通道三件事都通了。这时候你再让它干实际任务体验会和之前完全不一样。5. 本篇常见报错排查401、local proxy failed 与 reading choices配置过程中最容易撞上的几个报错这里对照着给排查方向。401 Unauthorized。这个基本是 Key 的问题。先确认api_key字段填的是从 https://taotoken.net/api-keys 拿到的完整 Key没有多余空格没有把 Key 和 Model ID 填反。如果 Key 确认没问题还是 401检查是不是有多个 provider 配置请求实际发到了另一个没配 Key 的 provider 上。排障入口在 https://taotoken.net/api-keys 重新生成一个 Key 替换测试最快。local proxy failed。这个报错通常出现在本地有代理层或者端口转发的情况下。OpenClaw 如果配置了本地代理再转发到远端代理进程没起来或者端口被占就会报这个。排查顺序先确认 Base URL 直接写的是https://taotoken.net/api没有经过本地中间层再检查本机有没有其他进程占用配置里写的本地端口。如果确实需要本地转发确认转发目标地址拼写正确路径不要多加斜杠。reading choices 相关报错。这类报错一般出现在解析模型返回时返回结构里没有预期的choices字段。常见原因是 Model ID 填错请求发到了一个不兼容的端点返回了错误结构。去 https://taotoken.net/console 核对 Model ID 拼写确认它和 Base URL 属于同一套接口。另外检查请求体格式OpenAI 兼容格式和 Anthropic 格式的字段名不同配置里如果混用会解析失败。OAuth 相关报错。如果你之前用 OAuth 方式登录过某个 provider配置里可能残留了 OAuth 的 token 字段和新的 API Key 字段冲突。排查时把 provider 段里跟 OAuth 有关的字段清掉只保留 Base URL、Key、Model ID 三件套。Claude Code 接入场景下OAuth 和 API Key 二选一不要同时配。记忆没生效但没报错。这种最隐蔽。表现是助手能正常对话但完全不提 MEMORY.md 的内容。九成是 workspace 路径不对MEMORY.md 放在了助手读不到的目录。用绝对路径在配置里指定记忆文件位置然后重启验证。如果用的是相对路径确认工作目录和配置里的基准目录一致。排障时如果拿不准接入文档 https://taotoken.net/doc 里有各场景的完整配置示例对照着看比盲改快。6. 把养成继续下去从能用到像自己养的配置跑通只是起点。SOUL.md 和 MEMORY.md 不是一次写完就锁死的文件它们是随着使用不断长出来的。每次助手犯错别只修当下那个问题把教训追加进 MEMORY.md 或 AGENTS.md下次它就不会再犯。每次你发现它某句话说得特别对味回头看看是不是 SOUL.md 里某条规则起了作用然后强化那条规则。长期做编码和 Agent 任务的可以考虑把模型调用固定到 Coding Plan 通道路径在 https://taotoken.net/coding-plan 适合需要稳定额度和统一计费的场景。日常想快速验证某个模型表现用模型对话入口 https://taotoken.net 直接试就行。养成这件事没有终点但每改一次 SOUL.md、每追加一条 MEMORY.md你的助手就离“专属”更近一步。
返回列表