跳到正文
🌱 STARTER VILLAGE

新手村

每个龙虾养成之路的起点。主线任务带你从零跑通,进阶修炼解决实战问题。

11 章主线任务
11 章进阶修炼
0 基础要求
📋 MAIN QUEST

主线任务(必做,按顺序)

4步带你从零到第一个副本跑通,每步 10-20 分钟。

📖 GUIDE CHAPTERS

完整新手指南(11 章)

从认识 OpenClaw 到安装、渠道接入、技能配置,系统入门。

第01章 ★☆☆

认识 OpenClaw:从聊天机器人到 AI 员工

搞懂 OpenClaw 是什么、能做什么、和 ChatGPT 有什么本质区别,10 分钟建立正确认知。

第02章 ★☆☆

技术原理:Gateway、Agent、Skills 三层架构

理解 OpenClaw 的运行原理,掌握网关调度、LLM 决策、技能执行三层架构逻辑。

第03章 ★☆☆

安装部署:从零完成 OpenClaw 环境配置

手把手完成 Node.js 环境准备、OpenClaw 安装、Gateway 启动,跑通第一次对话。

第04章 ★☆☆

渠道接入:把 AI 接进 Telegram、飞书、微信

选择适合你的消息渠道,5 分钟完成 Telegram 接入,或参考飞书/企业微信配置流程。

第05章 ★★☆

Skills 系统:给 AI 安装技能、解锁真实能力

理解 Skills 的工作原理,学会从 ClawHub 搜索、安装、验证技能,让助手从聊天升级为执行。

第06章 ★★☆

模型配置:Claude、GPT、DeepSeek 怎么选

按使用场景选择模型,配置国内可用的 API,在性能与成本之间找到最优方案。

第07章 ★★☆

安全与成本:别让 AI 烧光预算或泄漏数据

了解 OpenClaw 的权限控制机制,设置 Token 预算,避免常见安全事故。

第08章 ★★☆

生态与社区:ClawHub、Discord、国内资源全景

了解 OpenClaw 的社区文化、ClawHub 技能市场、国内中文社区资源,融入这个生态。

第09章 ★☆☆

常见问题 FAQ:新手最容易踩的 20 个坑

快速查阅新手最常见问题:连不上、报错、速度慢、Token 超限……一页找到答案。

第10章 ★☆☆

命令速查表:最常用的 openclaw 命令一页搞定

整理 openclaw CLI 核心命令、斜杠命令、配置项速查,收藏备用随时查阅。

第11章 ★☆☆

附录:官方文档、社区、工具全景资源链接

OpenClaw 学习资源汇总:官方文档、GitHub、Discord、中文社区、技能市场,一站收藏。

🛠️ ADVANCED

进阶修炼(按需跳读)

安装踩坑、运行排查、配置优化、Token 控费——遇到问题就来查。

避坑 01 ★☆☆

安装踩坑:8 个最常见的安装失败场景与解法

Node 版本、WSL2、权限报错、端口占用……把安装阶段最高频的坑一次性列出来,照解法操作即可。

避坑 02 ★★☆

运行时问题排查:Gateway 挂了、AI 不回复怎么办

系统化排查 OpenClaw 运行时故障:Gateway 崩溃、模型超时、渠道断连、内存溢出。

避坑 03 ★★☆

工作区文件体系:SOUL、MEMORY、AGENTS 各是干什么的

深度解析 OpenClaw 工作区的 5 大核心配置文件,理解各自职责,避免配置错位。

避坑 04 ★★☆

高级配置:openclaw.json 深度玩法

详解 openclaw.json 的进阶配置选项:多模型路由、会话隔离、Hooks 钩子、调试模式。

避坑 05 ★★☆

Token 成本控制:每月 AI 费用控在 100 元以内

从配置精简、模型降级、缓存复用三个维度控制 Token 消耗,附实测成本对比。

避坑 06 ★★☆

安全指南:别让你的 AI 变成安全漏洞

Gateway 网络暴露防护、API Key 保护、工作区权限控制、生产环境安全加固清单。

避坑 07 ★★★

Heartbeat 深度解析:让 AI 24 小时主动执行任务

完整解析 Heartbeat 机制:触发逻辑、间隔设置、与 Cron 的配合,避开常见配置错误。

避坑 08 ★★★

Hooks 与 Skills 生态:让 AI 在特定时机自动触发

掌握 Hooks 钩子机制和 Skills 生态的协同玩法,实现消息前处理、工具链扩展、本地模型接入。

避坑 09 ★★★

15 条坑与桥:最值得记住的避坑经验

从真实用户案例提炼的 15 条高价值经验:每条一个坑,一个解法,直接可用。

避坑 10 ★☆☆

避坑命令速查:诊断和修复常用的 openclaw 命令

专门针对排障场景整理的命令速查:doctor 诊断、日志查看、强制重启、配置验证。

避坑 11 ★★☆

核心结论:用好 OpenClaw 最重要的 10 件事

提炼两份文档的核心结论:10 条最值得记住的原则,帮你建立正确的 OpenClaw 使用心智。

🎯 NEXT STEP

新手任务完成了?

去副本库挑一个真实场景,照着做跑通它。