# 附录A：术语表

本附录用于术语速查，按概念、渠道与运维三类组织，便于在正文阅读与排障中快速对齐含义。

## A.1 核心术语

* **Agent Loop（智能体循环）**：指从任务输入到最终执行结果的完整决策闭环，包括意图理解、工具规划、执行、验证与反馈阶段。
* **Agent Runtime（运行时内核）**：执行的核心引擎，负责接收归一化任务、组装提示词、发起模型调用以及截获并调度工具。
* **auth-profile（认证配置）**：模型供应商认证档案，通常由 `auth.profiles` 元数据与 `auth-profiles.json` 中的凭据共同组成，用于 API Key/OAuth、轮换、冷却与故障转移。
* **CalVer（日历版本）**：日历版本控制方案，OpenClaw 采用 CalVer 格式发布版本，例如 `v2026.3.12` 表示 2026 年 3 月 12 日发布。
* **Compaction（上下文压缩）**：将会话中早期的对话记录总结为高密度摘要，以释放窗口空间。
* **Context Window（上下文窗口）**：大模型在单次推理中能处理的最大输入输出 token 数量，决定了历史记录与检索上下文的容量上限。
* **Failover（故障转移）**：当主模型限流、超时或熔断时，系统自动降级到备用模型或链路的安全机制。
* **Gateway（网关/控制平面）**：负责外部连接（如 WebSocket/HTTP）、鉴权、设备配对、消息路由与系统级别的状态治理。
* **HEARTBEAT.md（心跳清单文件）**：放在工作区根目录的可选检查清单文件；默认 Heartbeat 提示词会引导智能体读取它，并按其中的待办或 `tasks:` 块执行周期性巡检。
* **Node（执行节点）**：与 Gateway WebSocket 配对的设备或 headless companion 进程，用于暴露本地屏幕、摄像头、系统工具等能力。
* **Pi（Agent 运行时）**：OpenClaw 底层使用的 AI 编码智能体运行时引擎，通过 Pi SDK 内嵌 `AgentSession`，负责模型推理、工具调用和任务执行；RPC/外部进程模式不是当前主路径。
* **Prompt Assembly（提示词组装）**：将用户任务、系统指令、历史对话、检索上下文等多个信号动态整合为一个完整的模型输入提示的过程。
* **Pruning（上下文裁剪）**：按优先级算法（如基于时间衰减或重要度评分），强制丢弃低价值的中间执行回执。
* **Session（会话/记忆容器）**：承载多轮任务连续性的抽象，内部维护了状态与短/长记忆快照。
* **Skill（技能）**：文本化的方法固化机制，用于把高频任务的步骤、约束与验收标准沉淀为可复用流程；与插件并行使用，插件扩展能力，技能固化方法。
* **SOUL.md（智能体身份配置）**：定义智能体个性、角色与行为约束的配置文件，用于独立控制单一智能体的价值观与决策偏向。
* **Tool（工具）**：大模型与外部系统交互的原子执行单元，通常被严格划分为“读工具”（安全）与“写工具”（需要幂等与审计）。
* **Token Budget（token 预算）**：为了避免超出模型的 Context Window，系统对输入的各个部分（历史、检索结果、指令等）分配的 token 额度。

## A.2 渠道与运维术语

* **Webhook**：外部系统通过 HTTP 回调主动触发 OpenClaw 任务的机制，用于异步事件驱动工作流。
* **Pairing（设备配对）**：通过设备身份、challenge-response、人工批准与令牌签发让新设备或 DM 发送者进入受信任集合；二维码或配对码只是常见引导方式之一。
* **Hook（生命周期切面）**：允许开发者在 Agent 调用的各个阶段（如提示词构建前、工具执行后）注入自定义逻辑的扩展点。
* **Cron（定时作业）**：OpenClaw Gateway 管理的定时任务系统，用于唤醒智能体执行自检、巡检、总结或清理任务，并在 `~/.openclaw/cron/` 下持久化任务状态。
* **Rate Limit（限流）**：对外部 API、模型调用或资源访问施加的流量上限，防止过载与配额超支。
* **Cooldown（冷却期）**：在重试或重新触发某个操作前，系统强制等待的最小时间间隔。
* **Circuit Breaker（熔断器）**：当某个依赖服务连续失败次数或错误率超过阈值时，系统主动断开连接、快速失败的保护机制。
* **Runbook（运维手册）**：记录处理系统故障、紧急回滚与例行排障步骤的标准文档。
* **Guardrail（安全护栏）**：由权限边界、沙箱隔离约束、内容风控引擎与审计系统等组合而成的防御矩阵集合。

## A.3 扩展与集成术语

* **MCP（Model Context Protocol）**：一个开放标准协议，允许 LLM 客户端与上下文服务器通信，便于在多种应用间安全传递结构化数据与工具定义。
* **Plugin（插件）**：扩展 OpenClaw 功能的模块化单元，可动态加载以增强工具库、数据源接入或自定义处理逻辑。
* **Extension（扩展）**：对 OpenClaw 核心或插件体系的深度定制与增强，通常涉及代码开发与配置修改。
* **Sandbox（沙箱）**：限制代码或工具执行权限与资源访问范围的隔离容器，防止恶意代码逃逸与未授权操作。
* **Exec Approval（执行审批）**：针对宿主机 `exec` / shell 命令执行的本地审批闸门，叠加在工具策略和 elevated gate 之上；它不是通用文件权限策略。
* **Trust Chain（信任链）**：从数据源到最终执行的完整验证链路，确保中间步骤的输出可被信任且未被篡改。
* **Vector Index（向量索引）**：基于 Embedding 的快速检索数据结构，用于在语义相似性搜索中加速查询。
* **Embedding（嵌入）**：将文本、代码或其他数据转换为高维向量表示的过程，用于语义相似性计算与检索。
* **Hybrid Search（混合搜索）**：结合关键词检索与语义相似性搜索的混合查询策略，提高检索准确率与召回率。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://yeasy.gitbook.io/openclaw_guide/fu-lu/appendix/glossary.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.