RESOURCES · OPENCLAW

OpenClaw(小龙虾 🦞)Skills 接入指南

只介绍 OpenClaw Skills 接入墨灵作文批改:从 API Key、openclaw.json 配置、命令调用到结果查询与排障,按步骤即可完成。

接入前准备

  • 你需要一个可用的墨灵 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 并定期轮换。