final

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` 数组属于预期行为，因为外部接口尚未接入
-- 后续新增或调整工具时，需要同步更新本文件
+- 后续新增或调整工具时，需要同步更新本文件