OpenClaw接入大模型API完整教程：2026年Skills开发从零到跑通

npm install -g @openclaw/cli
openclaw login

openclaw create my-first-skill --template llm-basic
cd my-first-skill

my-first-skill/
├── skill.yaml # Skill 元信息
├── src/
│ └── index.ts # 主逻辑
├── package.json
└── .env # API 配置

name: my-first-skill
version: 0.1.0
description: "我的第一个 OpenClaw Skill"
providers:
 llm:
 protocol: openai-compatible
 base_url: "https://api.openai.com/v1"
 model: "gpt-5"

import { defineSkill, llm } from '@openclaw/sdk';
export default defineSkill({
 name: 'smart-summary',
 description: '输入一段文字，返回结构化摘要',
 async handler(input: { text: string }) {
 const response = await llm.chat({
 model: 'gpt-5',
 messages: [
 { role: 'system', content: '你是一个擅长结构化摘要的助手，输出用 markdown 格式。' },
 { role: 'user', content: `请为以下内容生成结构化摘要：\n\n${input.text}` }
 ],
 temperature: 0.3,
 });
 return {
 summary: response.choices[0].message.content,
 model: response.model,
 tokens: response.usage?.total_tokens,
 };
 }
});

openclaw dev
# 另开终端
curl -X POST http://localhost:3800/invoke \
 -H "Content-Type: application/json" \
 -d '{"text": "OpenClaw 是一个开放的 AI Skills 平台..."}'

providers:
 llm:
 protocol: openai-compatible
 base_url: "https://api.ofox.ai/v1" # 聚合接口，一个 Key 用所有模型
 model: "gpt-5"

OPENCLAW_LLM_API_KEY=your-ofox-api-key

import { defineSkill, llm } from '@openclaw/sdk';
export default defineSkill({
 name: 'adaptive-qa',
 description: '根据问题复杂度自动选择模型的问答 Skill',
 async handler(input: { question: string; mode?: 'fast' | 'quality' }) {
 // 简单模式用 DeepSeek V3 省钱，质量模式用 Claude Opus 4.6
 const model = input.mode === 'quality' ? 'claude-opus-4.6' : 'deepseek-v3';
 const response = await llm.chat({
 model,
 messages: [
 { role: 'system', content: '你是一个专业的技术问答助手。' },
 { role: 'user', content: input.question }
 ],
 temperature: 0.5,
 stream: true, // OpenClaw 支持流式输出
 });
 let fullContent = '';
 for await (const chunk of response) {
 fullContent += chunk.choices[0]?.delta?.content || '';
 }
 return {
 answer: fullContent,
 model_used: model,
 };
 }
});

graph LR
 A[用户请求] --> B[OpenClaw Platform]
 B --> C[你的 Skill]
 C --> D[ofox.ai 聚合网关]
 D --> E[GPT-5]
 D --> F[Claude Opus 4.6]
 D --> G[DeepSeek V3]
 D --> H[GLM5]
 D --> I[Gemini 3]

// skill.yaml 里加上
output:
 streaming: true

runtime:
 timeout: 120 # 单位秒，建议设到 120

openclaw secrets set LLM_API_KEY "your-key-here"

openclaw publish