Node-托管 MCP 服务器和技能

Node-托管 MCP 服务器

请在节点机器上的 openclaw.json 中配置 MCP 服务器，而不是在 Gateway 上配置：

{  nodeHost: {    mcp: {      servers: {        localDocs: {          command: "npx",          args: ["-y", "@modelcontextprotocol/server-filesystem", "/srv/docs"],          toolFilter: {            include: ["read_*", "search"],          },        },        internalApi: {          url: "https://mcp.internal.example/mcp",          transport: "streamable-http",          headers: {            Authorization: "Bearer ${INTERNAL_MCP_TOKEN}",          },        },      },    },  },}

无头节点主机会启动这些服务器，列出它们的工具，并在连接后发布描述信息。工具调用会通过 mcp.tools.call.v1 返回到该节点；Gateway 不需要匹配的 MCP 配置或 JS 插件。不支持在此节点托管的 v1 路径中使用 OAuth MCP 服务器。

当前的节点主机在初始配对期间会声明内置的 mcp.tools.call.v1 命令家族， 即使没有配置任何 MCP 服务器也是如此。使用较旧 OpenClaw 版本配对的节点在节点主机更新后，可能会请求一次性的命令面升级。之后添加、移除或过滤服务器都不需要重新配对，因为已批准的命令家族没有变化。要应用节点 MCP 配置更改， 请重启 openclaw node run 或 openclaw node restart；节点主机不会监视此配置。

服务器通告的工具列表更改实时应用并替换已发布的节点目录。如果 MCP 传输关闭或 SSE 或有状态 Streamable HTTP 会话过期，则节点将撤回该服务器的过时工具并以有界退避重新连接。检测到会话过期的失败调用不会重放；稍后的调用可以在重新发布其工具后使用替换连接。

Gateway 运营者可以通过 gateway.nodes.pluginTools.enabled: false 忽略所有由已配对节点发布、对代理可见的工具，包括节点托管的 MCP 工具。像 gateway.nodes.commands.deny: ["mcp.tools.call.v1"] 这样的精确命令拒绝也会阻止执行。

Node-托管技能

将技能安装在节点机器当前激活的 OpenClaw 技能目录下，默认是 ~/.openclaw/skills。OPENCLAW_HOME、OPENCLAW_STATE_DIR 和 OPENCLAW_CONFIG_PATH 会移动该活动配置文件。对于技能而言，OPENCLAW_STATE_DIR 具有优先级；否则，skills/ 位于 openclaw config file 打印出的路径旁边。无头节点主机在连接后会发布有效的 SKILL.md 文件，而 Gateway 仅在该节点保持连接期间将它们添加到代理技能快照中。每个技能目录名称必须与 name frontmatter 字段匹配，这样抽象节点定位器就能映射到一个条目，而无需再添加另一个协议字段。

初始的节点角色配对会批准技能发布。添加、移除或更改技能不需要再次配对或修改 Gateway 配置。 更改节点技能文件后，请重启 openclaw node run 或 openclaw node restart；节点主机不会监视技能目录。

Node-托管技能条目标识其节点并携带其执行位置。技能文件、引用的相对路径和二进制文件保留在该节点上。代理使用普通的 read 工具读取通告的 node://.../SKILL.md 位置。 file_fetch 接受运营商批准的绝对节点路径，而不是节点技能定位器；没有正常读取工具的运行时可以通过 exec host=node node=<node-id> 运行 cat SKILL.md，并将公布的 node://.../skills/<name> 目录作为 workdir。引用的文件和二进制文件使用相同的 exec 目标和工作目录。节点主机根据其活动的 OpenClaw 状态目录解析该定位器，因此相对路径在节点而不是网关计算机上解析。发布节点必须已批准system.run，并且代理的执行策略必须允许host=node；否则该技能将不会出现在该代理的快照中。

在节点上设置nodeHost.skills.enabled: false以停止发布。网关操作员可以忽略每个与 gateway.nodes.allowSkills: false 配对的节点的技能。

局部模型推理

桌面或服务器 node 可以从运行在该 node 上的 Ollama 服务器暴露支持聊天的模型。代理使用 Ollama 插件的 node_inference 工具来发现已安装的模型，并远程运行一个有边界的提示；Gateway 无需直接访问 Ollama 网络。有关设置、模型过滤和直接验证命令，请参见 Ollama 节点本地推理。