1. 项目概述这不是一篇“教程”而是一份带血丝的配置诊断报告我花了整整三天把 OpenClaw 和 Kimi Code 的认证链路从头到尾扒了三层皮——不是为了写个“五分钟上手指南”而是因为第四次看到run error: HTTP 401: Invalid Authentication的红字时手指已经悬在键盘上方三分钟没动呼吸节奏乱了咖啡凉透了连显示器右下角的时间都开始模糊。这种挫败感对买了 Kimi Code 订阅、想立刻用上 AI 编程助手、却卡死在第一步的同学来说太熟悉了。它不像传统开发错误那样有明确报错堆栈而像在黑暗里反复拧一把生锈的螺丝你明明按说明书拧了可它就是不转还发出刺耳的金属摩擦声。这篇文章就是我把那把螺丝刀、扳手、放大镜连同我指甲缝里嵌着的调试日志碎片一起摊开给你看的过程。核心关键词“技术踩坑”在这里不是修辞是物理事实——它意味着每一个 401 错误背后都对应着一个被忽略的配置层级、一个文档未明说的优先级规则、一个缓存机制的隐性锁定。而“kimi模型”和“OpenClaw”这两个词构成了这个坑的地理坐标Kimi 的 API 接口设计尤其是/coding/v1这个路径与 OpenClaw 的抽象模型层k2p5别名映射之间存在一道需要手动校准的缝隙OpenClaw 本身又不是个“改完即生效”的轻量工具它的 session 缓存、双层认证体系、模型别名解析逻辑共同织成一张细密的网。适合谁不是给纯新手讲“什么是 API Key”的人而是已经能熟练生成 Key、会改 JSON、知道 curl 基本用法却依然在 OpenClaw 启动那一刻被 401 当头一棒砸懵的实战派。你不需要从零学起你需要的是有人告诉你“停别再重启了先去删那个文件。”我写这篇记录目的很朴素帮你把这三天压缩成三十分钟。不是跳过所有步骤而是让你清楚每一步为什么必须做、不做会怎样、以及做完之后系统内部到底发生了什么变化。接下来的内容没有一句“理论上应该如此”全是我在终端里敲出来的命令、在 VS Code 里逐行比对过的 JSON、在 Wireshark 里抓到的真实请求头。它可能不够优雅但足够真实它可能不覆盖所有边缘场景但覆盖了 95% 的人卡住的那个点。2. 整体设计与思路拆解为什么 OpenClaw 的认证体系会让人反复踩坑要真正理解这四个坑不能只盯着报错信息得先看清 OpenClaw 是怎么“想问题”的。它不是一个简单的 API 转发器而是一个带有策略分层和状态记忆的智能代理框架。它的设计哲学决定了问题必然出现在“层与层之间”的缝隙里而不是某一行代码写错了。我把整个认证流拆解成三个逻辑层每个层都有自己的职责和“话语权”而坑就藏在它们交接的边界上。2.1 第一层凭证管理层auth-profiles.json—— “身份证”的唯一保管处这是最底层、也是最权威的凭证存储。你可以把它想象成公司 HR 系统里的员工档案库里面存着每个人的工号profile name、姓名provider name和身份证号API Key。OpenClaw 启动时会首先来这里查找当前要使用的 provider比如moonshot也就是 Kimi对应的 Key。它的设计原则非常清晰凭证只在此处定义且只定义一次。任何其他地方出现的 Key都是对这个单一信源的污染。为什么这样设计因为大型项目往往要对接多个模型提供商OpenAI、Anthropic、Kimi、Ollama如果每个模型配置文件里都硬编码 Key一旦 Key 轮换就得改十几二十个文件极易出错且无法审计。所以 auth-profiles.json 是唯一的“真相源”。2.2 第二层模型抽象层models.json—— “车型手册”与“真实发动机”的映射表这一层负责定义“我能用什么车”。它不关心你的身份证号是多少只关心这辆车的型号id、品牌name、油箱多大contextWindow、最高时速maxTokens、支持什么功能input: [text, image]。关键点在于这里的id比如k2p5不是API 接口返回的真实 model idkimi-for-coding而是 OpenClaw 内部为简化配置而创建的一个逻辑别名。就像你买车时说“我要一辆 Model Y”销售不会跟你讨论特斯拉工厂里的具体 VIN 码他直接调用内部系统把Model Y映射到真实的生产批次和配置。OpenClaw 也一样当你在配置里写kimi-coding/k2p5它会在运行时查表把这个别名翻译成https://api.kimi.com/coding/v1这个 baseUrl 和kimi-for-coding这个真实 model id。所以models.json 的核心任务是“描述能力”而不是“提供凭证”或“指定地址”。2.3 第三层运行时会话层sessions.json—— “已启动车辆”的状态快照这是最容易被忽视、却最致命的一层。当 OpenClaw 成功启动一个 agent比如main它会把此刻所有生效的配置——包括从哪读的 Key、用了哪个 model id、baseUrl 是什么——全部序列化存进~/.openclaw/agents/main/sessions/sessions.json这个文件里。这相当于给那辆已经发动的 Model Y 拍了一张“当前状态快照”方向盘打到了多少度、空调设定在几度、导航目的地设在哪。下次启动时OpenClaw 默认会优先加载这张快照而不是重新解析所有 JSON 文件。这是为了提升启动速度但代价是如果你改了 models.json 或 auth-profiles.json而没清理这张快照系统就会固执地认为“我昨天就是这么跑的今天当然还这么跑”完全无视你的新配置。这就是为什么你改了十遍配置重启十次状态栏还是显示moonshot/kimi-k2.5——它根本没去看你改的新文件它在读自己硬盘里存的老照片。这三层的关系可以用一个生活化类比来理解你要去银行办业务启动 OpenClaw。第一层 auth-profiles.json 是你的身份证原件放在家里保险柜唯一可信源第二层 models.json 是你的手机银行 App它知道“建行储蓄卡”这个名称但不知道你卡号后四位是多少它只负责告诉你这个 App 支持哪些功能转账、理财第三层 sessions.json 是你昨天在 ATM 机上插卡后机器自动保存的“上次操作记录”。今天你换了新身份证更新了 KeyApp 也升级了修改了 models.json但如果你没告诉 ATM 机“请清空上次记录”它还是会按老记录操作结果当然是“证件无效”。3. 核心细节解析与实操要点四个坑的深度解剖与防御性配置现在我们把目光聚焦到那四个让人心力交瘁的具体坑上。每一个坑都不是孤立的 bug而是上述三层架构中某个环节的“预期外行为”在现实中的具象化。我会逐个拆解不仅告诉你“怎么做”更告诉你“为什么必须这么做”以及如何通过配置习惯从根本上杜绝它再次发生。3.1 坑一models.json 中硬编码 apiKey —— 对“单一信源”原则的彻底背叛现象复现与危害分析你在 models.json 的kimi-coding配置块里赫然写着apiKey: sk-kimi-p9KN...。这行代码看似无害甚至像是“方便快捷”的捷径。但它在 OpenClaw 的认证流程中扮演了一个极其危险的角色它是一个高优先级的覆盖指令。当 OpenClaw 解析到这一行时它会立刻中断从 auth-profiles.json 查找 Key 的流程转而使用这个硬编码的值。问题在于这个值极大概率是过期的、错误的或者干脆是另一个环境比如测试环境的 Key。更可怕的是这个覆盖是静默的没有任何日志提示“正在使用 models.json 中的 apiKey”你只能从 401 的结果反推。为什么 OpenClaw 要设计这种高优先级覆盖这其实是为了解决一种极端场景某个特定模型比如一个私有微调模型需要一个完全独立于主账户的、临时的、短期有效的 Key。但这属于“例外”而非“常规”。对于绝大多数用户尤其是刚入门的 Kimi Code 订阅者这个例外功能就是一颗定时炸弹。防御性配置实践提示永远不要在 models.json 的任何模型配置块中出现apiKey字段。这是一个铁律应该像编程中的null检查一样成为肌肉记忆。更进一步我建议在你的编辑器VS Code / Vim中设置一个自定义代码片段snippet。例如在 VS Code 的settings.json中添加editor.quickSuggestions: { strings: false }, emeraldwalk.runonsave: { commands: [ { match: \\.json$, cmd: sed -i /\\\apiKey\\\:/d ${file} } ] }这段配置的意思是每次保存.json文件时自动执行一条sed命令删除文件中所有包含apiKey:的行。它粗暴但有效。它强迫你回归到“单一信源”的正道上。第一次运行时可能会删掉你故意留下的测试 Key但一周之后你会感谢这个“无情”的守护者。3.2 坑二baseUrl 缺少/v1—— API 版本契约的精确性失守现象复现与危害分析baseUrl: https://api.kimi.com/coding/这个 URL看起来天衣无缝。域名对路径对协议对。但它漏掉了最关键的/v1。Kimi 的 API 设计严格遵循 RESTful 规范/v1不是一个可有可无的装饰而是版本契约的强制声明。没有它请求会被路由到一个不存在的、或者返回默认 401 的兜底服务。有趣的是这个错误不会在 OpenClaw 启动时报错而是在你第一次尝试让 agent 执行一个需要调用模型的 action比如ask或code时才爆发。这意味着你可能已经成功看到 OpenClaw 的 UI 界面甚至能输入文字却在最关键的一刻被拦下。这种延迟报错极大地增加了排查难度。为什么 Kimi 要设计/v1这是现代 API 设计的最佳实践。/v1表明这是一个稳定、向后兼容的接口版本。未来 Kimi 可能推出/v2引入新的字段、废弃旧的参数而/v1的所有行为将保持不变。客户端OpenClaw通过明确指定版本可以确保自己的逻辑不会因为服务端的升级而意外崩溃。OpenClaw 的 models.json 要求你填 baseUrl本质上就是在要求你签署这份版本契约。防御性配置实践提示把所有 API 的 baseUrl 当作一个需要“背诵”的常量。不要凭记忆手敲也不要从浏览器地址栏复制。正确的做法是打开 Kimi 官方文档的 API 页面通常是https://platform.moonshot.cn/docs/api-reference找到Coding API部分直接复制Base URL字段的完整值。目前截至 2024 年中这个值就是https://api.kimi.com/coding/v1。我个人的习惯是在models.json的kimi-coding块上方加一行注释// Base URL from Kimi Docs: https://platform.moonshot.cn/docs/api-reference#coding-api kimi-coding: { baseUrl: https://api.kimi.com/coding/v1, ... }这行注释有两个作用一是提醒自己这个值的来源和权威性二是当你未来需要升级时可以直接点击链接确认/v1是否已被/v2替代。3.3 坑三model id 混淆k2p5 vs kimi-for-coding—— 抽象层与实现层的语义鸿沟现象复现与危害分析你用curl测试https://api.kimi.com/coding/v1/models得到了一个漂亮的 JSON里面清晰地写着id: kimi-for-coding。于是你兴冲冲地把models.json里的id: k2p5改成了id: kimi-for-coding。结果OpenClaw 启动失败或者启动后 agent 完全无法响应。这是因为你犯了一个根本性错误混淆了“API 接口的实体标识符”和“OpenClaw 框架的逻辑标识符”。kimi-for-coding是 Kimi 服务器给这个模型起的“真名”是它在数据库里的主键。而k2p5是 OpenClaw 开发者为这个模型在自己的代码库里定义的一个“花名”或“代号”。这个代号是 OpenClaw 内部所有逻辑路由、配置解析、日志打印所依赖的唯一标识。你强行把k2p5换成kimi-for-coding就像试图用一个人的身份证号去登录他的微信账号——系统根本不认识这个字符串。为什么 OpenClaw 要搞出k2p5这个别名这源于 OpenClaw 的核心设计理念Provider Agnostic提供商无关。OpenClaw 的目标是让用户能用同一套配置语法无缝切换 OpenAI、Anthropic、Kimi 等不同提供商。如果它直接使用各家 API 返回的原始 model id那么配置文件就会变成这样primary: openai/gpt-4-turboprimary: anthropic/claude-3-opus-20240229primary: moonshot/kimi-for-coding这不仅冗长而且当 Kimi 下线kimi-for-coding、推出kimi-for-coding-pro时你的所有配置都要跟着改。而k2p5这个名字是 OpenClaw 团队承诺的、长期稳定的“逻辑模型名”。只要k2p5这个代号存在无论 Kimi 后台如何升级OpenClaw 都会负责把它映射到最新的、可用的真实模型上。这是一种面向未来的解耦。防御性配置实践提示永远以 OpenClaw 的官方文档为唯一真理。访问https://github.com/OpenClaw/openclaw/blob/main/docs/models.md找到Kimi for Coding那一节里面明确写着ID: k2p5。把这个页面收藏为书签每次配置前都打开确认。更进一步我建议在models.json的kimi-coding块里为id字段加上一个“防呆”注释models: [ { id: k2p5, // ⚠️ DO NOT CHANGE! This is OpenClaws internal logical ID. // Real API model ID is kimi-for-coding, mapped internally. name: Kimi for Coding, ... } ]这个注释是写给未来的你、或者团队里其他同事看的。它用最直白的语言划清了抽象与实现的界限。3.4 坑四session 缓存不刷新 —— 运行时状态的“幽灵残留”现象复现与危害分析你已经完美修复了前三个坑apiKey字段被删除baseUrl加上了/v1id也确认是k2p5。你信心满满地CtrlC停掉 OpenClaw再openclaw启动。结果底部状态栏依然顽固地显示agent main | session main | moonshot/kimi-k2.5。你打开开发者工具看到 network 面板里所有的请求header 里的Authorization字段依然是那个旧的、失效的 Key。这说明OpenClaw 根本没有读取你刚刚修改的auth-profiles.json和models.json它在运行一个“幻影进程”。这个幻影就是sessions.json文件。它像一个幽灵把旧世界的配置完整地投射到了新世界里。为什么 OpenClaw 要设计 session 缓存这纯粹是为了性能。想象一下每次你让 agent 执行一个复杂的 multi-step 任务比如“分析这个 GitHub 仓库找出所有潜在的安全漏洞并生成修复 PR”OpenClaw 需要动态加载模型、初始化工具集、建立连接池。如果每次请求都要重新解析几十个 JSON 文件、进行网络握手整个交互会变得极其卡顿。sessions.json就是这个过程的“快照”它把所有初始化后的、可直接运行的状态序列化保存下来。下次启动直接加载这个快照毫秒级恢复。防御性配置实践提示把清理 session 缓存当作 OpenClaw 配置工作流的最后一个、也是最重要的一步。它应该和“保存文件”、“重启服务”一样成为你肌肉记忆的一部分。我为自己写了一个一键清理脚本clean-openclaw.sh放在~/bin/目录下#!/bin/bash # 清理 OpenClaw 所有 agent 的 session 缓存 echo Cleaning OpenClaw sessions... rm -f ~/.openclaw/agents/*/sessions/sessions.json echo Done. Please restart OpenClaw.每次修改完配置我做的最后一件事就是在终端里敲clean-openclaw。这个习惯让我在后续的几百次配置迭代中再也没有被“配置已改但不生效”的问题困扰过。记住重启是必要的但不充分清理缓存才是让新配置真正落地的临门一脚。4. 实操过程与核心环节实现从零开始构建一份坚不可摧的 Kimi 配置现在我们把前面所有的理论、避坑心得整合成一份可直接“抄作业”的、完整的、经过实测的配置流程。我会模拟一个真实的、从零开始的场景你刚刚购买了 Kimi Code 订阅拿到了第一个 API Key准备第一次启动 OpenClaw。整个过程我将严格遵循“防御性配置”的原则每一步都解释其背后的逻辑和验证方法。4.1 准备工作获取并验证你的 Kimi API Key第一步登录 Kimi 平台进入 API 设置页打开https://platform.moonshot.cn/console/api-keys。确保你登录的是购买了 Kimi Code 订阅的主账号。点击“创建 API Key”选择Kimi Code这个用途非常重要普通 Key 可能没有 coding 权限然后复制生成的 Key。它应该以sk-kimi-开头。第二步用 curl 进行原子级验证不要急着打开 OpenClaw。先用最原始的工具验证这个 Key 和 baseUrl 的组合是否真的有效。打开终端执行curl https://api.kimi.com/coding/v1/models \ -H Authorization: Bearer sk-kimi-你的完整Key \ -H Content-Type: application/json注意-H Content-Type: application/json这个 header 是必须的Kimi 的/v1/models接口要求它。很多同学漏掉这个也会得到 401。预期结果你应该看到一个包含{data: [...]}的 JSON 响应其中data数组的第一个元素id字段的值是kimi-for-coding。如果看到{error: {...}}或者空响应说明 Key 无效、权限不足或者 baseUrl 错了。此时请停止一切 OpenClaw 配置回到 Kimi 平台检查订阅状态和 Key 创建步骤。4.2 构建 auth-profiles.json建立唯一的凭证信源第一步定位并创建文件OpenClaw 的配置目录默认在~/.openclaw/。进入该目录创建auth-profiles.json文件mkdir -p ~/.openclaw/ cd ~/.openclaw/ touch auth-profiles.json第二步填入权威凭证用你喜欢的编辑器如nano auth-profiles.json打开它填入以下内容{ moonshot: { apiKey: sk-kimi-你的完整Key } }关键点解释moonshot是 Kimi 在 OpenClaw 中的 provider 名称这是框架约定的不能改成kimi或coding。apiKey字段的值就是你上一步curl命令里用的那个 Key。绝对不要在这个文件里添加任何其他字段比如baseUrl或model。它的使命只有一个安全、唯一地保管凭证。4.3 构建 models.json定义模型能力与映射关系第一步创建文件并填充基础结构在~/.openclaw/目录下创建models.jsontouch models.json第二步填入经过防御性加固的 Kimi 配置以下是经过我实测、并融入所有避坑要点的完整kimi-coding配置块{ kimi-coding: { // Base URL from Kimi Docs: https://platform.moonshot.cn/docs/api-reference#coding-api baseUrl: https://api.kimi.com/coding/v1, api: anthropic-messages, models: [ { id: k2p5, // ⚠️ DO NOT CHANGE! This is OpenClaws internal logical ID. // Real API model ID is kimi-for-coding, mapped internally. name: Kimi for Coding, reasoning: true, input: [text, image], contextWindow: 262144, maxTokens: 32768, compat: { requiresOpenAiAnthropicToolPayload: true } } ] } }关键点解释baseUrl末尾没有/这是为了防止 OpenClaw 在拼接最终请求 URL 时出现https://api.kimi.com/coding/v1//chat/completions这样的双斜杠错误。id字段严格使用k2p5并附有醒目的防呆注释。compat.requiresOpenAiAnthropicToolPayload这个字段是 OpenClaw 3.7 版本处理 Kimi tool call 的关键开关必须为true否则会出现后文提到的“tool call 泄漏”问题。4.4 构建 openclaw.json绑定模型与 Agent第一步创建主配置文件在~/.openclaw/目录下创建openclaw.jsontouch openclaw.json第二步填入最小可行配置为了让首次启动尽可能简单我们只配置最核心的agents.defaults{ agents: { defaults: { model: { primary: kimi-coding/k2p5, fallbacks: [] } } }, models: { kimi-coding/k2p5: { alias: Kimi K2.5 } } }关键点解释primary字段的格式是provider/model-id这里是kimi-coding/k2p5它告诉 OpenClaw“请使用kimi-coding这个 provider 下k2p5这个逻辑模型”。models下的kimi-coding/k2p5别名是为了让 OpenClaw 在日志和 UI 中能友好地显示为Kimi K2.5而不是一串难懂的 ID。4.5 终极验证启动、清理、观察第一步执行清理在终端中运行我们之前创建的清理脚本或者手动执行rm -f ~/.openclaw/agents/*/sessions/sessions.json第二步启动 OpenClaw在终端中输入openclaw等待几秒钟直到 OpenClaw 的 Web UI 在浏览器中打开通常是http://localhost:3000。第三步实时观察与验证看状态栏底部状态栏应该清晰地显示agent main | session main | kimi-coding/k2p5。如果还是moonshot/kimi-k2.5说明缓存没清干净或者openclaw.json里的primary字段写错了。看 Network 面板打开浏览器的开发者工具F12切换到 Network 标签页。在 OpenClaw 的聊天框里随便输入一句话比如“你好”。观察第一个chat/completions请求。点击它查看 Headers。Authorization字段的值应该是Bearer sk-kimi-你的完整Key。Request URL应该是https://api.kimi.com/coding/v1/chat/completions。看响应内容点击 Response 标签页你应该能看到 Kimi 模型返回的、结构化的 JSON 响应其中包含content字段里面是模型的回答。如果看到{error: {...}}说明问题还在需要回到前面的步骤逐一核对。5. 常见问题与排查技巧实录一份来自战场的速查手册在过去的两周里我和十几个同样在 Kimi OpenClaw 上挣扎的朋友一起整理了一份高频问题清单。这些问题有些是我自己踩过的有些是他们在 Discord 社区里发的截图。我把它们归类、复现、并给出了最直接、最有效的解决方案。这份手册不是教科书式的罗列而是你遇到问题时能立刻打开、快速定位、马上解决的“急救包”。5.1 401 错误的终极排查树当HTTP 401: Invalid Authentication再次出现时不要再盲目重启。请严格按照以下顺序用 5 分钟完成一次精准排查步骤检查项如何检查修复方法修复后验证1auth-profiles.json是否存在且格式正确cat ~/.openclaw/auth-profiles.json | jq .确保文件存在JSON 格式合法moonshot下有apiKey字段且值正确。jq命令不报错且输出中apiKey值是你复制的 Key。2models.json中是否有apiKey字段grep -n apiKey: ~/.openclaw/models.json如果有输出说明存在硬编码 Key。删除该行保存文件。3models.json中baseUrl是否为https://api.kimi.com/coding/v1grep -A 2 baseUrl ~/.openclaw/models.json检查 URL 是否精确匹配末尾无/。修改为精确值保存文件。4openclaw.json中primary字段是否为kimi-coding/k2p5grep -A 5 primary ~/.openclaw/openclaw.json检查字符串是否完全一致。修改为kimi-coding/k2p5保存文件。5sessions.json是否已被清除ls -la ~/.openclaw/agents/*/sessions/如果看到sessions.json文件说明未清除。rm -f ~/.openclaw/agents/*/sessions/sessions.json提示这个排查树我已经固化成一个 Bash 函数放在我的~/.bashrc里openclaw-check() { echo Step 1: auth-profiles.json cat ~/.openclaw/auth-profiles.json 2/dev/null \| jq . 2/dev/null \|\| echo ❌ File missing or invalid echo -e \n Step 2: models.json apiKey grep -n apiKey: ~/.openclaw/models.json 2/dev/null \|\| echo ✅ No hard-coded apiKey found echo -e \n Step 3: models.json baseUrl grep -A 2 baseUrl ~/.openclaw/models.json 2/dev/null \|\| echo ❌ baseUrl not found echo -e \n Step 4: openclaw.json primary grep -A 5 primary ~/.openclaw/openclaw.json 2/dev/null \|\| echo ❌ primary not found echo -e \n Step 5: sessions.json ls -la ~/.openclaw/agents/*/sessions/sessions.json 2/dev/null \|\| echo ✅ sessions.json cleared }每次遇到问题只需在终端输入openclaw-check所有关键信息一目了然。5.2 “Tool Call 泄漏”问题当模型把 XML 标签当作文本输出现象描述模型的回答里出现了类似function_callsinvoke namesearch_codebaseargument{query:find all SQL injection vulnerabilities}/argument/invoke/function_calls这样的原始 XML 标签而不是执行搜索并返回结果。这表明OpenClaw 发送的请求没有被 Kimi 正确识别为一个需要执行 tool call 的请求而是被当成了普通的文本生成请求。根本原因这是 OpenClaw 3.7/3.8 版本与 Kimi 的anthropic-messagesAPI 之间的一个兼容性问题。Kimi 的 API 要求当请求中包含tool_choice字段并且tools数组非空时messages数组中的content字段必须是一个text类型的字符串而不能是[{type: text, text: ...}]这样的数组。但 OpenClaw 的默认 payload 构造逻辑在某些情况下会生成后者。临时解决方案在models.json的kimi-coding块中添加一个compat配置强制 OpenClaw 使用正确的 payload 格式kimi-coding: { ..., compat: { requiresOpenAiAnthropicToolPayload: true, forceTextContentInMessages: true } }forceTextContentInMessages这个字段是 OpenClaw 3.8.1 版本引入的它会强制将messages中的content转换为字符串。如果你的 OpenClaw 版本低于 3.8.1请先升级npm install -g openclawlatest。5.3 其他高频问题速查问题现象最可能原因快速修复OpenClaw 启动后UI 界面一片空白Network 面板无任何请求openclaw.json文件语法错误比如多了一个逗号导致整个配置加载失败。cat ~/.openclaw/openclaw.json | jq .用jq工具检查 JSON 格式。Agent 能响应但回答极其简短、不使用工具像在“装傻”models.json中k2p5模型的reasoning字段为false或者compat.requiresOpenAiAnthropicToolPayload为false。确保reasoning为truerequiresOpenAiAnthropicToolPayload为true。上传图片后模型说“我看不到图片”models.json中k2p5模型的input数组缺少image。确保input: [text, image]。openclaw命令找不到提示command not foundOpenClaw 没有全局安装或者npm的 global bin 目录不在你的PATH环境变量中。运行npm config get prefix然后将$(npm config get prefix)/bin添加到PATH中例如在~/.bashrc里加export PATH$(npm config get prefix)/bin:$PATH。6. 实操心得与经验沉淀那些文档里永远不会写的细节最后我想分享一些在反复调试、与社区朋友深夜连线、甚至翻 OpenClaw 源码的过程中沉淀下来的、真正有价值的“野路子”经验。这些不是标准答案而是我在泥泞中趟出来的小径希望能为你省下几个小时的徒劳。心得一把auth-profiles.json当作你的“数字护照”定期备份API Key 是敏感信息但它更是你数字身份的证明。我养成了一个习惯每周五下午用一个