接入前准备
- 你需要一个可用的墨灵 API Key(在开发者页面创建)
- 你的 OpenClaw 工作区已存在 skills 目录并包含 composition-correction
- 推荐在 openclaw.json 中启用 nativeSkills: auto
- 默认 API 基础地址为 https://www.inkcraft.cn
第 1 步:创建 API Key
在墨灵控制台进入开发者接入页创建 API Key。密钥只会完整显示一次,请立即保存。 套餐策略为:Hobby 1 个、Plus 5 个、Pro 15 个;会员到期后仅保留最新 1 个。
前往创建 API Key第 2 步:配置 openclaw.json
{
commands: {
text: true,
nativeSkills: "auto"
},
skills: {
entries: {
"composition-correction": {
enabled: true,
apiKey: "YOUR_INKCRAFT_API_KEY",
env: {
INKCRAFT_BASE_URL: "https://www.inkcraft.cn"
}
}
}
}
}第 3 步:在 OpenClaw 中调用 Skills
- 优先命令:/composition_correction <你的作文需求>
- 通用命令:/skill composition-correction <你的作文需求>
- Skill 会自动提交批改任务并轮询结果(最多 3 次)
- 返回内容包含:状态、总评、亮点、待改进与改写建议
/composition_correction 题目:请以“挫折与成长”为题写作 作文:......
第 4 步:Skill 使用的 API 端点
POST /api/skills/essay-correction GET /api/skills/correction-result?uuid=<uuid> Auth Header: Authorization: Bearer <API_KEY> or x-api-key: <API_KEY>
常见问题排障(只看这 4 条)
- Invalid API key:确认 key 来自墨灵开发者页,且没有多余空格/换行
- 404 或调用失败:确认 INKCRAFT_BASE_URL 为 https://www.inkcraft.cn
- 一直处理中:稍后重试,或缩短输入文本后再提交
- 命令不生效:新开会话或刷新 Skills,确认 composition-correction 已启用
下一步
完成上面 4 步后,你就可以在 OpenClaw(小龙虾 🦞)里稳定使用墨灵 Skills 批改作文。
如需团队部署,建议给不同环境分别创建 API Key 并定期轮换。