القائمة
当用户要给 OpenClaw 配置外部 MCP，或者要把某个 MCP 服务接进 OpenClaw，让智能体可以稳定调用外部工具时，必须使用这个技能。适用于“接搜索、浏览器、数据库、视觉理解、第三方平台工具”等所有 OpenClaw 外部 MCP 接入场景。优先走官方当前明文推荐方案，不要先猜原生配置键。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
维护人格化长期文档与全局记忆分层。只要任务涉及更新 `MEMORY.md`、`USER.md`、`IDENTITY.md`、`memory/world.md`、`memory/self.md`、`memory/expression.md`、`memory/inbox/`，或者用户提到“整理文档架构”“维护全局记忆”“更新人格文档”“把新认知归档到正确文档”“清理文档边界”“把最近经验沉淀进去”，就必须使用这个 skill。它负责判断什么值得沉淀、该写到哪一层、哪些内容该升级/降级/合并/暂存，而不是在日常执行中随手乱写长期文档。
当用户说“技能太多”“帮我盘点技能”“清理没用 skill”“为什么 token 这么高”“哪些技能在浪费上下文”“帮我看看这些技能要不要删”时，必须使用这个技能。它专门解决 OpenClaw 技能生态的审计、调用统计、token 影响分析、候选清理建议、确认后清理和清理后验收。
用于从官方发布页、新闻页、社交媒体页或图表页先获取原始截图，再从截图中裁出“证据链重点图”。当用户提到找证据截图、截更新要点、截标题/热度/关键段落/图表/评论重点、页面截图太长太丑、要把网页内容变成适合发文章的小图时，必须使用这个技能。默认流程是先获取截图，再判断重点，再裁剪输出，禁止直接交付全页长截图。
| name | openclaw-external-mcp-setup |
| description | 当用户要给 OpenClaw 配置外部 MCP，或者要把某个 MCP 服务接进 OpenClaw，让智能体可以稳定调用外部工具时，必须使用这个技能。适用于“接搜索、浏览器、数据库、视觉理解、第三方平台工具”等所有 OpenClaw 外部 MCP 接入场景。优先走官方当前明文推荐方案，不要先猜原生配置键。 |
这个技能解决的是：如何把一个外部 MCP 稳定接进 OpenClaw，并且让智能体不只是“技术上装好了”，而是真的会调用。
默认优先走 mcporter 路线。
原因：
mcpServers 键名只有在官方文档已经明确写出：
这三样都齐了，才考虑改成原生配置。
如果没有，就不要自己猜。
把 OpenClaw 外部 MCP 理解成 4 层：
凭据层
MCP 注册层
~/.mcporter/mcporter.json 注册一个命名好的 MCP 服务桥接层
~/.openclaw/openclaw.json 里的配置翻译成环境变量，再启动 MCPAgent 触发层
优先顺序：
~/.openclaw/openclaw.jsonconfig/*.env / config/*.json原则：
~/.openclaw/openclaw.json在 ~/.mcporter/mcporter.json 里注册 MCP：
{
"mcpServers": {
"your_mcp_name": {
"command": "/absolute/path/to/launcher_or_server",
"description": "Short description"
}
}
}
如果 MCP 本身就能直接启动，可以直接写服务命令。
如果要复用 OpenClaw 里的现有凭据，优先写一个启动器，再把 command 指向启动器。
桥接启动器常见职责：
~/.openclaw/openclaw.jsonmodels.providers.* 或其它配置段取值exec 真正的 MCP 服务什么时候需要桥接：
不要假设智能体自己会正确手写 mcporter call。
更稳的做法是：
固定命令入口示例：
openclaw-your-mcp-router some_tool --arg "value"
工作区本地 skill 的作用：
只完成 mcporter list 还不够。
要再做两层：
把 skill 直接放到目标工作区：
~/.openclaw/workspace/skills/...~/.openclaw/workspace-mia/skills/...建议按能力拆开，而不是做一个很宽泛的大 skill。
例如：
这样比一个总路由 skill 更容易触发。
在目标工作区的 MEMORY.md 里明确写：
这一步的作用是把“配置”升级成“习惯”。
如有需要，可以在 ~/.openclaw/openclaw.json 里补两类辅助项：
mcporter例如结构上会看到：
{
"skills": {
"load": {
"extraDirs": [
"/path/to/project/.codex/skills"
]
},
"entries": {
"mcporter": {
"enabled": true
}
}
}
}
注意：
至少做 3 轮验证：
mcporter list your_mcp_name --schema
确认服务已经注册，工具能列出来。
mcporter call your_mcp_name.some_tool --args '{"key":"value"}' --output json
确认工具真的能返回结果，而不是只注册成功。
直接给目标智能体一个真实任务，看它是否：
mcporter call表现：
表现：
表现：
更稳的方式是按具体能力拆 skill。
表现：
交付时要明确说清楚：
~/.mcporter/mcporter.json 里注册了什么MEMORY.md 写了哪些调用规则