核心用法
openclaw-newbie-faq 是一款面向 OpenClaw 新手的本地化知识库技能。安装后，用户通过自然语言指令（如"启动新手帮助"）触发内部 Web 服务，自动在 localhost:34567 启动轻量级 HTTP 服务器，浏览器即可访问完整交互式指南。内容体系包含四大模块：
1. 大模型常识：产业视角（上中下游）与工程视角（7层技术栈）双维度架构图，帮助新手建立 AI 工程全局认知。
2. 常见问题：覆盖安装、网络、Gateway、频道连接、性能、配置、Skill 开发等 7 大类 20+ 真实踩坑案例，提供针对性解决方案。
3. 命令大全：分类整理 OpenClaw 核心 CLI 指令，包括诊断、Gateway 管理、配置、频道、模型、Skill 及升级命令，支持快速检索。
4. 调优建议：Gateway 配置优化、Token 成本控制、缓存策略及模型参数调优等实战方案。
显著优点
- 权威体系化：内容由 OpenClaw 生态贡献，贴合官方架构设计，非第三方拼凑资料。
- 零配置本地服务：纯前端静态方案，无需数据库或外部依赖，离线可用。
- 交互友好：Web 可视化界面优于传统 Markdown 文档，支持截图示例与分类导航。
- 触发灵活：支持关键词唤醒（"启动/停止新手帮助"等），自然语言即可操控服务启停。
潜在局限
- 端口占用风险：固定 34567 端口，若用户本地已有服务占用需手动调整源码。
- 非自动启动：安装后需主动触发或手动执行
npm start，新手可能忽略此步骤。 - 内容静态更新：FAQ 内容随 Skill 版本发布，非实时云端同步，时效性依赖维护者更新。
- 安全边界：本地 HTTP 无认证，若部署于共享环境存在潜在暴露风险（尽管仅限 localhost）。
适合人群
- 首次接触 OpenClaw 的开发者与运维人员
- 需要快速查阅命令与排错手册的现网工程师
- 希望系统理解 AI 大模型工程架构的技术管理者
常规风险
- 端口冲突：与其他本地服务冲突导致启动失败。
- Node.js 环境依赖：需确保运行时环境版本兼容。
- 误操作停服：自然语言触发"停止新手帮助"可能意外中断正在查阅的服务。