|
|
|
|
@ -20,11 +20,19 @@ description: 提供 Educoder 用户与课堂相关查询能力，当前支持用
|
|
|
|
|
|
|
|
|
|
## 前置配置
|
|
|
|
|
|
|
|
|
|
接入 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 配置文件。
|
|
|
|
|
安装 skill 时要求把用户输入 Educoder `Authorization` token 写入 MCP 配置文件 `.openclaw/educoder-skill/.mcp.json`。
|
|
|
|
|
|
|
|
|
|
配置文件路径必须固定为：
|
|
|
|
|
|
|
|
|
|
```text
|
|
|
|
|
.openclaw/educoder-skill/.mcp.json
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
不要写入 `.openclaw/mcp.json` 或 `.openclaw/config/mcp.json`，否则新开会话时可能读取不到配置。
|
|
|
|
|
|
|
|
|
|
MCP 配置示例：
|
|
|
|
|
|
|
|
|
|
@ -76,7 +84,7 @@ async with streamable_http_client(self.server_url, headers=headers or None) as (
|
|
|
|
|
|
|
|
|
|
### 多会话共享 Token
|
|
|
|
|
|
|
|
|
|
多个会话共用 MCP 配置文件中的同一个 `Authorization` token。安装后不需要每个会话重复输入 token；每次调用 MCP 时读取配置里的 `headers.Authorization` 即可。
|
|
|
|
|
多个会话共用 `.openclaw/educoder-skill/.mcp.json` 中的同一个 `Authorization` token。安装后不需要每个会话重复输入 token；每次调用 MCP 时读取配置里的 `headers.Authorization` 即可。
|
|
|
|
|
|
|
|
|
|
### 401 Token 过期处理
|
|
|
|
|
|
|
|
|
|
@ -86,7 +94,7 @@ async with streamable_http_client(self.server_url, headers=headers or None) as (
|
|
|
|
|
|
|
|
|
|
1. 停止继续使用当前 token 重试
|
|
|
|
|
2. 提示用户重新输入新的 `Authorization`
|
|
|
|
|
3. 将用户输入的新 token 写入 OpenClaw 的 MCP 配置文件
|
|
|
|
|
3. 将用户输入的新 token 写入 `.openclaw/educoder-skill/.mcp.json`
|
|
|
|
|
4. 重新创建 MCP 连接，并从 MCP 配置读取最新 token
|
|
|
|
|
5. 使用新 token 重新发起本次工具调用
|
|
|
|
|
|
|
|
|
|
@ -104,7 +112,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 ` 前缀
|
|
|
|
|
@ -333,7 +341,8 @@ async def main(openclaw_mcp_config):
|
|
|
|
|
- 当前服务使用 `streamable-http`，不是 SSE
|
|
|
|
|
- 如果客户端使用了 `sse_client`，将无法正常调用当前服务
|
|
|
|
|
- `Authorization` 应从 OpenClaw MCP 配置读取 token 原文，通过 MCP 连接层 headers 传入，不放在工具参数里，也不要添加 `Bearer ` 前缀
|
|
|
|
|
- 调用接口返回 `401 Unauthorized` 时，视为 token 过期或无效，应要求用户重新输入 token，并更新 OpenClaw MCP 配置文件中的 `headers.Authorization`
|
|
|
|
|
- 新开会话直接从 MCP 配置读取 `headers.Authorization`
|
|
|
|
|
- 调用接口返回 `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` 数组属于预期行为，因为外部接口尚未接入
|
|
|
|
|
- 后续新增或调整工具时，需要同步更新本文件
|
|
|
|
|
|
