{"id":47704061,"url":"https://github.com/yeasy/openclaw_guide","last_synced_at":"2026-04-02T17:49:29.741Z","repository":{"id":339723306,"uuid":"1162903259","full_name":"yeasy/openclaw_guide","owner":"yeasy","description":"OpenClaw 入门和实战，安装、使用、配置到实现原理 | OpenClaw Guide","archived":false,"fork":false,"pushed_at":"2026-03-31T15:48:25.000Z","size":1833,"stargazers_count":82,"open_issues_count":0,"forks_count":15,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-31T17:43:32.529Z","etag":null,"topics":["book","learning","openclaw","tutorial"],"latest_commit_sha":null,"homepage":"https://yeasy.gitbook.io/openclaw_guide/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yeasy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-20T20:53:55.000Z","updated_at":"2026-03-31T15:48:29.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/yeasy/openclaw_guide","commit_stats":null,"previous_names":["yeasy/openclaw_guide"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/yeasy/openclaw_guide","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yeasy%2Fopenclaw_guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yeasy%2Fopenclaw_guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yeasy%2Fopenclaw_guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yeasy%2Fopenclaw_guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yeasy","download_url":"https://codeload.github.com/yeasy/openclaw_guide/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yeasy%2Fopenclaw_guide/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31312737,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["book","learning","openclaw","tutorial"],"created_at":"2026-04-02T17:49:29.031Z","updated_at":"2026-04-02T17:49:29.735Z","avatar_url":"https://github.com/yeasy.png","language":null,"readme":"[English overview](README_en.md)\n\n\u003cdiv align=\"center\"\u003e\n\n# 《OpenClaw 入门到精通》\n\n[![License: CC BY 4.0](https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)\n[![GitHub stars](https://img.shields.io/github/stars/yeasy/openclaw_guide?style=social)](https://github.com/yeasy/openclaw_guide)\n[![Release](https://img.shields.io/github/release/yeasy/openclaw_guide.svg)](https://github.com/yeasy/openclaw_guide/releases)\n[![Online Reading](https://img.shields.io/badge/在线阅读-GitBook-brightgreen)](https://yeasy.gitbook.io/openclaw_guide)\n[![PDF](https://img.shields.io/badge/PDF-下载-orange)](https://github.com/yeasy/openclaw_guide/releases/latest)\n\n\u003e **[OpenClaw](https://github.com/openclaw/openclaw) 是一款开源自驱型智能体**，由 Peter Steinberger 创建。本书结合最佳实践，提供从入门到应用的全流程指南，并深度解构其底层的运行机制和实现原理。\n\n\u003cimg src=\"cover.jpg\" alt=\"OpenClaw Guide Cover\" width=\"300\" /\u003e\n\n\u003c/div\u003e\n\n## 本书特色\n\n- **实战导向**：从零到一搭建最小闭环，提供可直接复用的配置模板\n- **机制剖析**：深入解析 Gateway、Agent Loop、工具系统、会话与记忆等核心机制\n- **生产就绪**：聚焦可靠性、安全加固、运行监控与故障排查\n\n## 目标读者与前置要求\n\n- **目标读者**：对 AI 智能体感兴趣的个人用户、AI 应用开发者、大模型落地工程师、系统架构师等。\n- **前置基础**：阅读本书需要了解基本的后端开发常识（如 Node.js 或 Python 基础），并对大语言模型 (LLM) 和 AI 智能体有初步概念。可参考 [《零基础学 AI》](https://yeasy.gitbook.io/ai_beginner_guide) 和 [《智能体 AI 权威指南》](https://yeasy.gitbook.io/agentic_ai_guide) 建立基础。\n\n## 全书结构\n\n| 部分 | 章节 | 内容概要 |\n|------|------|----------|\n| 第一部分：基础入门 | 第 1–4 章 | 全景概览、环境搭建、首次会话、配置与模型接入 |\n| 第二部分：进阶使用 | 第 5–8 章 | 工具与技能、上下文记忆、多智能体协作、自动化运维 |\n| 第三部分：实现原理与工程落地 | 第 9–12 章 | Gateway 协议、Agent Loop 内核、可靠性机制、插件扩展 |\n| 第四部分：实战与优化深度指南 | 第 13–16 章 | 实战案例、性能与成本优化、故障排查决策树、主流 AI 生态集成 |\n| 附录 | — | 术语表、配置模板与样例、故障排查检查单、API 与 SDK 参考、命令速查手册、版本映射与升级指南、延伸阅读与参考资料 |\n\n## 阅读方式\n\n### 在线阅读\n\n- [GitBook 在线版本](https://yeasy.gitbook.io/openclaw_guide/)\n- [从第一章开始阅读](01_overview/README.md)\n\n## 下载离线版本\n\n本书提供 PDF 版本供离线阅读，可前往 [GitHub Releases](https://github.com/yeasy/openclaw_guide/releases/latest) 页面下载最新版本。\n\n### 本地预览\n\n本仓库当前使用 mdPress 构建，本地预览建议直接使用仓库脚本：\n\n```bash\nbrew tap yeasy/tap \u0026\u0026 brew install mdpress\nmdpress serve\n```\n\n如果你偏好其他 Markdown 预览器，也可以作为辅助工具使用，但它们并不是本仓库的标准构建链。\n\n## 五分钟快速上手\n\n还没用过 OpenClaw？只需三步即可体验：\n\n1. **安装**（1分钟）：`curl -fsSL https://openclaw.ai/install.sh | bash`\n2. **初始化**（2分钟）：`openclaw` → 按向导配置模型密钥\n3. **对话**（2分钟）：在 WebChat 输入“你好”，收到 AI 回复即成功 🎉\n\n详见 [第二章：环境搭建](02_setup/README.md) 和 [第三章：首次会话](03_minimal_loop/README.md)。\n\n## 学习路线图\n\n不同角色的读者可以按需选择阅读路径：\n\n```mermaid\ngraph LR\n    START[\"开始\"] --\u003e Q{\"你的角色？\"}\n    Q --\u003e|\"个人玩家\u003cbr/\u003e想快速用起来\"| P1[\"第1章 概览\u003cbr/\u003e→ 第2-3章 安装与首次会话\u003cbr/\u003e→ 第5章 工具与技能\"]\n    Q --\u003e|\"应用开发者\u003cbr/\u003e想深度定制\"| P2[\"第1-4章 基础\u003cbr/\u003e→ 第5-7章 工具/记忆/多智能体\u003cbr/\u003e→ 第12章 插件扩展\"]\n    Q --\u003e|\"企业运维\u003cbr/\u003e想生产部署\"| P3[\"第2-3章 快速上手\u003cbr/\u003e→ 第8章 自动化运维\u003cbr/\u003e→ 第11章 可靠性与安全\u003cbr/\u003e→ 第14-15章 优化与排障\"]\n    Q --\u003e|\"架构师\u003cbr/\u003e想理解原理\"| P4[\"第1章 概览\u003cbr/\u003e→ 第9-10章 Gateway与Agent Loop\u003cbr/\u003e→ 第12章 扩展工程\u003cbr/\u003e→ 第16章 AI生态集成\"]\n    P1 --\u003e ADV[\"进阶：按需选读其余章节\"]\n    P2 --\u003e ADV\n    P3 --\u003e ADV\n    P4 --\u003e ADV\n```\n\n| 角色 | 核心章节 | 预计用时 | 学完能做什么 |\n|------|---------|---------|------------|\n| 🎮 个人玩家 | 1→2→3→5 | 2-3 小时 | 搭建个人 WhatsApp/Telegram AI 助手 |\n| 💻 应用开发者 | 1-7→12 | 8-10 小时 | 开发自定义工具、技能和多智能体系统 |\n| 🔧 企业运维 | 2→3→8→11→14→15 | 6-8 小时 | 生产环境部署、安全加固与故障排查 |\n| 🏗️ 架构师 | 1→9→10→12→16 | 6-8 小时 | 理解底层原理，设计企业级智能体架构 |\n\n## 推荐阅读\n\n本书是 AI 技术丛书的一部分。以下书籍与本书形成互补：\n\n| 书名 | 与本书的关系 |\n|------|------------|\n| [《零基础学 AI》](https://yeasy.gitbook.io/ai_beginner_guide) | AI 零基础入门，适合缺乏 AI 背景的读者 |\n| [《大模型提示词工程指南》](https://yeasy.gitbook.io/prompt_engineering_guide) | 智能体提示词设计的理论基础 |\n| [《大模型上下文工程权威指南》](https://yeasy.gitbook.io/context_engineering_guide) | 智能体的上下文管理与记忆架构设计 |\n| [《Claude 技术指南》](https://yeasy.gitbook.io/claude_guide) | Claude 的 MCP 协议、工具使用与 Agentic Coding |\n| [《智能体 AI 权威指南》](https://yeasy.gitbook.io/agentic_ai_guide) | 智能体的通用架构与多智能体协作模式 |\n| [《大模型安全权威指南》](https://yeasy.gitbook.io/ai_security_guide) | 智能体系统的安全设计与攻防实践 |\n| [《大模型原理与架构》](https://yeasy.gitbook.io/llm_internals) | 深入理解大语言模型底层逻辑与架构 |\n\n## 贡献与反馈\n\n欢迎提交 [Issue](https://github.com/yeasy/openclaw_guide/issues) 或 [PR](https://github.com/yeasy/openclaw_guide/pulls)，尤其欢迎：错别字修正、失效链接修复、实践案例补充与可复用模板。\n\n## 许可证\n\n本书采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权。\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyeasy%2Fopenclaw_guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyeasy%2Fopenclaw_guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyeasy%2Fopenclaw_guide/lists"}