zhipu-tools-coding-plan（智浦工具编码计划）

智谱工具 Coding Plan (Zhipu Tools)

基于 Z.AI Coding Plan MCP 端点 的免费工具集：网络搜索、网页读取、GitHub 仓库文档搜索和文件解析。

功能

前五项通过 Coding Plan MCP 端点免费调用，文件解析仅支持旧版 API。

配置

在 openclaw.json 中配置 API Key：

{
  "skills": {
    "entries": {
      "zhipu-tools": {
        "apiKey": "YOUR_ZHIPU_API_KEY"
      }
    }
  }
}

或设置环境变量：ZHIPU_API_KEY

MCP vs Legacy 模式

MCP 模式自动 fallback：MCP 失败时会自动尝试 Legacy API。

使用方式

网络搜索 (web_search_prime)

cd ~/.openclaw/workspace/skills/zhipu-tools

# Shell
./scripts/web_search.sh "搜索关键词" [count]

# Python（支持更多参数）
python3 scripts/zhipu_tool.py web_search "搜索关键词" \
  --count 10 --recency week --domain example.com

网页读取 (webReader)

# Shell
./scripts/web_reader.sh "https://www.example.com"

# Python
python3 scripts/zhipu_tool.py web_reader "https://www.example.com"

GitHub 仓库文档搜索 (Zread)

# Shell - 搜索仓库文档
./scripts/zread.sh search "openai/openai" "how to use"

# Shell - 查看目录结构
./scripts/zread.sh structure "openai/openai"
./scripts/zread.sh structure "openai/openai" "src/"

# Shell - 读取文件
./scripts/zread.sh read "openai/openai" "README.md"

# Python
python3 scripts/zhipu_tool.py zread search "openai/openai" "how to use"
python3 scripts/zhipu_tool.py zread structure "openai/openai" --path src/
python3 scripts/zhipu_tool.py zread read "openai/openai" "README.md"

文件解析 (Legacy only)

./scripts/file_parser.sh /path/to/document.pdf PDF
python3 scripts/zhipu_tool.py file_parser /path/to/document.docx --file-type DOCX

MCP 工具参数详情

web_search_prime

webReader

返回：标题、正文内容、元数据、链接列表。

search_doc

get_repo_structure

read_file

MCP 协议

所有远程 MCP 端点通过 streamableHttp 协议交互：

1. POST initialize → 响应 header 返回 mcp-session-id
2. POST notifications/initialized → 通知就绪
3. POST tools/call → 调用具体工具

Headers: Authorization: Bearer $API_KEY, Content-Type: application/json, Accept: text/event-stream, application/json

Coding Plan 套餐额度

额度次月自动重置。

注意事项

• API Key 敏感信息，不要提交到 Git
• Zread（仓库文档搜索）仅支持 MCP 模式
• 文件解析仅支持旧版 API（bigmodel 端点）
• 所有 MCP 工具通过 Coding Plan 免费额度调用