新手村
每个龙虾养成之路的起点。主线任务带你从零跑通,进阶修炼解决实战问题。
主线任务(必做,按顺序)
4步带你从零到第一个副本跑通,每步 10-20 分钟。
完整新手指南(11 章)
从认识 OpenClaw 到安装、渠道接入、技能配置,系统入门。
认识 OpenClaw:从聊天机器人到 AI 员工
搞懂 OpenClaw 是什么、能做什么、和 ChatGPT 有什么本质区别,10 分钟建立正确认知。
技术原理:Gateway、Agent、Skills 三层架构
理解 OpenClaw 的运行原理,掌握网关调度、LLM 决策、技能执行三层架构逻辑。
安装部署:从零完成 OpenClaw 环境配置
手把手完成 Node.js 环境准备、OpenClaw 安装、Gateway 启动,跑通第一次对话。
渠道接入:把 AI 接进 Telegram、飞书、微信
选择适合你的消息渠道,5 分钟完成 Telegram 接入,或参考飞书/企业微信配置流程。
Skills 系统:给 AI 安装技能、解锁真实能力
理解 Skills 的工作原理,学会从 ClawHub 搜索、安装、验证技能,让助手从聊天升级为执行。
模型配置:Claude、GPT、DeepSeek 怎么选
按使用场景选择模型,配置国内可用的 API,在性能与成本之间找到最优方案。
安全与成本:别让 AI 烧光预算或泄漏数据
了解 OpenClaw 的权限控制机制,设置 Token 预算,避免常见安全事故。
生态与社区:ClawHub、Discord、国内资源全景
了解 OpenClaw 的社区文化、ClawHub 技能市场、国内中文社区资源,融入这个生态。
常见问题 FAQ:新手最容易踩的 20 个坑
快速查阅新手最常见问题:连不上、报错、速度慢、Token 超限……一页找到答案。
命令速查表:最常用的 openclaw 命令一页搞定
整理 openclaw CLI 核心命令、斜杠命令、配置项速查,收藏备用随时查阅。
附录:官方文档、社区、工具全景资源链接
OpenClaw 学习资源汇总:官方文档、GitHub、Discord、中文社区、技能市场,一站收藏。
进阶修炼(按需跳读)
安装踩坑、运行排查、配置优化、Token 控费——遇到问题就来查。
安装踩坑:8 个最常见的安装失败场景与解法
Node 版本、WSL2、权限报错、端口占用……把安装阶段最高频的坑一次性列出来,照解法操作即可。
运行时问题排查:Gateway 挂了、AI 不回复怎么办
系统化排查 OpenClaw 运行时故障:Gateway 崩溃、模型超时、渠道断连、内存溢出。
工作区文件体系:SOUL、MEMORY、AGENTS 各是干什么的
深度解析 OpenClaw 工作区的 5 大核心配置文件,理解各自职责,避免配置错位。
高级配置:openclaw.json 深度玩法
详解 openclaw.json 的进阶配置选项:多模型路由、会话隔离、Hooks 钩子、调试模式。
Token 成本控制:每月 AI 费用控在 100 元以内
从配置精简、模型降级、缓存复用三个维度控制 Token 消耗,附实测成本对比。
安全指南:别让你的 AI 变成安全漏洞
Gateway 网络暴露防护、API Key 保护、工作区权限控制、生产环境安全加固清单。
Heartbeat 深度解析:让 AI 24 小时主动执行任务
完整解析 Heartbeat 机制:触发逻辑、间隔设置、与 Cron 的配合,避开常见配置错误。
Hooks 与 Skills 生态:让 AI 在特定时机自动触发
掌握 Hooks 钩子机制和 Skills 生态的协同玩法,实现消息前处理、工具链扩展、本地模型接入。
15 条坑与桥:最值得记住的避坑经验
从真实用户案例提炼的 15 条高价值经验:每条一个坑,一个解法,直接可用。
避坑命令速查:诊断和修复常用的 openclaw 命令
专门针对排障场景整理的命令速查:doctor 诊断、日志查看、强制重启、配置验证。
核心结论:用好 OpenClaw 最重要的 10 件事
提炼两份文档的核心结论:10 条最值得记住的原则,帮你建立正确的 OpenClaw 使用心智。