什么是 OpenClaw 入门指南？

OpenClaw 入门指南是一本全面的技术手册，旨在帮助开发者构建稳健的 AI 助手生态系统。它引入了分层模型策略（类似于运动队）：免费模型确保系统持久性，订阅模型处理日常高容量工作负载，旗舰模型则作为专业专家处理关键任务。通过实施这些 Openclaw Skills，用户可以在通过智能资源分配最小化运营成本的同时，维持 24/7 全天候运行的 AI 系统。

该技能将复杂的配置工作流程合成为可操作的阶段，从使用通义千问（Qwen）或硅基流动（SiliconFlow）的零成本初始设置，到使用 MiniMax 和 Claude 的高级企业级配置。它专注于智能体编排的技术真相，提供构建可靠、高性能环境所需的逻辑。

下载入口:https://github.com/openclaw/skills/tree/main/skills/jooey/openclaw-starter-guide

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

OpenClaw 入门指南 应用场景

• 初次用户部署 OpenClaw 网关。
• 设计高效成本的回退链以确保高可用性。
• 从单智能体设置过渡到具有专业角色的多智能体协作流。
• 通过平衡免费和付费 LLM 供应商来优化每月预算。
• 使用空闲额度实施代码扫描或文档审查等自动化后台任务。

1. 环境准备：安装核心 ClawHub CLI 并通过 T@elegrimm、WhatsApp 或 Discord 等渠道建立通信。
2. 第一层（免费入门）：配置 SiliconFlow 或 Qwen Portal 等免费供应商，以零成本验证系统连接性。
3. 第二层（主力机型）：集成 MiniMax M2.1 等订阅制模型，为日常任务提供高质量推理和大上下文窗口。
4. 回退逻辑实施：在配置中定义优先级模型链，以自动处理 API 失败或额度耗尽的情况。
5. 多智能体架构：根据具体的性能要求，将特定模型分配给专用智能体（如 Coder、Assistant、Config-bot）。
6. 坚控与维护：使用诊断工具和手动请求测试来验证额度可用性和系统健康状况。

OpenClaw 入门指南 配置指南

要开始使用这些 Openclaw Skills，您必须先运行 OpenClaw 网关并全局安装 ClawHub CLI：

npm i -g clawhub

要安装特定的模型供应商，请使用以下命令：

# 安装 SiliconFlow 以获取免费和按需付费模型
clawhub install add-siliconflow-provider

# 安装 MiniMax 以获取固定价格订阅计划
clawhub install add-minimax-provider

通过添加您的 API 密钥并定义主模型和回退模型 ID 来配置您的 openclaw.json。

OpenClaw 入门指南 数据架构与分类体系

该技能利用 OpenClaw 生态系统内的结构化配置模式来管理供应商和智能体行为：

name: openclaw-starter-guide
description: OpenClaw 小白养成手册。从零开始搭建多 Agent AI 助手系统的完整指南，包含免费起步方案（Qwen 零成本）、进阶方案（MiniMax Coding Plan ￥49/月）、旗舰外援（SiliconFlow/NewCLI 按需调用）。涵盖模型策略、Fallback 链设计、额度管理、常见故障排查。适合首次部署 OpenClaw 或想优化模型成本的用户。当用户说"怎么开始"、"新手指南"、"省钱方案"、"模型怎么选"、"fallback 怎么配"时使用此 skill。

?? OpenClaw 小白养成手册

从零到多 Agent AI 系统的完整指南。

?? 核心理念

OpenClaw 的模型策略就像组建一支球队：

?? 免费球员（Qwen）    → 保底，确保系统永远在线
?? 包月主力（MiniMax）  → 日常主力，性价比最高
?? 外援专家（旗舰模型） → 关键时刻上场，按需付费

目标：用最少的钱，让 AI 助手 24/7 在线、随时可用。

?? 目录

