# OpenClaw 从入门到精通 | OpenClaw Guide

## Docs

- [《OpenClaw 入门到精通》](https://yeasy.gitbook.io/openclaw_guide/readme.md)
- [OpenClaw: Beginner to Expert](https://yeasy.gitbook.io/openclaw_guide/readme_en.md)
- [第一章 认识 OpenClaw](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/01_overview.md)
- [1.1 OpenClaw 是什么](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/01_overview/1.1_what_is_openclaw.md)
- [1.2 竞品对比与选型建议](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/01_overview/1.2_scenarios_comparison.md)
- [1.3 核心概念速览](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/01_overview/1.3_concepts.md)
- [1.4 典型应用场景](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/01_overview/1.4_use_cases.md)
- [1.5 本章小结](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/01_overview/summary.md)
- [第二章 环境准备与安装部署](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/02_setup.md)
- [2.1 系统要求与运行前检查](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/02_setup/2.1_requirements.md)
- [2.2 安装 OpenClaw](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/02_setup/2.2_installation.md)
- [2.3 初始化向导与首轮配置](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/02_setup/2.3_onboarding.md)
- [2.4 守护进程与可用性验收](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/02_setup/2.4_gateway_service.md)
- [2.5 本章小结](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/02_setup/summary.md)
- [第三章 快速上手与首轮对话实战](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/03_minimal_loop.md)
- [3.1 控制台与 Chat 快速上手](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/03_minimal_loop/3.1_control_ui_webchat.md)
- [3.2 常用诊断命令与日志排障](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/03_minimal_loop/3.2_diagnostics.md)
- [3.3 初始指令与智能体角色配置](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/03_minimal_loop/3.3_agent_persona.md)
- [3.4 本地访问边界与设备批准](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/03_minimal_loop/3.4_pairing_groups.md)
- [3.5 本章小结](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/03_minimal_loop/summary.md)
- [第四章 配置体系与模型治理](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/04_config_models.md)
- [4.1 openclaw.json 结构与配置优先级](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/04_config_models/4.1_config_system.md)
- [4.2 模型供应商接入与认证方式](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/04_config_models/4.2_provider_access.md)
- [4.3 模型选择与默认策略](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/04_config_models/4.3_model_selection.md)
- [4.4 故障转移基础：回退链路与恢复策略](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/04_config_models/4.4_failover.md)
- [4.5 本章小结](https://yeasy.gitbook.io/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/04_config_models/summary.md)
- [第五章 工具系统、技能与插件](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/05_tools_skills.md)
- [5.1 工具清单与调用范式](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/05_tools_skills/5.1_tool_inventory.md)
- [5.2 工具策略：允许、拒绝与分层策略](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/05_tools_skills/5.2_tool_policy.md)
- [5.3 技能机制：借助内置库固化指令](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/05_tools_skills/5.3_skills_plugins.md)
- [5.4 浏览器工具与网页自动化](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/05_tools_skills/5.4_browser_nodes.md)
- [5.5 本章小结](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/05_tools_skills/summary.md)
- [第六章 会话、上下文与记忆](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/06_context_memory.md)
- [6.1 会话模型与状态持久化](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/06_context_memory/6.1_sessions.md)
- [6.2 上下文构建与窗口预算](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/06_context_memory/6.2_context_building.md)
- [6.3 记忆机制：写入、检索与失效](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/06_context_memory/6.3_memory_mechanism.md)
- [6.4 压缩与裁剪：折叠与丢弃策略](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/06_context_memory/6.4_compaction_pruning.md)
- [6.5 本章小结](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/06_context_memory/summary.md)
- [第七章 多渠道分发与多智能体协作](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/07_multi_agent.md)
- [7.1 渠道接入与入口治理](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/07_multi_agent/7.1_telegram_whatsapp.md)
- [7.2 飞书专项接入指南：让它能在群里陪你聊天](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/07_multi_agent/7.2_lark_integration.md)
- [7.3 路由基础：从单智能体到多智能体](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/07_multi_agent/7.3_routing_basics.md)
- [7.4 协作模式：子智能体与广播组](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/07_multi_agent/7.4_collaboration_patterns.md)
- [7.5 本章小结](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/07_multi_agent/summary.md)
- [第八章 自动化与运维安全实践](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/08_automation_ops.md)
- [8.1 Hooks 生命周期与事件切入点](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/08_automation_ops/8.1_hooks.md)
- [8.2 定时作业设计与调度策略](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/08_automation_ops/8.2_cron_jobs.md)
- [8.3 Heartbeat 心跳机制：周期性巡检与主动通知](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/08_automation_ops/8.3_heartbeat.md)
- [8.4 远程访问：SSH、内网穿透与零信任](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/08_automation_ops/8.4_remote_access.md)
- [8.5 安全基线与审计流程](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/08_automation_ops/8.5_security_baseline.md)
- [8.6 本章小结](https://yeasy.gitbook.io/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/08_automation_ops/summary.md)
- [第九章 Gateway 控制平面与协议机制](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/09_gateway_protocol.md)
- [9.1 架构全景与五平面框架](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/09_gateway_protocol/9.1_architecture_overview.md)
- [9.2 控制平面职责与边界](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/09_gateway_protocol/9.2_control_plane.md)
- [9.3 连接生命周期：握手、认证与心跳](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/09_gateway_protocol/9.3_ws_handshake.md)
- [9.4 事件幂等与一致性保障](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/09_gateway_protocol/9.4_event_idempotency.md)
- [9.5 渠道配对与本地信任建立](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/09_gateway_protocol/9.5_pairing_trust.md)
- [9.6 本章小结](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/09_gateway_protocol/summary.md)
- [第十章 Agent Loop 运行内核剖析](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/10_agent_loop.md)
- [10.1 请求流转与分层排障](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/10_agent_loop/10.1_request_lifecycle.md)
- [10.2 π 运行底座与嵌入式集成](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/10_agent_loop/10.2_pi_framework.md)
- [10.3 入口、排队与并发控制](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/10_agent_loop/10.3_entry_queue.md)
- [10.4 提示词装配与结构化注入防护](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/10_agent_loop/10.4_prompt_assembly.md)
- [10.5 工具执行与结果回注](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/10_agent_loop/10.5_tool_execution.md)
- [10.6 流式输出、重试与提前终止](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/10_agent_loop/10.6_streaming_retry.md)
- [10.7 本章小结](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/10_agent_loop/summary.md)
- [第十一章 可靠性与安全机制实现](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/11_reliability_security.md)
- [11.1 多密钥治理：认证档案、环境轮换与 auth order](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/11_reliability_security/11.1_auth_profiles.md)
- [11.2 冷却与禁用：故障窗口内的止血机制](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/11_reliability_security/11.2_rotation_cooldown.md)
- [11.3 模型回退链路与错误分流](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/11_reliability_security/11.3_fallback_rules.md)
- [11.4 防护栏：工具策略、沙箱、审批与审计联动](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/11_reliability_security/11.4_guardrails.md)
- [11.5 本章小结](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/11_reliability_security/summary.md)
- [第十二章 插件扩展与生产落地](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/12_extension_engineering.md)
- [12.1 插件开发体系：自定义扩展的工程机制](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/12_extension_engineering/12.1_plugin_architecture.md)
- [12.2 自定义工具：把副作用关进可控边界](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/12_extension_engineering/12.2_custom_tools.md)
- [12.3 测试与调试：把扩展做成可回放的工程完整流程](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/12_extension_engineering/12.3_testing_debugging.md)
- [12.4 生产落地蓝图：扩展可控化](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/12_extension_engineering/12.4_production_blueprint.md)
- [12.5 主流框架互操作性指南](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/12_extension_engineering/12.5_framework_interoperability.md)
- [12.6 本章小结](https://yeasy.gitbook.io/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/12_extension_engineering/summary.md)
- [第十三章 实战案例集锦](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/13_practical_cases.md)
- [13.1 实战案例：企业飞书群工作助手](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/13_practical_cases/13.1_lark_slack_workbot.md)
- [13.2 实战案例：客户支持智能体](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/13_practical_cases/13.2_customer_support_agent.md)
- [13.3 垂直行业应用：场景对照与关键差异](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/13_practical_cases/13.3_vertical_industry_cases.md)
- [13.4 本章小结](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/13_practical_cases/summary.md)
- [第十四章 性能与成本优化实战](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/14_performance_cost.md)
- [14.1 Token 与上下文成本](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/14_performance_cost/14.1_token_context_cost.md)
- [14.2 延迟与吞吐优化](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/14_performance_cost/14.2_latency_throughput.md)
- [14.3 OpenClaw 的用量观测与预算控制](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/14_performance_cost/14.3_usage_budget.md)
- [14.4 不同规模部署预算模板](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/14_performance_cost/14.4_budget_templates.md)
- [14.5 本章小结](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/14_performance_cost/summary.md)
- [第十五章 故障诊断决策](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/15_troubleshooting_trees.md)
- [15.1 常见故障的分层诊断](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/15_troubleshooting_trees/15.1_diagnostic_decision_trees.md)
- [15.2 高并发故障诊断决策树与优化指南](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/15_troubleshooting_trees/15.2_high_concurrency_diagnosis.md)
- [15.3 本章小结](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/15_troubleshooting_trees/summary.md)
- [第十六章 与主流 AI 生态集成](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/16_claude_ecosystem.md)
- [16.1 Claude 模型接入与 MCP 生态集成](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/16_claude_ecosystem/16.1_claude_integration.md)
- [16.2 多智能体协作与编排模式](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/16_claude_ecosystem/16.2_agent_team_integration.md)
- [16.3 OpenAI 与本地模型集成](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/16_claude_ecosystem/16.3_other_ecosystems.md)
- [16.4 本章小结](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/16_claude_ecosystem/summary.md)
- [附录 参考资料与速查](https://yeasy.gitbook.io/openclaw_guide/fu-lu/appendix.md)
- [附录A：术语表](https://yeasy.gitbook.io/openclaw_guide/fu-lu/appendix/glossary.md)
- [附录B：配置模板与样例](https://yeasy.gitbook.io/openclaw_guide/fu-lu/appendix/config_templates.md)
- [附录C：故障排查检查单](https://yeasy.gitbook.io/openclaw_guide/fu-lu/appendix/troubleshooting_checklist.md)
- [附录D：API 与 SDK 参考](https://yeasy.gitbook.io/openclaw_guide/fu-lu/appendix/api_reference.md)
- [附录E：命令速查手册](https://yeasy.gitbook.io/openclaw_guide/fu-lu/appendix/command_cheatsheet.md)
- [附录F：版本映射与升级指南](https://yeasy.gitbook.io/openclaw_guide/fu-lu/appendix/version_mapping.md)
- [附录G：延伸阅读与参考资料](https://yeasy.gitbook.io/openclaw_guide/fu-lu/appendix/reading_list.md)
- [附录H：环境自检工具](https://yeasy.gitbook.io/openclaw_guide/fu-lu/appendix/env_check.md)
- [附录I：OpenClaw 命名演进史](https://yeasy.gitbook.io/openclaw_guide/fu-lu/appendix/naming_history.md)
- [附录J：快变事实核验表](https://yeasy.gitbook.io/openclaw_guide/fu-lu/appendix/volatile_facts.md)