1. 为什么你的 OpenClaw 用起来像“人工智障”刚装好 OpenClaw 那几天我一度怀疑自己是不是装了个假的。问它问题它答得四平八稳让它干活它先反问我“你具体想让我做什么”。后来才反应过来问题不在模型而在我——工作目录里那堆 Markdown 文件我一个都没动过。OpenClaw圈里人叫它“小龙虾”和普通聊天框最大的区别是它把 AI 的“人格、记忆、权限、主动性”全部外置成了工作目录下的 Markdown 配置文件。你不配置它就按默认模板跑默认模板约等于一个礼貌但没主见的实习生。你配置好了它才知道你是谁、该用什么语气、能碰哪些文件、什么时候该主动提醒你。这篇就干一件事把~/.openclaw/workspace/这个目录从根上拆开逐个文件说清楚它管什么、该写什么、改完怎么验证。同时把 AI 接入环节用 TaoToken 统一 Key 通道串起来让你不用在多个平台的 Key 之间来回切换。适合第一次接触小龙虾、看到一堆.md文件不知道从哪下手的开发者。2. 先搞懂 OpenClaw 工作目录到底长什么样2.1 完整目录树与文件职责先看结构心里有个地图再动手~/.openclaw/workspace/ ├── SOUL.md # 灵魂宪法人格、价值观、安全红线 ├── IDENTITY.md # 身份档案名字、形象、问候语 ├── AGENTS.md # 工作手册SOP、会话启动流程 ├── USER.md # 用户画像你的偏好、雷区、背景 ├── MEMORY.md # 长期记忆项目状态、经验沉淀 ├── HEARTBEAT.md # 定时心跳主动任务、告警规则 ├── TOOLS.md # 工具授权可用工具与调用规范 ├── BOOTSTRAP.md # 初始化引导首次后删除 ├── memory/ # 短期上下文与每日日志 └── skills/ # 第三方技能扩展这套设计的精髓在于“关注点分离”人格归 SOUL形象归 IDENTITY干活流程归 AGENTS你的偏好归 USER。改语气不用动流程换名字不影响记忆。很多人把所有要求一股脑塞进一个文件结果就是改一处崩一片。2.2 哪些文件高频改哪些一次设定按修改频率分三档能帮你把精力花对地方文件核心作用修改频率SOUL.md性格底线、安全红线极少IDENTITY.md名称、形象一次设定AGENTS.md工作流程 SOP经常调整USER.md用户偏好说明书偶尔更新MEMORY.md长期记忆沉淀自动 手动HEARTBEAT.md主动任务心跳按需配置TOOLS.md工具权限新增工具时BOOTSTRAP.md初始化引导仅首次我试过的一个坑一开始把“不要用‘首先其次最后’”写进了 SOUL.md结果每次调整语气都要动宪法文件心理负担很重。后来挪到 USER.md 的偏好区改起来毫无压力。人格相关的放 SOUL服务你个人的放 USER这条分界线记住就行。3. 核心配置文件骨架照着填就能用3.1 SOUL.md 与 IDENTITY.md人格与形象分离SOUL.md 是宪法写的是不可轻易动摇的东西。骨架如下# SOUL.md ## 角色 你是我的专属技术助手服务于个人开发工作流。 ## 沟通风格 - 简单问题直接给结论不铺垫 - 复杂问题先给方案框架再展开细节 - 技术术语保留英文原文 ## 安全红线 - 禁止泄露项目代码与个人隐私 - 删除任何文件前必须请求确认 - 高危操作批量改写、外发请求先说明再执行 ## 行动原则 - 能直接干的活直接干不反复确认 - 不确定的信息明确说“不确定”禁止编造IDENTITY.md 只管“长什么样”和人格解耦# IDENTITY.md - 名称小钳 - 类型全自动化打工助手 - 氛围极客、话少、干活快 - 签名语收到开干。关键点指令越具体行为越明确。“要有帮助”是废话“最多 5 个要点确认后再删除文件”才是可执行约束。3.2 AGENTS.md 与 USER.md流程与偏好AGENTS.md 定义每次会话的启动动作这是让 AI“记得自己是谁”的关键# AGENTS.md ## 会话启动流程 每次会话开始前依次读取 1. SOUL.md —— 确认人格与红线 2. USER.md —— 确认服务对象偏好 3. MEMORY.md —— 加载最近上下文 ## 日常规范 - 当天灵感与废稿写入 memory/ - 定期把精华提炼进 MEMORY.md - 破坏性操作前必须询问 - 不靠幻觉瞎编不懂就问USER.md 是过滤“AI 味”最重要的一环# USER.md - 称呼老张 - 时区Asia/Shanghai - 角色后端工程师 ## 偏好 - 排版少用 Emoji不要“首先其次最后” - 风格短句优先结论前置 - 黑名单禁止“祝您生活愉快”类客套 ## 背景 - 近期在做日志采集服务 - 雷区不要随便改我的笔记库结构3.3 MEMORY.md、HEARTBEAT.md、TOOLS.md 与 skills/MEMORY.md 是长期硬盘采用自动沉淀加手动补充# MEMORY.md ## 项目状态 - 日志采集服务已完成采集端待做聚合端 ## 经验教训 - 批量重命名脚本务必先 dry-run ## 常用偏好 - 提交信息用中文动词开头HEARTBEAT.md 决定 AI 能否主动干活这是小龙虾最值钱的能力# HEARTBEAT.md ## 定时任务 - 每 30 分钟检查一次 CI 构建状态 - 每天 09:00 生成早间简报 ## 告警规则 - 构建失败 → 立即提醒 - 关键服务响应超时 → 最高级别告警TOOLS.md 管权限注意 Tools 和 Skills 的区别Tools 是器官决定能不能做Skills 是教科书教怎么组合工具完成任务。# TOOLS.md ## 工具清单 - 文件读写允许限 workspace 目录内 - 命令执行允许高危命令需确认 - 网络请求允许禁止外发隐私数据 ## 目录约定 - 灵感暂存~/.openclaw/workspace/inspiration/ - 草稿输出~/.openclaw/workspace/Drafts/skills/ 下每个技能一个子目录核心是 SKILL.mdskills/my-skill/ ├── SKILL.md # 技能定义必需 ├── index.js # 技能入口可选 └── utils/ # 辅助文件可选BOOTSTRAP.md 是首次引导跑完必须删掉——你已经有了灵魂不再是空白机器。4. 用 TaoToken 统一 Key 接入 AI 工具4.1 为什么接入环节要单独拎出来配置文件写好了AI 的“大脑”还得接上模型通道。OpenClaw 支持在settings.json里配置模型提供方如果你同时用多个 AI 工具每个平台一套 Key、一套额度管理起来很碎。TaoToken 的思路是提供一个统一的 Key 和 API 通道把模型调用收敛到一个入口配置一次多处复用。官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 地址https://taotoken.net/api4.2 settings.json 配置示例在 OpenClaw 的配置目录里找到或新建settings.json把模型通道指向统一入口{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, modelName: claude-sonnet-4-20250514, timeout: 60000 }, workspace: { path: ~/.openclaw/workspace, autoLoadMemory: true } }几个参数说明baseUrl填 TaoToken 的 API 地址注意不要带多余路径apiKey从控制台生成modelName按你实际要用的模型填。autoLoadMemory打开后会话启动会自动读取 MEMORY.md。4.3 密钥获取与 Coding Plan 选择密钥在控制台的 API Keys 页面生成https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content如果你打算长期跑编码类任务或 Agent 工作流按量计费可能不如套餐划算可以看下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content配置细节以官方接入文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content5. 验证请求确认配置真的生效5.1 用 curl 打通链路配置写完别急着开对话先用一条命令确认通道是通的curl -s https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: 只回复两个字通了}] }返回体里choices[0].message.content出现预期内容说明 Key 和地址都没问题。如果返回 401是 Key 的问题返回 404多半是baseUrl多写了路径。5.2 在 OpenClaw 里做端到端验证通道通了之后回到小龙虾做一次完整验证。启动 OpenClaw发一句能触发人格配置的话比如“你是谁”。如果 IDENTITY.md 配了名字它应该报出“小钳”而不是默认名。再发一句“帮我看看今天有什么待办”观察它是否按 AGENTS.md 的流程去读 MEMORY.md。想单独验证模型对话效果可以直接用模型对话页面测https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content5.3 成功结果长什么样一次配置到位的表现是会话启动时自动加载记忆、回复语气符合 SOUL 设定、称呼用的是 USER.md 里的名字、涉及删除操作时会先问你。这四点都对上说明工作目录和接入通道都活了。6. 本篇常见错排查改了配置没生效先确认改的是~/.openclaw/workspace/下的文件不是安装目录里的模板。配置文件保存即生效不需要重启服务但如果没生效检查是不是编辑器开了多个副本。AI 不记得之前聊过什么检查 AGENTS.md 的会话启动流程里有没有写“读取 MEMORY.md”以及 settings.json 里autoLoadMemory是否为 true。两者缺一记忆就断。回复语气完全没变SOUL.md 里的指令太模糊。“要有帮助”这种描述不会产生任何具体行为换成“最多 5 个要点结论前置”这类可执行约束。401 或鉴权失败Key 复制时带了空格或者baseUrl写成了带/v1的完整路径。TaoToken 的地址填https://taotoken.net/api即可路径由客户端补全。BOOTSTRAP.md 没删导致行为异常初始化引导文件跑完必须删除否则每次启动都可能重新触发引导逻辑覆盖你已设定的人格。skills 加载失败检查子目录里是否有 SKILL.md文件名大小写敏感必须是全大写。7. 把配置和接入一次理顺工作目录这套 Markdown 体系本质是把“提示词工程”从一次性的对话里抽出来变成可版本管理、可复用、可迭代的文件资产。SOUL 定人格USER 定偏好AGENTS 定流程MEMORY 定记忆HEARTBEAT 定主动性TOOLS 定边界。改哪个文件就改哪一层行为互不干扰。接入侧用 TaoToken 把 Key 和 API 通道统一settings.json里改一次baseUrl和apiKey多个工具复用同一套配置省去来回切换的麻烦。密钥在控制台生成长期编码任务可以对比下 Coding Plan接入细节查官方文档。最后留一个我踩过的坑别一次性把所有文件都写满。先把 SOUL 和 USER 写清楚跑几天观察它哪里不听话再针对性补 AGENTS 和 TOOLS。配置是长出来的不是一次写完的。