1. 第一阶段：零成本起步
2. 第二阶段：包月主力上场
3. 第三阶段：旗舰外援加持
4. Fallback 链设计
5. 额度管理策略
6. 多 Agent 架构建议
7. 故障排查速查

前置条件

• OpenClaw 已安装并运行：参考 官方文档 完成安装
• 至少一个聊天渠道：T@elegrimm、WhatsApp、Discord 等
• Node.js 环境：用于安装 skills（clawhub CLI）

# 安装 ClawHub CLI（用于安装 skills）
npm i -g clawhub

第一阶段：零成本起步

目标：￥0 成本让系统跑起来。

推荐免费模型

最简配置

只需一个 provider 就能开始：

{
  "models": {
    "providers": {
      "siliconflow": {
        "baseUrl": "https://api.siliconflow.cn/v1",
        "apiKey": "",
        "api": "openai-completions",
        "models": [
          {
            "id": "Qwen/Qwen3-8B",
            "name": "Qwen3 8B (Free)",
            "reasoning": false,
            "input": ["text"],
            "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0},
            "contextWindow": 32768,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "siliconflow/Qwen/Qwen3-8B"
      }
    }
  }
}

注册 SiliconFlow：https://cloud.siliconflow.cn/i/ihj5inat （新用户送 ￥14）

免费阶段能做什么

• ? 单 Agent 对话
• ? 基本工具调用（文件、搜索、命令）
• ? 简单自动化任务
• ?? 复杂推理能力有限（8B 模型）
• ?? 长对话可能质量下降（32K context）

第二阶段：包月主力上场

目标：￥49/月获得企业级体验。

当免费模型不够用时，上 MiniMax Coding Plan：

为什么选 MiniMax？

• ?? 性价比无敌：￥49/月 ≈ ￥0.007/次，比按量付费便宜 100 倍
• ?? 额度充足：7200 次/天，6 个 Agent 平均每个 1200 次
• ?? 200K Context：长对话不丢失上下文
• ?? OpenAI 兼容：openai-completions 协议即插即用

安装

clawhub install add-minimax-provider

详细配置见：add-minimax-provider

配置策略

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "minimax/MiniMax-M2.1",
        "fallbacks": [
          "siliconflow/Qwen/Qwen3-8B"
        ]
      }
    }
  }
}

关键：免费模型放在 fallback 里！MiniMax 挂了或额度用完时，自动切到免费模型，系统不会停。

第三阶段：旗舰外援加持

目标：关键任务用最强模型，按需付费。

安装

clawhub install add-siliconflow-provider  # DeepSeek/Qwen/Kimi
clawhub install add-newcli-provider       # Claude/GPT/Gemini

使用方式

不需要改默认配置。需要时用 /model 命令临时切换：

/model sf-kimi        # 切到 Kimi K2.5
/model sf-coder-480b  # 切到 Qwen3 Coder 480B
/model claude-opus    # 切到 Claude Opus
/model Minimax        # 切回 MiniMax（默认）

Fallback 链设计

Fallback 链是 OpenClaw 的生命线——主模型挂了，自动尝试下一个。

推荐 Fallback 策略

第1优先：minimax/MiniMax-M2.1 (API Key 包月主力)
    ↓ 如果额度用完或 API 故障
第2优先：minimax-portal/MiniMax-M2.1 (OAuth 免费额度)
    ↓ 如果 OAuth 也不可用
第3优先：siliconflow/Qwen/Qwen3-8B (免费兜底)
    ↓ 如果 SiliconFlow 也挂了
第4优先：qwen-portal/coder-model (OAuth 免费)
    ↓ 如果都挂了
第5优先：deepseek/deepseek-ch@t (便宜)
    ↓ 最后的最后
第6优先：newcli/claude-haiku (贵但稳)

配置示例

"fallbacks": [
  "minimax-portal/MiniMax-M2.1",
  "siliconflow/Qwen/Qwen3-8B",
  "qwen-portal/coder-model",
  "deepseek/deepseek-ch@t",
  "newcli/claude-haiku-4-5-20251001"
]

