OpenMAIC技能

将此作为一份引导式、需多次确认的标准操作程序。不要将整个设置过程压缩成一次回复，并且在未经用户明确确认的情况下，不要执行任何会改变状态的操作。

核心规则

• 一次只推进一个阶段。
• 在执行任何会改变状态的操作之前，请先请求确认。
• 如果本地状态已存在，请展示你发现的内容并询问是否保留。
• 不要假设OpenClaw智能体自身的模型或API密钥会被OpenMAIC复用。
• OpenMAIC课堂生成使用OpenMAIC服务器端的提供商配置。
• 此技能不得依赖任何请求时指定的模型或提供商覆盖设置。
• 只有OpenMAIC服务器端的配置文件可以控制提供商选择和默认设置。
• 不要默认要求用户将API密钥粘贴到聊天中。
• 优先引导用户自行编辑本地配置文件。
• 不要主动提出代表用户将API密钥写入配置文件。
• 一旦设置完成且用户明确要求生成课堂，在提交生成任务前无需再次请求确认。
• 保留对本地文件读取的确认，例如从磁盘读取PDF。

可选技能配置

如果存在，从~/.openclaw/openclaw.json读取默认值

{
  "skills": {
    "entries": {
      "openmaic": {
        "enabled": true,
        "config": {
          "accessCode": "sk-xxx",
          "repoDir": "/path/to/OpenMAIC",
          "url": "http://localhost:3000"
        }
      }
    }
  }
}

• 位于：如果accessCode
• 存在，则默认为托管模式并跳过模式选择提示。仅将repoDir和url
• 作为本地模式的默认值。

操作前仍需确认。

标准操作程序阶段

0. 选择模式首先检查技能配置中是否存在accessCode。如果存在，则宣布找到存储的访问码，并直接进入托管模式（加载references/hosted-mode.md

，跳过阶段1-4）。不要要求用户再次粘贴访问码。访问码在配置中，询问用户希望如何使用OpenMAIC：

1. 使用托管的OpenMAIC（推荐用于快速启动）— 需要来自open.maic.chat的访问码。无需本地设置。
2. 本地运行— 克隆仓库，配置提供商密钥，并在您的机器上运行。

如果用户选择托管模式，加载references/hosted-mode.md并跳过第1至4阶段。 如果用户选择本地模式，则照常进入第1阶段。

1. 克隆或复用现有仓库

加载references/clone.md。

当用户尚未安装OpenMAIC或需要确认使用哪个本地检出时使用此步骤。

2. 选择启动模式

加载references/startup-modes.md。

在仓库位置确认后使用此步骤。展示可用的启动模式，推荐一种，并等待用户的选择。

3. 配置供应商密钥

加载references/provider-keys.md文件。

在开始课堂生成之前使用此步骤。推荐一个供应商路径，并明确告知用户需要编辑哪个配置文件。如果后续生成因供应商/模型/认证问题失败，请返回此阶段，并指导用户更新相同的服务器端配置文件。

核心LLM密钥配置完成后，询问用户是否希望启用可选功能（网络搜索、图像生成、视频生成、文本转语音）。每项功能都需要其自己的供应商密钥——请参阅 provider-keys.md 中的“可选功能”部分。

4. 启动并验证 OpenMAIC

在用户选择了启动模式并配置好密钥后，使用选定的方法启动 OpenMAIC，然后通过GET {url}/api/health来验证服务。

5. 生成课堂

加载references/generate-flow.md文件。

仅在服务健康后使用此指令。在读取本地PDF前请先确认。如果用户已明确要求生成，则无需在提交生成任务前进行二次确认，然后进入轮询循环直至成功或失败。仅发送生成请求支持的内容字段。对于长时间运行的任务，建议采用稀疏轮询，若回合在任务完成前结束，则告知用户稍后查看。

响应风格

• 保持每个步骤简短且明确。
• 当用户必须做出选择时，优先提供2-3个具体选项。
• 始终将推荐选项置于首位，并用一句话解释原因。
• 每个步骤完成后，说明发生了什么变化以及下一个确认的目的。
• 返回课堂链接时，将原始绝对URL单独置于一行，不加粗、不使用Markdown链接语法、代码格式或表格。