发布日期：2026-05-19 11:51:20 浏览次数： 1795
作者：SwiftCafe
微信搜一搜，关注“SwiftCafe”
推荐语
OpenClaw的上下文保护机制如何影响Skill使用？了解规则，避免性能下降与成本增加。
核心内容：
1. 上下文保护机制的作用与触发条件
2. Skill数量与描述长度的具体限制规则
3. 避免触发降级的实用优化建议
杨芳贤
53AI创始人/腾讯云(TVP)最具价值专家
大家好，这篇来聊一个很多人可能没注意到，但如果踩坑了可能会很困惑的问题——OpenClaw 的上下文长度保护机制。
在上一篇文章里我们提到，OpenClaw 每次发消息给模型，都会带上所有可用 Skill 的 name 和 description。如果 Skill 数量太多，或者 description 写得太长，上下文就会变得很大，既影响性能，也增加成本。所以 OpenClaw 引入了一个保护机制：当上下文超过一定阈值时，Skill 会被降级发送。
这篇就来具体说说，这个机制是怎么工作的，以及我们怎么写 Skill 才能避免被降级。
## 上下文保护机制是什么
OpenClaw 文档中我没看到有这个叫法，上下文保护这是我自己想出来的一个说法，不过实际上做的事情就是这个意思。
简单说，OpenClaw 对于可用 skill 列表的提示词是有一个长度控制的，如果超过默认阈值，会触发降级规则，对 Skill 列表进行压缩。压缩的方式有两种：减少发送的 Skill 数量，或者改用不含 description 的紧凑格式。
我先用文字跟大家描述一下这个规则。节省大家精力，需要看详细分析的话后面也有代码分析。
OpenClaw 每次调用模型的时候，不会把 Skill 的完整内容都发过去， 只会最多发给模型这些 skill 的 name 和 description 属性，构建出来是一个 xml 格式的字符串，在提示词的 skill 分段中，就是这个样子：
`
然后说说这个长度规则的判断过程，每次模型运行的时候， 会加载出我们所有可用的 skill 列表。
第一步 – 先做一个 skill 数量匹配，默认值是 150 个上限。 如果我们实际使用的 skill 超过这个上限，包括 OpenClaw 自带的 skill 都算在一起，后面超出的就会被截断，根本不会发给模型。 当然，我们可以用这个设置项，改变这个上限:`skills.limits.maxSkillsInPrompt`
第二步 – 处理完 skill 数量判断后，如果超出数量，就会被截断成新列表，如果没超出，会保留原来的列表。 然后会用这个列表生成我们上面展示的那个的形式的 xml 字符串。 这一步会判断这个 xml 字符串的长度，如果超出默认的 18000 字符的上限，就会进入 compact 模式。这个上限也可以通过配置项修改：`skills.limits.maxSkillsPromptChars`
如果进入 compact 模式，就会去掉 description，再重新生成 xml 字符串，就是这个格式：
`
这时候还会继续判断， 如果 compact 模式压缩后的 xml 字符串还是超出上限，就会用二分查询继续缩短列表。 简单来说，最极端的这个情况下，不但 xml 变成压缩模式，skill 列表还会进一步被截断。
大家可以看到， 一旦进入 compact 模式，description 属性就不会发给模型了，这种模式下，一定会造成模型对 skill 理解能力的显著下降。如果 skill 列表还被截断的话，那么有些 skill 模型根本都看不见。
关于如何调整这两个上限的配置项，给大家一个 openclaw.json 示例：
`{ “skills”: { “limits”: { “maxSkillsInPrompt”: 150, “maxSkillsPromptChars”: 18000 } }}`
实际情况就是，对于大部分用户，skill 数量超过这个数量上限的概率并不大，除非是你特别爱折腾 skill， 安装了很多其他的。 唯一要注意的是你的 skill 文件中 name 和 description 属性不要写的太长，这个是真的会累加到 xml 字符串上限的。
我相信看完我给大家介绍的这个机制，大家如果不小心真的遇到这种 skill 被吞掉的奇怪问题，就不会摸不着头脑了。
如果大家精力有限的话， 看到这里也够了。 下面是一个详细的代码分析，如果有时间，也可以继续看。 也可以收藏下来以后参考用。
## 代码分析
具体的规则就在下面这些关键代码上，我先贴出来，这个代码稍长，需要两张图。
贴图的下面段落，会把重要的地方跟大家聊一下：
第一个关键点在这里：
const byCount = params.skills.slice(0, Math.max(0, limits.maxSkillsInPrompt));
maxSkillsInPrompt 是每个 Prompt 最大允许的 skill 数量， 默认值是 150， 如果我们当前会话可用的 skill 超过这个数量， 后面的会被截断。 意思就是完全不会发给模型。
接下来要说的，就是这块 if 判断：
`if (!fitsFull(skillsForPrompt)) { if (fitsCompact(skillsForPrompt)) { compact = true; } else { compact = true; //，，， truncated = true; }}`
首先 fitsFull， 它的意思就是先用全量的规则解析一下，就是带 description 的 xml 格式:
`
fitsFull，先解析成全量的 skill 字符串，判断是否超过允许的上限：
`const fitsFull = (skills: Skill[]): boolean =>formatSkillsForPrompt(skills).length <= limits.maxSkillsPromptChars;`
maxSkillsPromptChars 就是这个 skill 字符串长度上限， 这个上限是 18000 个字符。 如果超出，就执行`if (fitsCompact(skillsForPrompt))`这个分支。
fitsCompact 也不难理解，就是去掉 xml 的 description，再判断是否超出字符串长度上限。如果还超出，就进入下面的 if 分支。尝试进一步缩减 skill 列表，符合这个上限。
## 总结
这次就是和大家把 OpenClaw 关于 skill 长度限制的事情聊了一下，因为它现在如果真的发生了 compact 模式压缩，以及列表缩短， 用户是看不到提示的，只会给模型一个提示词，说列表被缩短了。 如果大家真的遇到这种边缘情况，在不知道这个机制存在的情况下，可能会很难调试问题。
因为 OpenClaw 是一个更新非常快的产品， 我现在说的机制，也只是基于当前版本的，以后这个机制可能也会调整，就要以最新的代码为准了。
说到可以优化的地方，比如最后这个二分查询缩短列表的方法，设计的健壮性可以更好一些。 比如优先去删除那些 name 和 description 超出其他 skill 太多的，而不是二分查询几乎等同于随机的删除，这样就完全避免少数超大元信息的 skill 挤掉其他的了。 我相信后续版本也会改进这个问题。
[登录查看剩余 70% 内容](javascript:void (0);)
https://www.53ai.com/keyword/Openclawhttps://www.53ai.com/keyword/Openclaw%E4%B8%8B%E8%BD%BDhttps://www.53ai.com/keyword/%E4%BC%81%E4%B8%9A%E7%89%88Openclaw
分享：
用微信扫描二维码
用微信扫描二维码
用微信扫描二维码
用微信扫描二维码
53AI，企业落地大模型首选服务商
**产品**：场景落地咨询+大模型应用平台+行业解决方案
**承诺**：免费POC验证，效果达标后再合作。**零风险落地应用大模型**，已交付160+中大型企业
https://www.53ai.com/news/Openclaw/2026052445192.htmlhttps://www.53ai.com/news/Openclaw/2026051932041.html
https://www.53ai.com/news/Openclaw
相关资讯
https://www.53ai.com/news/Openclaw/2026063038247.htmlhttps://www.53ai.com/news/Openclaw/2026063068395.htmlhttps://www.53ai.com/news/Openclaw/2026062197082.htmlhttps://www.53ai.com/news/Openclaw/2026062168250.htmlhttps://www.53ai.com/news/Openclaw/2026061894560.htmlhttps://www.53ai.com/news/Openclaw/2026061779241.htmlhttps://www.53ai.com/news/Openclaw/2026060145908.htmlhttps://www.53ai.com/news/Openclaw/2026053151390.html
https://www.53ai.com/solution.html
https://www.53ai.com/solution.html
160+中大型企业正在使用53AI
[立即咨询](javascript:void(0))[预约演示](javascript:void(0))
https://www.53ai.com/news/dongtai/2025012294502.htmlhttps://www.53ai.com/news/dongtai/2025012234192.html
https://hub.53ai.com/
热点资讯
https://www.53ai.com/news/Openclaw/2026040931856.htmlhttps://www.53ai.com/news/Openclaw/2026041537452.htmlhttps://www.53ai.com/news/Openclaw/2026050317590.htmlhttps://www.53ai.com/news/Openclaw/2026040903698.htmlhttps://www.53ai.com/news/Openclaw/2026041347816.htmlhttps://www.53ai.com/news/Openclaw/2026041845236.htmlhttps://www.53ai.com/news/Openclaw/2026040813695.htmlhttps://www.53ai.com/news/Openclaw/2026052927413.htmlhttps://www.53ai.com/news/Openclaw/2026040847536.htmlhttps://www.53ai.com/news/Openclaw/2026041076983.html
大家都在问
https://www.53ai.com/news/Openclaw/2026040915074.htmlhttps://www.53ai.com/news/Openclaw/2026040726437.htmlhttps://www.53ai.com/news/Openclaw/2026040201278.htmlhttps://www.53ai.com/news/Openclaw/2026033051689.htmlhttps://www.53ai.com/news/Openclaw/2026033092507.htmlhttps://www.53ai.com/news/Openclaw/2026032615306.htmlhttps://www.53ai.com/news/Openclaw/2026032435479.htmlhttps://www.53ai.com/news/Openclaw/2026032456814.html
热门标签
https://www.53ai.com/news/neirongchuangzuohttps://www.53ai.com/news/LargeLanguageModelhttps://www.53ai.com/news/gerentixiaohttps://www.53ai.com/news/langchainhttps://www.53ai.com/news/llamaindexhttps://www.53ai.com/news/MultimodalLargeModelhttps://www.53ai.com/news/RAGhttps://www.53ai.com/news/zhinengkefuhttps://www.53ai.com/news/knowledgegraphhttps://www.53ai.com/news/finetuninghttps://www.53ai.com/news/RAGFlowhttps://www.53ai.com/news/cozehttps://www.53ai.com/news/difyhttps://www.53ai.com/news/fastgpthttps://www.53ai.com/news/Bishenghttps://www.53ai.com/news/Qanythinghttps://www.53ai.com/news/AIqichehttps://www.53ai.com/news/AIjinronghttps://www.53ai.com/news/AIgongyehttps://www.53ai.com/news/AIpeixunhttps://www.53ai.com/news/AISaaShttps://www.53ai.com/news/tishicikuangjiahttps://www.53ai.com/news/tishicijiqiaohttps://www.53ai.com/news/AIdianshanghttps://www.53ai.com/news/AImianshihttps://www.53ai.com/news/shuziyuangonghttps://www.53ai.com/news/zhinengbaobiaohttps://www.53ai.com/news/zhishiguanlihttps://www.53ai.com/news/OpenSourceLLMhttps://www.53ai.com/news/zhinengyingxiaohttps://www.53ai.com/news/zhinengyingjianhttps://www.53ai.com/news/zhinenghuagaizaohttps://www.53ai.com/news/AIyiliaohttps://www.53ai.com/news/MaxKBhttps://www.53ai.com/news/Palantirhttps://www.53ai.com/news/Gleanhttps://www.53ai.com/news/Openclaw
[应聘简历请发送至： ceo@53ai.com](mailto:ceo@53ai.com)
https://www.53ai.com/product.html
https://www.53ai.com/product/quanyuanAIhttps://www.53ai.com/product/gongzuoduihuahttps://www.53ai.com/product/neirongchuangzuohttps://www.53ai.com/product/zhinengwendanghttps://www.53ai.com/product/mofacaidan
https://www.53ai.com/product/yewuAIhttps://www.53ai.com/product/weixinfenshenhttps://www.53ai.com/product/haiwaikefuhttps://www.53ai.com/product/guanwangkefuhttps://www.53ai.com/product/douyinkefuhttps://www.53ai.com/product/shuzilaoshihttps://www.53ai.com/product/shuzidudaohttps://www.53ai.com/product/zhinengfuwutai
https://www.53ai.com/product/AIXyewuhttps://www.53ai.com/product/zhinengwenshuhttps://www.53ai.com/product/zhinengshenhehttps://www.53ai.com/product/zhinenggongdanhttps://www.53ai.com/product/qiweigenjinzhushouhttps://www.53ai.com/product/zhinengbaojiahttps://www.53ai.com/product/qiweixiaoshouzhushouhttps://www.53ai.com/product/zijianyingyonghttps://www.53ai.com/product/qiweikefuzhushou
https://www.53ai.com/consulting.htmlhttps://www.53ai.com/fine-tuning.html
https://www.53ai.com/kehuanli.html
https://www.53ai.com/kehuanli/hangyeanlihttps://www.53ai.com/kehuanli/solution
https://www.53ai.com/news.html
https://www.53ai.com/news/qianyanjishuhttps://www.53ai.com/news/agentplatformhttps://www.53ai.com/news/hangyeyingyonghttps://www.53ai.com/news/qiyejingyinghttps://www.53ai.com/prompt.html
https://www.53ai.com/about.html
https://www.53ai.com/about/introductionhttps://www.53ai.com/about/cooperation
友情链接：
https://www.waytoagi.com/https://www.yuncan.com/https://www.wescrm.com/https://www.mingpian.top/https://www.uweb.net.cn/
CopyRight © 2012-2026 深圳市博思协创网络科技有限公司 版权所有
https://beian.miit.gov.cn/
广州：广州市华景路37号(华景软件园)暨南大学科技大厦6楼（整层）
深圳：深圳市福田区泰然四路29号天安创新科技广场一期A座1204
上海：上海市浦东新区金新路58号1602室
微信扫码
和创始人交个朋友
联系我们
售前咨询
[186 6662 7370](tel:18666627370)
预约演示
[185 8882 0121](tel:18588820121)
微信扫码
添加专属顾问
回到顶部
加载中…
扫码咨询
[](https://www.53ai.com/news/Openclaw/2026051971398.html)
https://work.weixin.qq.com/ca/cawcde2599cf74e2d9https://work.weixin.qq.com/ca/cawcdefb661890e885[电话咨询](tel:400-838-1185)
扫码登录
– [x] 登录即表示您同意[《53AI网站服务协议》](javascript:void(0);)
服务协议
欢迎您使用【53AI 官方网站】（以下简称“本网站”或“我们”）。本《会员服务协议》（以下简称“本协议”）是您（以下简称“会员”或“用户”）与【深圳市博思协创网络科技有限公司】之间关于注册、登录及使用本网站会员服务所订立的法律协议。
在您注册或登录前，请务必审慎阅读、充分理解各条款内容，特别是免除或限制责任的条款、知识产权条款、争议解决条款等。此类条款将以加粗形式提示您注意。 当您通过微信公众号授权、手机验证码验证或其他方式成功登录本网站时，即视为您已完全理解并同意接受本协议的全部内容。
一、 定义
本网站：指由【深圳市博思协创网络科技有限公司】运营的，域名为【53ai.com】的网站及相关移动端页面。
会员服务：指本网站向注册会员提供的知识库文章查阅、内容检索及其他相关增值服务。
知识库内容：指本网站发布的包括但不限于文字、图表、数据、研究报告、行业分析等数字化内容资源。
二、 账号注册与登录
登录方式：本网站支持以下登录方式，您可根据实际情况选择：
微信公众号授权登录：您同意将您的微信OpenID信息授权给本网站，用于创建或关联会员账号。
手机验证码登录：您需提供真实有效的手机号码，并通过短信验证码完成身份验证与登录/注册。
账号安全：您的账号仅限您本人使用，禁止赠与、借用、租用、转让或售卖。因您保管不善导致的账号被盗、密码泄露等损失，由您自行承担。
实名认证：根据相关法律法规要求，我们可能要求您在特定功能下完成实名认证。如您拒绝提供，可能无法使用部分或全部服务。
未成年人保护：若您未满18周岁，请在法定监护人的陪同下阅读本协议，并在征得监护人同意后使用本服务。
三、 服务内容与规范
知识库查阅权限：会员登录后，有权按照其会员等级对应的权限范围，在线浏览、检索本网站知识库中的相关文章及内容。
服务变更：我们有权根据业务发展需要，调整、变更或终止部分服务内容，并将以网站公告、公众号消息等方式提前通知。
禁止行为：您在使用服务时不得实施以下行为：
利用技术手段批量爬取、下载、转存知识库内容；
将知识库内容用于商业目的或未经授权地向第三方传播；
干扰本网站正常运行或侵犯其他用户合法权益；
发布违法违规信息或从事违反公序良俗的活动。
四、 知识产权声明
权利归属：本网站知识库中的排版设计、软件代码等内容的知识产权均归【公司全称】或原权利人所有，受《中华人民共和国著作权法》等法律保护。
有限许可：本网站授予会员一项非独占、不可转让、不可转授权的普通许可，仅限于个人学习、研究之目的在线查阅知识库内容。
侵权追责：未经书面许可，任何单位或个人不得以任何形式复制、转载、摘编、镜像、汇编或以其他方式使用上述内容。一经发现，我们保留追究其法律责任的权利。
五、 个人信息保护
我们重视对您个人信息的保护。关于我们如何收集、使用、存储和保护您的个人信息，请单独阅读 《隐私政策》。
您通过微信公众号授权或手机号验证所提供的信息，我们将严格按照《个人信息保护法》的规定处理，仅用于身份识别、服务提供及安全验证等必要用途。
您可以随时通过网站设置或联系客服行使查阅、更正、删除个人信息及撤回授权同意的权利。
六、 免责声明
内容准确性：知识库内容仅供参考，不构成专业建议。我们不对其完整性、准确性、时效性作任何明示或暗示的保证，您应自行判断并承担使用风险。
不可抗力：因自然灾害、政策法规变化、网络故障、第三方平台接口异常（如微信接口维护、运营商短信通道故障）等不可抗力导致的服务中断或延迟，我们不承担违约责任。
第三方链接：本网站可能包含指向第三方网站的链接，该等网站的内容和服务不受我们控制，请您自行甄别风险。
七、 违约责任
如您违反本协议约定，我们有权视情节采取警告、限制功能、暂停服务、注销账号等措施，并保留要求赔偿损失的权利。
如因您的违约行为导致我们遭受行政处罚、第三方索赔或商誉损失，您应承担全部赔偿责任（包括但不限于罚款、赔偿金、律师费、公证费等）。
八、 法律适用与争议解决
本协议的订立、执行和解释均适用中华人民共和国大陆地区法律。
因本协议产生的或与本协议有关的任何争议，双方应友好协商解决；协商不成的，任何一方均可向【公司所在地】有管辖权的人民法院提起诉讼。
九、 其他
本协议构成双方就本服务达成的完整协议，取代此前任何口头或书面约定。
本协议任一条款被认定为无效或不可执行的，不影响其他条款的效力。
我们对本协议享有最终解释权，并在法律允许的范围内保留随时修改的权利。修改后的协议一经公布即生效，继续使用服务即视为同意修订内容。
[已查阅](javascript:void(0);)
安全验证
拖动下方拼图完成验证
AI生成背景
您的速度已超过 99% 的用户
验证错误,请重试
确定
安全验证
刷新验证码
反馈
切换无障碍验证
切换常规验证