设计原则

1. 免费模型优先放前面：先用免费的，省钱
2. 至少 2 个不同来源：避免单一供应商全挂
3. 最贵的放最后：Claude/GPT 只在其他全挂时才用
4. 不放推理模型：R1/Reasoner 慢且贵，不适合 fallback

额度管理策略

MiniMax Coding Plan 额度

1500 次/5小时滑动窗口
每次调用时倒算前 5 小时消耗
每天理论上限约 7200 次

?? 注意：MiniMax 额度查询 API (/coding_plan/remains) 的数据可能不准确（窗口切换后不及时刷新）。判断额度是否可用，最可靠的方法是发一个真实测试请求。

均匀消耗技巧

问题：白天集中使用，凌晨浪费额度。

解决：用 cron 安排夜间自动任务：

01:00  代码质量扫描
02:00  文档评审
03:00  TODO 整理
04:00  系统健康巡检
06:00  学习材料准备
07:00  早间简报

额度坚控

?? 重要：额度查询 API 数据不可信！

MiniMax 的额度查询 API 存在惰性更新问题——窗口切换后如果没有新调用，计数器不会刷新，返回的数字可能是上一窗口的残留数据。

推荐做法：不看数字，只看真实请求能不能通。

# 判断额度是否可用的唯一可靠方法
curl -s https://api.minimaxi.com/v1/ch@t/completions r
  -H "Authorization: Bearer " r
  -H "Content-Type: application/json" r
  -d '{"model":"MiniMax-M2.1","messages":[{"role":"user","content":"test"}],"max_tokens":3}'
# 返回 choices → 可用 | 返回 429 → 额度耗尽

配合 OpenClaw cron 定期验证即可，无需频繁轮询 API 数字。

多 Agent 架构建议

起步（1 个 Agent）

main (默认 Agent) → 处理所有事务

进阶（3-4 个 Agent）

main          → 日常对话、任务协调
coder         → 代码开发（用编码专用模型）
assistant     → 日程、邮件、提醒
config-bot    → 系统运维（用高级模型）

模型分配原则

故障排查速查

模型不响应

# 1. 检查系统状态
openclaw doctor

# 2. 查看错误日志
tail -20 ~/.openclaw/logs/gateway.err.log

# 3. 测试模型可用性
curl -s '/ch@t/completions' r
  -H 'Authorization: Bearer ' r
  -H 'Content-Type: application/json' r
  -d '{"model":"","messages":[{"role":"user","content":"test"}],"max_tokens":5}'

Agent 不说话

1. 检查 context 是否满了：sessions_list 看 totalTokens/contextTokens
2. 超过 90% → 重置 session（删除 sessions.json 中对应条目）
3. 检查 fallback 链是否配置正确

配置改错崩溃

# 恢复备份
cp ~/.openclaw/openclaw.json.backup. ~/.openclaw/openclaw.json
openclaw gateway restart

?? 牢记：agents.defaults.models. 只允许 alias 字段！一个非法字段 = 全面崩溃。

额度用完

• MiniMax Coding Plan：等 5 小时窗口重置
• SiliconFlow：充值或切到免费模型
• 临时方案：/model sf-qwen3-8b（免费）

详细故障排查见：openclaw-troubleshooting（开发中）

?? 成本速算

?? 相关资源

• OpenClaw 文档：https://docs.openclaw.ai
• OpenClaw GitHub：https://github.com/openclaw/openclaw
• ClawHub 技能市场：https://clawhub.com
• 社区 Discord：https://discord.com/invite/clawd

Provider 配置技能

注册链接

• SiliconFlow：https://cloud.siliconflow.cn/i/ihj5inat
• **NewCLI (FoxCode)**：https://foxcode.rjj.cc/auth/register?aff=7WTAV8R