OpenClaw Homework Grader Plugin

这是一个给 OpenClaw 使用的“作业批改接口”插件模板，已经打包成可以直接落地调试的工程。

这个版本包含什么

• 只预留 两个环境变量：
  • HOMEWORK_GRADER_AK
  • HOMEWORK_GRADER_CK
• 已经带好 OpenClaw 所需的 openclaw.plugin.json
• 已经注册 5 个工具：
  • homework_grading_auth_status
  • homework_grading_healthcheck
  • homework_grading_submit
  • homework_grading_query
  • homework_grading_request
• 支持：
  • dryRun
  • 超时设置
  • 重试
  • 调试日志
  • 插件配置 + 工具入参双模式
• lib/auth.js 中保留 AK/CK 签名占位函数

目录结构

openclaw-homework-grader/
├── openclaw.plugin.json
├── package.json
├── .npmignore
├── index.js
├── .env.example
├── README.md
├── lib/
│   ├── auth.js
│   ├── config.js
│   ├── http.js
│   ├── schemas.js
│   └── utils.js
├── docs/
│   ├── INSTALL.md
│   ├── USAGE.md
│   └── DEVELOPMENT.md
├── examples/
│   ├── openclaw.json5.snippet
│   ├── tool-auth-status.json
│   ├── tool-healthcheck.json
│   ├── tool-submit-dryrun.json
│   ├── tool-query-dryrun.json
│   └── tool-custom-request.json
└── skills/
    └── homework-grader/
        └── SKILL.md

安装

通过 npm

npm install openclaw-homework-grader

安装后将目录注册到 OpenClaw：

openclaw plugins install ./node_modules/openclaw-homework-grader

通过本地目录

openclaw plugins install /你的目录/openclaw-homework-grader

详细步骤见 docs/INSTALL.md。

你最需要改的文件

1. 环境变量

复制一份：

cp .env.example .env

填写：

HOMEWORK_GRADER_AK=你的AK
HOMEWORK_GRADER_CK=你的CK

2. 签名函数

文件：

lib/auth.js

把 buildSignedHeaders(context) 替换成你供应商要求的真实签名逻辑。

最常用联调路径

1. 先调 homework_grading_auth_status
2. 再调 homework_grading_healthcheck
3. 再用 homework_grading_submit / homework_grading_query
4. 真实接口不确定时，先打开 dryRun: true

文档入口

• 安装说明：docs/INSTALL.md
• 使用说明：docs/USAGE.md
• 二次开发说明：docs/DEVELOPMENT.md

注意

当前模板 没有实现真实 AK/CK 签名。 如果你直接发真实请求，服务端大概率会因为签名不正确而拒绝；这是预期行为。