# 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)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on a page URL with the `ask` query parameter:
```
GET https://yeasy.gitbook.io/openclaw_guide/readme.md?ask=<question>
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.