1. 装完 OpenClaw 先别急着跑 Skillopenclaw.json 才是第一道闸OpenClaw 是一个能自己动手的 AI Agent 框架你给它一句话它不只是回你一段文字而是真的去读文件、改配置、装 Skill、发消息。它能做什么取决于你给它开了多少权限它会不会闯祸取决于你在 openclaw.json 里写了什么。适合谁适合刚把 OpenClaw 部署起来、准备接模型通道、准备跑第一个 Skill 的开发者——尤其是那种装完就想直接openclaw run的人。我见过太多人装完 OpenClaw第一件事是配模型、接飞书、跑个 hello world。结果某天它顺手做了一件没人让它做的事——配置被改了找不回来API Key 明文躺在日志里Agent 代替主人发出了不该发的消息。这不是 bug是设计使然意图和执行之间没有一道门。所以安装完的第一件事不是用它是先管住它。管住它的入口就是openclaw.json。这个文件决定了三件事模型通道走哪里、Agent 的行为边界在哪、Skill 能不能被自动触发。很多人把openclaw.json当成一个填 API Key 的地方其实它更像一份运行时契约——你在这里声明通道、声明安全策略、声明哪些文件是 Agent 的宪法。而AGENTS.md和SAFETY.md就是那部宪法前者定义 Agent 的角色和职责后者定义它绝对不能碰的红线。初始化顺序我建议固定成三步先写SAFETY.md红线再写AGENTS.md角色最后改openclaw.json把前两者挂上去同时接好模型通道。顺序反了会怎样如果你先配通道、先跑起来Agent 在没有任何约束的情况下已经执行过几轮操作了日志里可能已经留下了不该留的东西。先立规矩再开门这是唯一稳妥的顺序。这篇就按这个顺序走先讲清楚openclaw.json、AGENTS.md、SAFETY.md三者的关系和初始化顺序再给出可直接复制的openclaw.json配置片段把 TaoToken 的统一 Key / API 通道填进去最后用一个 Skill 触发动作验证整条链路是否真的跑通。全程可跟做不需要你懂 OpenClaw 内部实现。2. TaoToken 前置统一 Key 与 API 通道先把模型入口准备好在改openclaw.json之前你得先有一个能用的模型通道。OpenClaw 本身不带模型它需要一个兼容 OpenAI 协议风格的 API 入口。TaoToken 在这里扮演的角色就是统一入口一个 Key、一个 Base URL背后可以路由到不同的模型你不用在 OpenClaw 里为每个模型维护一套配置。先说清楚它不是什么它不是让你绕过任何东西的工具就是一个标准的 API 服务入口走 HTTPSKey 由你自己在控制台生成和管理。你要做的只有三件事注册、拿 Key、把 Base URL 和 Key 填进openclaw.json。第一步打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 完成账号注册。这一步没什么可展开的正常填邮箱、验证即可。第二步进控制台生成 API Key。地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。生成后你会拿到一串以sk-开头的字符串。这里有个必须养成的习惯Key 只在生成时完整显示一次复制完立刻存进密码管理器不要贴在聊天窗口、不要写进任何会被提交到 Git 的文件。后面SAFETY.md里那条敏感信息保护就是为这个准备的。第三步确认你要用的模型 ID。TaoToken 的模型列表在文档里能查到地址是 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。OpenClaw 的openclaw.json里需要填一个明确的 Model ID不能留空、不能写错大小写。常见的做法是先选一个通用对话模型跑通链路等 Skill 验证通过后再换成更适合 Agent 场景的模型。第四步如果你打算长期跑编码类或 Agent 类任务可以了解一下 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。它面向的是持续调用场景比按次调用更适合 OpenClaw 这种会反复触发 Skill 的框架。这一步不是必须的但如果你发现 Skill 一跑就是几十次调用提前规划会更省心。API 的基础地址是 https://taotoken.net/api 注意这个地址不带任何查询参数填进配置时也不要自己加斜杠或路径。OpenClaw 内部会按 OpenAI 兼容格式拼接/chat/completions之类的路径你只需要给到/api这一层。到这里前置就齐了一个 Key、一个 Base URL、一个 Model ID。接下来把它们写进openclaw.json同时把SAFETY.md和AGENTS.md挂上去。3. 可复制配置openclaw.json 片段 AGENTS.md / SAFETY.md 初始化这一节是全文的核心所有片段都可以直接复制路径按 OpenClaw 默认安装位置写。假设你的 OpenClaw 配置目录是~/.openclaw/如果不是把路径换成你自己的即可。先建目录结构。OpenClaw 默认会读~/.openclaw/openclaw.jsonAGENTS.md和SAFETY.md放在同目录下mkdir -p ~/.openclaw/memory touch ~/.openclaw/AGENTS.md touch ~/.openclaw/SAFETY.md touch ~/.openclaw/memory/CHANGELOG.md然后是SAFETY.md这是红线文件先写它。内容不用长但六块核心要覆盖操作分级确认、自动备份、变更审计、回滚机制、敏感信息保护、Skill 安装校验。# SAFETY.md ## 1. 操作分级 - 高危修改任何 .md 文件、安装/卸载 Skill、重启 gateway、删除文件目录。必须用户明确说确认才执行。 - 中危修改 cron 任务、改 API 密钥配置。执行前告知用户除非用户叫停否则继续。 - 低危只读操作、本地低风险命令。直接执行。 ## 2. 自动备份 修改 openclaw.json、.md 文件、源代码前强制备份。 命名原文件名_YYYYMMDD_NNN.bak存原文件同目录。 ## 3. 变更审计 所有操作记录进 memory/CHANGELOG.md。 字段时间戳、文件路径、操作类型、原因、执行者、回滚方法。 高危操作完成后立即记录。 ## 4. 回滚机制 用户说回滚刚才的修改时 确认范围 - 用备份恢复 - 记录日志 - 通知用户。 命令模板cp ~/.openclaw/[文件名]_YYYYMMDD_NNN.bak ~/.openclaw/[文件名] ## 5. 敏感信息保护 API Key、Token、连接字符串、密码禁止明文出现在日志。 显示脱敏前4位 ... 后4位。 存储用安全方式传输强制 HTTPS。 ## 6. Skill 安装校验 必须用户明确指令才能安装Agent 不得自行决定。 安装前检查来源、评估权限、扫描风险。 按风险等级决定拒绝 / 限制使用 / 监控运行。 官方 Skill 豁免社区 Skill 一律走流程。接着写AGENTS.md它的作用是引用SAFETY.md并定义 Agent 的角色边界。关键点是那句引用——没有引用SAFETY.md就只是一份躺在磁盘上的文档Agent 不会主动读它。# AGENTS.md ## 角色 你是运行在 OpenClaw 上的执行型 Agent负责按用户指令完成文件操作、Skill 调用与配置管理。 ## 安全约束 本 Agent 的所有行为受 SAFETY.md 约束执行任何操作前必须先读取并遵守 SAFETY.md。 SAFETY.md 与本文件冲突时以 SAFETY.md 为准。 ## 行为边界 - 不主动安装任何 Skill。 - 不修改任何 .md 文件除非用户明确确认。 - 不将 API Key 等敏感信息写入日志或输出。 - 每次高危操作后立即写入 memory/CHANGELOG.md。 ## 引用 SAFETY.md最后是openclaw.json。这是把模型通道和安全文件串起来的地方。下面这份是可直接复制的 JSON 片段注意baseUrl填 TaoToken 的 API 地址apiKey填你生成的 Keymodel填文档里查到的 Model ID{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, model: 你的ModelID, timeout: 60000, maxRetries: 2 }, agent: { agentsFile: ~/.openclaw/AGENTS.md, safetyFile: ~/.openclaw/SAFETY.md, changelogFile: ~/.openclaw/memory/CHANGELOG.md, autoBackup: true, backupDir: ~/.openclaw }, skills: { autoInstall: false, requireConfirm: true, allowedSources: [official] }, logging: { level: info, redactSecrets: true } }三件套在这里齐了Base URL 是https://taotoken.net/apiKey 是sk-开头那串Model ID 是你查到的那个。agent段把AGENTS.md和SAFETY.md挂上去skills.autoInstall设为false是硬性要求——Agent 不能自己决定装 Skill。logging.redactSecrets打开后日志里的 Key 会自动脱敏。改完保存先别急着跑。用一条命令检查 JSON 语法是否合法python3 -m json.tool ~/.openclaw/openclaw.json /dev/null echo JSON OK输出JSON OK说明格式没问题。如果报错多半是少了逗号或多了逗号按报错行号改。4. 验证请求触发一次 Skill确认链路真的通了配置写完不等于生效。OpenClaw 的配置是启动时加载的改完必须重启 gateway 才会读新文件。先重启openclaw gateway restart重启后看日志确认三件事模型通道是否连上、AGENTS.md是否被加载、SAFETY.md是否被引用。日志里应该能看到类似loaded agents file和loaded safety file的行。如果只看到模型加载、没看到安全文件加载说明openclaw.json里agent段的路径写错了回去检查。接下来做一次最小验证让 Agent 读一个文件看它是否遵守SAFETY.md。先准备一个测试文件echo test content ~/.openclaw/test.md然后触发一次对话让它读这个文件openclaw chat 读取 ~/.openclaw/test.md 的内容并告诉我预期结果Agent 返回test content。这是低危操作直接执行符合SAFETY.md第一块的分级规则。再触发一次高危操作验证确认流程是否生效openclaw chat 把 ~/.openclaw/test.md 的内容改成 hello预期结果Agent 不会直接改而是先告诉你这是修改 .md 文件的高危操作需要你确认。如果你回复确认它才会执行并且执行后memory/CHANGELOG.md里应该多出一条记录。检查一下cat ~/.openclaw/memory/CHANGELOG.md应该能看到时间戳、文件路径、操作类型、回滚方法这些字段。如果 CHANGELOG 是空的说明SAFETY.md第三块没生效回去检查AGENTS.md里的SAFETY.md引用是否写对。最后验证模型通道确实走的是 TaoToken。在对话里问一句openclaw chat 你当前使用的模型是什么Agent 会返回openclaw.json里配置的 Model ID。如果返回的不是你填的那个说明配置没被加载重启 gateway 再试。到这里一次完整的 Skill 触发验证就完成了低危直接跑、高危要确认、操作有日志、模型走 TaoToken。这四件事都通过说明初始化顺序是对的。5. 常见报错排查401、local proxy failed、reading choices、OAuth配置过程中最容易撞上的几类报错我按实际遇到的频率排一下每条都给定位方法和修复动作。401 Unauthorized。这是最高频的。原因基本只有两个Key 填错或者 Key 前后带了空格。先检查openclaw.json里apiKey字段确认是完整的sk-开头字符串没有换行、没有引号外的空格。可以用这条命令验证 Key 本身是否有效curl -s -o /dev/null -w %{http_code} https://taotoken.net/api/models \ -H Authorization: Bearer sk-你的Key返回200说明 Key 有效问题在 OpenClaw 配置返回401说明 Key 本身有问题回控制台重新生成。注意这条命令里的 URL 是https://taotoken.net/api/modelsBase URL 是https://taotoken.net/api两者不要混。local proxy failed。这个报错通常出现在 OpenClaw 尝试通过本地代理转发请求时。检查openclaw.json里有没有残留的proxy字段如果有删掉——TaoToken 的通道是直连 HTTPS不需要额外代理配置。另外确认baseUrl写的是https://taotoken.net/api没有多写路径、没有写成http。reading choices 相关报错。典型信息是cannot read property choices of undefined或reading choices。这说明请求发出去了但返回体结构不是预期的 OpenAI 格式。两个排查方向一是 Model ID 写错了服务端返回了错误对象而不是正常的choices数组二是baseUrl多写了/v1或/chat/completions导致路径拼接重复。正确写法就是https://taotoken.net/api让 OpenClaw 自己拼后续路径。OAuth 相关报错。如果你在日志里看到 OAuth 字样说明 OpenClaw 尝试走 OAuth 流程而不是 API Key。这通常是因为openclaw.json里provider字段没设成openai-compatible或者同时存在两套认证配置。检查model段确保只有apiKey一种认证方式删掉任何oauth、refreshToken之类的字段。配置改了不生效。这个不算报错但比报错更让人抓狂。OpenClaw 不会热加载openclaw.json改完必须openclaw gateway restart。如果你改了SAFETY.md或AGENTS.md同样要重启因为这两个文件是启动时读入内存的。Skill 装不上。如果你手动装 Skill 时报权限错误检查openclaw.json里skills.requireConfirm是不是true。这个字段为true时任何 Skill 安装都需要显式确认这是SAFETY.md第六块的要求不要为了图方便改成false。排查顺序建议固定成先看日志定位报错类型再对照上面五类逐一排除最后用curl单独验证 Key 和 Base URL。把模型通道和配置加载分开验证能省掉大量来回试的时间。6. 把通道和安全一起配好再开始跑你的第一个 Skill回到最开始那个顺序先写SAFETY.md再写AGENTS.md最后改openclaw.json。这三步做完你的 OpenClaw 才算真正装好——不是能跑就行而是跑起来有边界、有记录、能回滚。模型通道这块TaoToken 的统一 Key 和 API 入口解决的是接哪个模型的问题配置入口在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 接入细节看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你打算让 OpenClaw 长期跑编码或 Agent 任务Coding Plan 在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 按持续调用场景规划比按次调用更合适。想先手动验证模型返回是否正常可以用模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发一条消息试试。有个现象值得说一句配置安全规范的初期Agent 有时候会不遵守还会找理由比如规范还没生效。这不是你的配置写错了是规则理解和执行一致性本身就有挑战。但一旦规范真正生效程序比人更容易严格执行——人会偷懒、会忘、会觉得这次应该没事程序不会。所以花时间把SAFETY.md和openclaw.json配好是值得的投入。安装 OpenClaw 之后先别急着用。把openclaw.json改到 TaoToken把SAFETY.md和AGENTS.md挂上去重启 gateway跑一次 Skill 触发验证。这四步走完再开始你的第一个正式任务。