From e330fe43f6310b54d6b2565a7dae0c20e7057935 Mon Sep 17 00:00:00 2001 From: educoder Date: Wed, 29 Apr 2026 22:12:00 +0800 Subject: [PATCH] final --- SKILL.md | 38 +++++++++++++++++++++----------------- 1 file changed, 21 insertions(+), 17 deletions(-) diff --git a/SKILL.md b/SKILL.md index e588a89..a227fe4 100644 --- a/SKILL.md +++ b/SKILL.md @@ -34,19 +34,22 @@ Educoder skill 已安装完成。当前支持查询： - 某场考试下的学生列表 ``` + ## 前置配置 -接入 OpenClaw 时，使用单用户 `Authorization` token。第一次安装 skill 时，把 MCP 服务地址和 token 一起写到固定的 OpenClaw MCP 配置文件；后续调用 MCP 时，从该配置文件读取 token 并放到请求头里。 +接入 OpenClaw 时，多个会话使用同一个 `Authorization` token。第一次安装 skill 时，把 MCP 服务地址和 token 一起写到固定的 OpenClaw MCP 配置文件 `.openclaw/educoder-skill/.mcp.json` 中；后续调用 MCP 时，也只从 `.openclaw/educoder-skill/.mcp.json` 读取 token 并放到请求头里。 ### Authorization 配置 +安装 skill 时要求把用户输入 Educoder `Authorization` token 写入 MCP 配置文件 `.openclaw/educoder-skill/.mcp.json`。 + 配置文件路径必须固定为： ```text .openclaw/educoder-skill/.mcp.json ``` -安装 skill 时写入 MCP 服务地址，并将用户输入的`EDUCODER_AUTHORIZATION` token写入该配置文件。 +不要写入 `.openclaw/mcp.json` 或 `.openclaw/config/mcp.json`，否则新开会话时可能读取不到配置。 MCP 配置示例： @@ -96,9 +99,9 @@ async with streamable_http_client(self.server_url, headers=headers or None) as ( > `Authorization` 走 MCP 连接层请求头，不放在工具参数里。 -### 单用户 Token +### 多会话共享 Token -当前 skill 使用单用户 token。安装后不需要每个会话重复输入 token；每次调用 MCP 时读取配置里的 `headers.Authorization` 即可。 +多个会话共用 `.openclaw/educoder-skill/.mcp.json` 中的同一个 `Authorization` token。安装后不需要每个会话重复输入 token；每次调用 MCP 时读取配置里的 `headers.Authorization` 即可。 ### 401 Token 过期处理 @@ -108,7 +111,7 @@ async with streamable_http_client(self.server_url, headers=headers or None) as ( 1. 停止继续使用当前 token 重试 2. 提示用户重新输入新的 `Authorization` -3. 将用户输入的新 token 写入 MCP 配置文件中的 `headers.Authorization` +3. 将用户输入的新 token 写入 `.openclaw/educoder-skill/.mcp.json` 4. 重新创建 MCP 连接，并从 MCP 配置读取最新 token 5. 使用新 token 重新发起本次工具调用 @@ -126,7 +129,7 @@ async with streamable_http_client(self.server_url, headers=headers or None) as ( 1. 安装 skill 时，MCP 服务地址填写：`http://47.98.32.66:48000/mcp` 2. 安装 skill 时，要求用户输入 Educoder `Authorization` token -3. OpenClaw 将 MCP 地址和 token 写入 MCP 配置文件，其中 token 放到 `headers.Authorization` +3. OpenClaw 将 MCP 地址和 token 写入 `.openclaw/educoder-skill/.mcp.json`，其中 token 放到 `headers.Authorization` 4. 当前用户发起工具调用时，后端创建 MCPClient 5. MCPClient 建连时从 MCP 配置读取 token 6. MCPClient 把读取到的 token 原文放进 MCP headers，不要添加 `Bearer ` 前缀 @@ -138,9 +141,8 @@ async with streamable_http_client(self.server_url, headers=headers or None) as ( tool_server_url = "http://47.98.32.66:48000/mcp" mcp_config = openclaw_mcp_config.get("educoder-mcp") -token = mcp_config["headers"]["Authorization"] -client = MCPClient(mcp_config=mcp_config, authorization=token) +client = MCPClient(mcp_config=mcp_config) tool_result = await client.call_tool(tool_name, tool_arguments) ``` @@ -149,14 +151,15 @@ MCPClient 示例： ```python class MCPClient: - def __init__(self, mcp_config: dict, authorization: str): + def __init__(self, mcp_config: dict): self.server_url = mcp_config["url"] - self.authorization = authorization + self.mcp_config = mcp_config def _build_headers(self) -> dict[str, str]: headers = {} - if self.authorization: - headers["Authorization"] = self.authorization + authorization = self.mcp_config.get("headers", {}).get("Authorization", "").strip() + if authorization: + headers["Authorization"] = authorization return headers ``` @@ -166,7 +169,7 @@ class MCPClient: - 把 `Authorization` 放到工具参数里 - 给 `Authorization` 自动拼接 `Bearer ` 前缀 - 把 token 写入 OpenClaw `.env` 后要求用户重启才能生效 -- 把 token 写到其他位置，导致新会话读取不到 `headers.Authorization` +- 每个会话都重复要求用户输入 token ## 触发场景 @@ -332,7 +335,7 @@ from mcp.client.streamable_http import streamable_http_client async def main(openclaw_mcp_config): mcp_config = openclaw_mcp_config.get("educoder-mcp") - token = mcp_config["headers"]["Authorization"] + token = mcp_config.get("headers", {}).get("Authorization", "").strip() headers = { "Authorization": token @@ -354,8 +357,9 @@ async def main(openclaw_mcp_config): - 当前服务使用 `streamable-http`，不是 SSE - 如果客户端使用了 `sse_client`，将无法正常调用当前服务 -- 调用接口返回 `401 Unauthorized` 时，视为 token 过期或无效，应要求用户重新输入 token，并更新 MCP 配置文件中的 `headers.Authorization` -- 新开会话直接从 MCP 配置文件读取 `headers.Authorization` +- `Authorization` 应从 OpenClaw MCP 配置读取 token 原文，通过 MCP 连接层 headers 传入，不放在工具参数里，也不要添加 `Bearer ` 前缀 +- 调用接口返回 `401 Unauthorized` 时，视为 token 过期或无效，应要求用户重新输入 token，并更新 `.openclaw/educoder-skill/.mcp.json` 中的 `headers.Authorization` +- 新开会话直接从 `.openclaw/educoder-skill/.mcp.json` 读取 `headers.Authorization` - MCP 配置文件路径固定为 `.openclaw/educoder-skill/.mcp.json`，不要写入或读取 `.openclaw/mcp.json`、`.openclaw/config/mcp.json` - 当前工具返回空 `data` 数组属于预期行为，因为外部接口尚未接入 -- 后续新增或调整工具时，需要同步更新本文件 +- 后续新增或调整工具时，需要同步更新本文件 \ No newline at end of file