{
  "schemaVersion": "1.0",
  "item": {
    "slug": "openclaw-starter-guide",
    "name": "🦞 OpenClaw Starter Guide",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/jooey/openclaw-starter-guide",
    "canonicalUrl": "https://clawhub.ai/jooey/openclaw-starter-guide",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/openclaw-starter-guide",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-starter-guide",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/openclaw-starter-guide"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/openclaw-starter-guide",
    "agentPageUrl": "https://openagent3.xyz/skills/openclaw-starter-guide/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-starter-guide/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-starter-guide/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "🦞 OpenClaw 小白养成手册",
        "body": "从零到多 Agent AI 系统的完整指南。"
      },
      {
        "title": "🎯 核心理念",
        "body": "OpenClaw 的模型策略就像组建一支球队：\n\n🆓 免费球员（Qwen）    → 保底，确保系统永远在线\n💰 包月主力（MiniMax）  → 日常主力，性价比最高\n🚀 外援专家（旗舰模型） → 关键时刻上场，按需付费\n\n目标：用最少的钱，让 AI 助手 24/7 在线、随时可用。"
      },
      {
        "title": "📖 目录",
        "body": "第一阶段：零成本起步\n第二阶段：包月主力上场\n第三阶段：旗舰外援加持\nFallback 链设计\n额度管理策略\n多 Agent 架构建议\n故障排查速查"
      },
      {
        "title": "前置条件",
        "body": "OpenClaw 已安装并运行：参考 官方文档 完成安装\n至少一个聊天渠道：Telegram、WhatsApp、Discord 等\nNode.js 环境：用于安装 skills（clawhub CLI）\n\n# 安装 ClawHub CLI（用于安装 skills）\nnpm i -g clawhub"
      },
      {
        "title": "第一阶段：零成本起步",
        "body": "目标：¥0 成本让系统跑起来。"
      },
      {
        "title": "推荐免费模型",
        "body": "来源模型特点安装 SkillQwen Portalqwen-portal/coder-modelOAuth 免费，128K context内置SiliconFlowQwen/Qwen3-8BAPI Key 免费，无限调用clawhub install add-siliconflow-providerSiliconFlowDeepSeek-R1-0528-Qwen3-8B免费推理模型同上"
      },
      {
        "title": "最简配置",
        "body": "只需一个 provider 就能开始：\n\n{\n  \"models\": {\n    \"providers\": {\n      \"siliconflow\": {\n        \"baseUrl\": \"https://api.siliconflow.cn/v1\",\n        \"apiKey\": \"<YOUR_KEY>\",\n        \"api\": \"openai-completions\",\n        \"models\": [\n          {\n            \"id\": \"Qwen/Qwen3-8B\",\n            \"name\": \"Qwen3 8B (Free)\",\n            \"reasoning\": false,\n            \"input\": [\"text\"],\n            \"cost\": {\"input\": 0, \"output\": 0, \"cacheRead\": 0, \"cacheWrite\": 0},\n            \"contextWindow\": 32768,\n            \"maxTokens\": 8192\n          }\n        ]\n      }\n    }\n  },\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"siliconflow/Qwen/Qwen3-8B\"\n      }\n    }\n  }\n}\n\n注册 SiliconFlow：https://cloud.siliconflow.cn/i/ihj5inat （新用户送 ¥14）"
      },
      {
        "title": "免费阶段能做什么",
        "body": "✅ 单 Agent 对话\n✅ 基本工具调用（文件、搜索、命令）\n✅ 简单自动化任务\n⚠️ 复杂推理能力有限（8B 模型）\n⚠️ 长对话可能质量下降（32K context）"
      },
      {
        "title": "第二阶段：包月主力上场",
        "body": "目标：¥49/月获得企业级体验。\n\n当免费模型不够用时，上 MiniMax Coding Plan：\n\n项目值价格¥49/月额度1500 次/5小时窗口（约 7200 次/天）模型MiniMax M2.1（200K context）质量对标 Claude Sonnet / GPT-4o"
      },
      {
        "title": "为什么选 MiniMax？",
        "body": "💰 性价比无敌：¥49/月 ≈ ¥0.007/次，比按量付费便宜 100 倍\n📦 额度充足：7200 次/天，6 个 Agent 平均每个 1200 次\n🧠 200K Context：长对话不丢失上下文\n🔌 OpenAI 兼容：openai-completions 协议即插即用"
      },
      {
        "title": "安装",
        "body": "clawhub install add-minimax-provider\n\n详细配置见：add-minimax-provider"
      },
      {
        "title": "配置策略",
        "body": "{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"minimax/MiniMax-M2.1\",\n        \"fallbacks\": [\n          \"siliconflow/Qwen/Qwen3-8B\"\n        ]\n      }\n    }\n  }\n}\n\n关键：免费模型放在 fallback 里！MiniMax 挂了或额度用完时，自动切到免费模型，系统不会停。"
      },
      {
        "title": "第三阶段：旗舰外援加持",
        "body": "目标：关键任务用最强模型，按需付费。\n\n场景推荐模型来源价格复杂推理DeepSeek R1SiliconFlow¥4/¥16 per M代码重构Qwen3 Coder 480BSiliconFlow¥8/¥16 per M顶级对话Kimi K2.5SiliconFlow¥4/¥21 per M长文档Claude OpusNewCLI按额度多模态Gemini 3 ProNewCLI按额度"
      },
      {
        "title": "安装",
        "body": "clawhub install add-siliconflow-provider  # DeepSeek/Qwen/Kimi\nclawhub install add-newcli-provider       # Claude/GPT/Gemini"
      },
      {
        "title": "使用方式",
        "body": "不需要改默认配置。需要时用 /model 命令临时切换：\n\n/model sf-kimi        # 切到 Kimi K2.5\n/model sf-coder-480b  # 切到 Qwen3 Coder 480B\n/model claude-opus    # 切到 Claude Opus\n/model Minimax        # 切回 MiniMax（默认）"
      },
      {
        "title": "Fallback 链设计",
        "body": "Fallback 链是 OpenClaw 的生命线——主模型挂了，自动尝试下一个。"
      },
      {
        "title": "推荐 Fallback 策略",
        "body": "第1优先：minimax/MiniMax-M2.1 (API Key 包月主力)\n    ↓ 如果额度用完或 API 故障\n第2优先：minimax-portal/MiniMax-M2.1 (OAuth 免费额度)\n    ↓ 如果 OAuth 也不可用\n第3优先：siliconflow/Qwen/Qwen3-8B (免费兜底)\n    ↓ 如果 SiliconFlow 也挂了\n第4优先：qwen-portal/coder-model (OAuth 免费)\n    ↓ 如果都挂了\n第5优先：deepseek/deepseek-chat (便宜)\n    ↓ 最后的最后\n第6优先：newcli/claude-haiku (贵但稳)"
      },
      {
        "title": "配置示例",
        "body": "\"fallbacks\": [\n  \"minimax-portal/MiniMax-M2.1\",\n  \"siliconflow/Qwen/Qwen3-8B\",\n  \"qwen-portal/coder-model\",\n  \"deepseek/deepseek-chat\",\n  \"newcli/claude-haiku-4-5-20251001\"\n]"
      },
      {
        "title": "设计原则",
        "body": "免费模型优先放前面：先用免费的，省钱\n至少 2 个不同来源：避免单一供应商全挂\n最贵的放最后：Claude/GPT 只在其他全挂时才用\n不放推理模型：R1/Reasoner 慢且贵，不适合 fallback"
      },
      {
        "title": "MiniMax Coding Plan 额度",
        "body": "1500 次/5小时滑动窗口\n每次调用时倒算前 5 小时消耗\n每天理论上限约 7200 次\n\n⚠️ 注意：MiniMax 额度查询 API (/coding_plan/remains) 的数据可能不准确（窗口切换后不及时刷新）。判断额度是否可用，最可靠的方法是发一个真实测试请求。"
      },
      {
        "title": "均匀消耗技巧",
        "body": "问题：白天集中使用，凌晨浪费额度。\n\n解决：用 cron 安排夜间自动任务：\n\n01:00  代码质量扫描\n02:00  文档评审\n03:00  TODO 整理\n04:00  系统健康巡检\n06:00  学习材料准备\n07:00  早间简报"
      },
      {
        "title": "额度监控",
        "body": "🔴 重要：额度查询 API 数据不可信！\n\nMiniMax 的额度查询 API 存在惰性更新问题——窗口切换后如果没有新调用，计数器不会刷新，返回的数字可能是上一窗口的残留数据。\n\n推荐做法：不看数字，只看真实请求能不能通。\n\n# 判断额度是否可用的唯一可靠方法\ncurl -s https://api.minimaxi.com/v1/chat/completions \\\n  -H \"Authorization: Bearer <API_KEY>\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"MiniMax-M2.1\",\"messages\":[{\"role\":\"user\",\"content\":\"test\"}],\"max_tokens\":3}'\n# 返回 choices → 可用 | 返回 429 → 额度耗尽\n\n配合 OpenClaw cron 定期验证即可，无需频繁轮询 API 数字。"
      },
      {
        "title": "起步（1 个 Agent）",
        "body": "main (默认 Agent) → 处理所有事务"
      },
      {
        "title": "进阶（3-4 个 Agent）",
        "body": "main          → 日常对话、任务协调\ncoder         → 代码开发（用编码专用模型）\nassistant     → 日程、邮件、提醒\nconfig-bot    → 系统运维（用高级模型）"
      },
      {
        "title": "模型分配原则",
        "body": "Agent 类型推荐模型理由日常对话MiniMax M2.1包月，不心疼代码开发MiniMax M2.1 / sf-coder-30b编码质量好系统运维Claude Opus需要最高可靠性轻量任务Qwen3-8B (免费)简单任务不浪费"
      },
      {
        "title": "模型不响应",
        "body": "# 1. 检查系统状态\nopenclaw doctor\n\n# 2. 查看错误日志\ntail -20 ~/.openclaw/logs/gateway.err.log\n\n# 3. 测试模型可用性\ncurl -s '<BASE_URL>/chat/completions' \\\n  -H 'Authorization: Bearer <KEY>' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"model\":\"<MODEL>\",\"messages\":[{\"role\":\"user\",\"content\":\"test\"}],\"max_tokens\":5}'"
      },
      {
        "title": "Agent 不说话",
        "body": "检查 context 是否满了：sessions_list 看 totalTokens/contextTokens\n超过 90% → 重置 session（删除 sessions.json 中对应条目）\n检查 fallback 链是否配置正确"
      },
      {
        "title": "配置改错崩溃",
        "body": "# 恢复备份\ncp ~/.openclaw/openclaw.json.backup.<TIMESTAMP> ~/.openclaw/openclaw.json\nopenclaw gateway restart\n\n⚠️ 牢记：agents.defaults.models.<id> 只允许 alias 字段！一个非法字段 = 全面崩溃。"
      },
      {
        "title": "额度用完",
        "body": "MiniMax Coding Plan：等 5 小时窗口重置\nSiliconFlow：充值或切到免费模型\n临时方案：/model sf-qwen3-8b（免费）\n\n详细故障排查见：openclaw-troubleshooting（开发中）"
      },
      {
        "title": "💰 成本速算",
        "body": "方案月费每日可用次数适合纯免费¥0无限（质量有限）个人试玩MiniMax 包月¥49~7200日常使用MiniMax + SF 余额¥49 + ¥507200 + 按需旗舰进阶用户全家桶¥49 + ¥50 + NewCLI全模型覆盖重度用户"
      },
      {
        "title": "🔗 相关资源",
        "body": "OpenClaw 文档：https://docs.openclaw.ai\nOpenClaw GitHub：https://github.com/openclaw/openclaw\nClawHub 技能市场：https://clawhub.com\n社区 Discord：https://discord.com/invite/clawd"
      },
      {
        "title": "Provider 配置技能",
        "body": "技能安装命令说明SiliconFlowclawhub install add-siliconflow-provider98+ 模型，含免费MiniMaxclawhub install add-minimax-provider¥49/月包月方案NewCLIclawhub install add-newcli-providerClaude/GPT/Gemini"
      },
      {
        "title": "注册链接",
        "body": "SiliconFlow：https://cloud.siliconflow.cn/i/ihj5inat\nNewCLI (FoxCode)：https://foxcode.rjj.cc/auth/register?aff=7WTAV8R"
      }
    ],
    "body": "🦞 OpenClaw 小白养成手册\n\n从零到多 Agent AI 系统的完整指南。\n\n🎯 核心理念\n\nOpenClaw 的模型策略就像组建一支球队：\n\n🆓 免费球员（Qwen）    → 保底，确保系统永远在线\n💰 包月主力（MiniMax）  → 日常主力，性价比最高\n🚀 外援专家（旗舰模型） → 关键时刻上场，按需付费\n\n\n目标：用最少的钱，让 AI 助手 24/7 在线、随时可用。\n\n📖 目录\n第一阶段：零成本起步\n第二阶段：包月主力上场\n第三阶段：旗舰外援加持\nFallback 链设计\n额度管理策略\n多 Agent 架构建议\n故障排查速查\n前置条件\nOpenClaw 已安装并运行：参考 官方文档 完成安装\n至少一个聊天渠道：Telegram、WhatsApp、Discord 等\nNode.js 环境：用于安装 skills（clawhub CLI）\n# 安装 ClawHub CLI（用于安装 skills）\nnpm i -g clawhub\n\n第一阶段：零成本起步\n\n目标：¥0 成本让系统跑起来。\n\n推荐免费模型\n来源\t模型\t特点\t安装 Skill\nQwen Portal\tqwen-portal/coder-model\tOAuth 免费，128K context\t内置\nSiliconFlow\tQwen/Qwen3-8B\tAPI Key 免费，无限调用\tclawhub install add-siliconflow-provider\nSiliconFlow\tDeepSeek-R1-0528-Qwen3-8B\t免费推理模型\t同上\n最简配置\n\n只需一个 provider 就能开始：\n\n{\n  \"models\": {\n    \"providers\": {\n      \"siliconflow\": {\n        \"baseUrl\": \"https://api.siliconflow.cn/v1\",\n        \"apiKey\": \"<YOUR_KEY>\",\n        \"api\": \"openai-completions\",\n        \"models\": [\n          {\n            \"id\": \"Qwen/Qwen3-8B\",\n            \"name\": \"Qwen3 8B (Free)\",\n            \"reasoning\": false,\n            \"input\": [\"text\"],\n            \"cost\": {\"input\": 0, \"output\": 0, \"cacheRead\": 0, \"cacheWrite\": 0},\n            \"contextWindow\": 32768,\n            \"maxTokens\": 8192\n          }\n        ]\n      }\n    }\n  },\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"siliconflow/Qwen/Qwen3-8B\"\n      }\n    }\n  }\n}\n\n\n注册 SiliconFlow：https://cloud.siliconflow.cn/i/ihj5inat （新用户送 ¥14）\n\n免费阶段能做什么\n✅ 单 Agent 对话\n✅ 基本工具调用（文件、搜索、命令）\n✅ 简单自动化任务\n⚠️ 复杂推理能力有限（8B 模型）\n⚠️ 长对话可能质量下降（32K context）\n第二阶段：包月主力上场\n\n目标：¥49/月获得企业级体验。\n\n当免费模型不够用时，上 MiniMax Coding Plan：\n\n项目\t值\n价格\t¥49/月\n额度\t1500 次/5小时窗口（约 7200 次/天）\n模型\tMiniMax M2.1（200K context）\n质量\t对标 Claude Sonnet / GPT-4o\n为什么选 MiniMax？\n💰 性价比无敌：¥49/月 ≈ ¥0.007/次，比按量付费便宜 100 倍\n📦 额度充足：7200 次/天，6 个 Agent 平均每个 1200 次\n🧠 200K Context：长对话不丢失上下文\n🔌 OpenAI 兼容：openai-completions 协议即插即用\n安装\nclawhub install add-minimax-provider\n\n\n详细配置见：add-minimax-provider\n\n配置策略\n{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"minimax/MiniMax-M2.1\",\n        \"fallbacks\": [\n          \"siliconflow/Qwen/Qwen3-8B\"\n        ]\n      }\n    }\n  }\n}\n\n\n关键：免费模型放在 fallback 里！MiniMax 挂了或额度用完时，自动切到免费模型，系统不会停。\n\n第三阶段：旗舰外援加持\n\n目标：关键任务用最强模型，按需付费。\n\n场景\t推荐模型\t来源\t价格\n复杂推理\tDeepSeek R1\tSiliconFlow\t¥4/¥16 per M\n代码重构\tQwen3 Coder 480B\tSiliconFlow\t¥8/¥16 per M\n顶级对话\tKimi K2.5\tSiliconFlow\t¥4/¥21 per M\n长文档\tClaude Opus\tNewCLI\t按额度\n多模态\tGemini 3 Pro\tNewCLI\t按额度\n安装\nclawhub install add-siliconflow-provider  # DeepSeek/Qwen/Kimi\nclawhub install add-newcli-provider       # Claude/GPT/Gemini\n\n使用方式\n\n不需要改默认配置。需要时用 /model 命令临时切换：\n\n/model sf-kimi        # 切到 Kimi K2.5\n/model sf-coder-480b  # 切到 Qwen3 Coder 480B\n/model claude-opus    # 切到 Claude Opus\n/model Minimax        # 切回 MiniMax（默认）\n\nFallback 链设计\n\nFallback 链是 OpenClaw 的生命线——主模型挂了，自动尝试下一个。\n\n推荐 Fallback 策略\n第1优先：minimax/MiniMax-M2.1 (API Key 包月主力)\n    ↓ 如果额度用完或 API 故障\n第2优先：minimax-portal/MiniMax-M2.1 (OAuth 免费额度)\n    ↓ 如果 OAuth 也不可用\n第3优先：siliconflow/Qwen/Qwen3-8B (免费兜底)\n    ↓ 如果 SiliconFlow 也挂了\n第4优先：qwen-portal/coder-model (OAuth 免费)\n    ↓ 如果都挂了\n第5优先：deepseek/deepseek-chat (便宜)\n    ↓ 最后的最后\n第6优先：newcli/claude-haiku (贵但稳)\n\n配置示例\n\"fallbacks\": [\n  \"minimax-portal/MiniMax-M2.1\",\n  \"siliconflow/Qwen/Qwen3-8B\",\n  \"qwen-portal/coder-model\",\n  \"deepseek/deepseek-chat\",\n  \"newcli/claude-haiku-4-5-20251001\"\n]\n\n设计原则\n免费模型优先放前面：先用免费的，省钱\n至少 2 个不同来源：避免单一供应商全挂\n最贵的放最后：Claude/GPT 只在其他全挂时才用\n不放推理模型：R1/Reasoner 慢且贵，不适合 fallback\n额度管理策略\nMiniMax Coding Plan 额度\n1500 次/5小时滑动窗口\n每次调用时倒算前 5 小时消耗\n每天理论上限约 7200 次\n\n\n⚠️ 注意：MiniMax 额度查询 API (/coding_plan/remains) 的数据可能不准确（窗口切换后不及时刷新）。判断额度是否可用，最可靠的方法是发一个真实测试请求。\n\n均匀消耗技巧\n\n问题：白天集中使用，凌晨浪费额度。\n\n解决：用 cron 安排夜间自动任务：\n\n01:00  代码质量扫描\n02:00  文档评审\n03:00  TODO 整理\n04:00  系统健康巡检\n06:00  学习材料准备\n07:00  早间简报\n\n额度监控\n\n🔴 重要：额度查询 API 数据不可信！\n\nMiniMax 的额度查询 API 存在惰性更新问题——窗口切换后如果没有新调用，计数器不会刷新，返回的数字可能是上一窗口的残留数据。\n\n推荐做法：不看数字，只看真实请求能不能通。\n\n# 判断额度是否可用的唯一可靠方法\ncurl -s https://api.minimaxi.com/v1/chat/completions \\\n  -H \"Authorization: Bearer <API_KEY>\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"MiniMax-M2.1\",\"messages\":[{\"role\":\"user\",\"content\":\"test\"}],\"max_tokens\":3}'\n# 返回 choices → 可用 | 返回 429 → 额度耗尽\n\n\n配合 OpenClaw cron 定期验证即可，无需频繁轮询 API 数字。\n\n多 Agent 架构建议\n起步（1 个 Agent）\nmain (默认 Agent) → 处理所有事务\n\n进阶（3-4 个 Agent）\nmain          → 日常对话、任务协调\ncoder         → 代码开发（用编码专用模型）\nassistant     → 日程、邮件、提醒\nconfig-bot    → 系统运维（用高级模型）\n\n模型分配原则\nAgent 类型\t推荐模型\t理由\n日常对话\tMiniMax M2.1\t包月，不心疼\n代码开发\tMiniMax M2.1 / sf-coder-30b\t编码质量好\n系统运维\tClaude Opus\t需要最高可靠性\n轻量任务\tQwen3-8B (免费)\t简单任务不浪费\n故障排查速查\n模型不响应\n# 1. 检查系统状态\nopenclaw doctor\n\n# 2. 查看错误日志\ntail -20 ~/.openclaw/logs/gateway.err.log\n\n# 3. 测试模型可用性\ncurl -s '<BASE_URL>/chat/completions' \\\n  -H 'Authorization: Bearer <KEY>' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"model\":\"<MODEL>\",\"messages\":[{\"role\":\"user\",\"content\":\"test\"}],\"max_tokens\":5}'\n\nAgent 不说话\n检查 context 是否满了：sessions_list 看 totalTokens/contextTokens\n超过 90% → 重置 session（删除 sessions.json 中对应条目）\n检查 fallback 链是否配置正确\n配置改错崩溃\n# 恢复备份\ncp ~/.openclaw/openclaw.json.backup.<TIMESTAMP> ~/.openclaw/openclaw.json\nopenclaw gateway restart\n\n\n⚠️ 牢记：agents.defaults.models.<id> 只允许 alias 字段！一个非法字段 = 全面崩溃。\n\n额度用完\nMiniMax Coding Plan：等 5 小时窗口重置\nSiliconFlow：充值或切到免费模型\n临时方案：/model sf-qwen3-8b（免费）\n\n详细故障排查见：openclaw-troubleshooting（开发中）\n\n💰 成本速算\n方案\t月费\t每日可用次数\t适合\n纯免费\t¥0\t无限（质量有限）\t个人试玩\nMiniMax 包月\t¥49\t~7200\t日常使用\nMiniMax + SF 余额\t¥49 + ¥50\t7200 + 按需旗舰\t进阶用户\n全家桶\t¥49 + ¥50 + NewCLI\t全模型覆盖\t重度用户\n🔗 相关资源\nOpenClaw 文档：https://docs.openclaw.ai\nOpenClaw GitHub：https://github.com/openclaw/openclaw\nClawHub 技能市场：https://clawhub.com\n社区 Discord：https://discord.com/invite/clawd\nProvider 配置技能\n技能\t安装命令\t说明\nSiliconFlow\tclawhub install add-siliconflow-provider\t98+ 模型，含免费\nMiniMax\tclawhub install add-minimax-provider\t¥49/月包月方案\nNewCLI\tclawhub install add-newcli-provider\tClaude/GPT/Gemini\n注册链接\nSiliconFlow：https://cloud.siliconflow.cn/i/ihj5inat\nNewCLI (FoxCode)：https://foxcode.rjj.cc/auth/register?aff=7WTAV8R"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/jooey/openclaw-starter-guide",
    "publisherUrl": "https://clawhub.ai/jooey/openclaw-starter-guide",
    "owner": "jooey",
    "version": "1.2.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/openclaw-starter-guide",
    "downloadUrl": "https://openagent3.xyz/downloads/openclaw-starter-guide",
    "agentUrl": "https://openagent3.xyz/skills/openclaw-starter-guide/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-starter-guide/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-starter-guide/agent.md"
  }
}