OpenClaw 设计与实现
术语索引 / Terminology Index
格式:English Term — 中文译名 — 出现章节
A
ACP (Agent Client Protocol) — Agent 客户端协议(外部开放标准,见 agentclientprotocol.com;OpenClaw 既作为客户端把回合委托给外部编码 harness,也用 openclaw acp 运行以 Gateway 为后端的 ACP 桥接——在 stdio 上对 IDE 讲 ACP,再转成 Gateway WebSocket 调用) — 前言, Ch1, Ch2, Ch6, Ch13, Ch16, Ch18
Adapter — 适配器 — Ch1, Ch2, Ch4, Ch5, Ch7, Ch8, Ch9, Ch11, Ch17
Agent — 智能体 / Agent — 前言, Ch1–Ch18(全专栏)
AgentConfig — Agent 配置 — Ch6
Auth Profile — 认证配置 — Ch1, Ch2, Ch4, Ch6
Auto-Reply — 自动回复 — Ch12
B
BOOT.md — Gateway 启动自举文件(Gateway 启动后由 src/gateway/boot.ts 读取并执行;不要与新工作区首次运行的引导文件 BOOTSTRAP.md〔源码常量 DEFAULT_BOOTSTRAP_FILENAME〕混淆) — Ch3
Bridge — 桥接层 — Ch2, Ch6
Browser Automation — 浏览器自动化(作为扩展实现,位于 extensions/browser/) — Ch10
C
Canvas — 画布 — Ch10, Ch11
Capability-Based Tool Routing — 基于能力的工具路由 — Ch11
Channel — 通道(内置 9 个通道 ID,含扩展共 22 个) — 前言, Ch1, Ch2, Ch3, Ch4, Ch5, Ch6, Ch7, Ch8, Ch9, Ch10, Ch11, Ch13, Ch14, Ch15, Ch17, Ch18
Channel Abstraction — 通道抽象 — Ch1, Ch2, Ch7, Ch17
Channel Contract — 通道合约 — Ch7, Ch8
Channel Protocol Adaptation — 通道协议适配 — Ch8
ChannelPlugin — 通道插件接口 — Ch7, Ch8, Ch9
CLI (Command Line Interface) — 命令行界面 — Ch1, Ch2, Ch3, Ch6, Ch8, Ch9, Ch13, Ch14, Ch15, Ch18
Command Gating — 命令门控 — Ch7
Compaction — 上下文压缩 — Ch1, Ch2, Ch3, Ch4, Ch5
Config Matching — 配置匹配 — Ch7
Context Engine — 上下文引擎 — Ch2, Ch4, Ch5
Context Window — 上下文窗口 — Ch1, Ch2, Ch4, Ch5, Ch6, Ch9, Ch10, Ch11, Ch13, Ch14, Ch15, Ch16, Ch17, Ch18
Convention over Configuration — 约定优于配置 — Ch1, Ch2, Ch5, Ch13, Ch16, Ch18
Cron — 定时任务(调度依赖 croner;作业本身存在独立的 cron store,不写在配置文件里) — Ch1, Ch2, Ch3, Ch6, Ch12, Ch13, Ch14
CronService — 定时任务服务 — Ch12
D
Daemon — 守护进程(systemd / launchd / schtasks 三平台统一封装,见 src/daemon/service.ts) — Ch1, Ch2, Ch3, Ch14, Ch17
Declarative Agent Definition — 声明式 Agent 定义 — Ch6
Defense in Depth — 纵深防御 — Ch1, Ch13, Ch15, Ch17, Ch18
Design Pattern — 设计模式 — Ch17
Discord — Discord — Ch1, Ch2, Ch3, Ch6, Ch7, Ch8, Ch9, Ch13, Ch14, Ch15
DM Policy (dmPolicy) — 私信策略(pairing / allowlist / open / disabled,默认 pairing:陌生人先收到配对码、经运营者批准后才能对话;与节点的设备配对是两回事) — Ch2, Ch8, Ch13
Docker — Docker — Ch1, Ch3, Ch6, Ch13, Ch14, Ch15
Dual-Component Architecture — 双组件架构(CLI + TUI) — Ch14
E
Exec (Tool) — 命令执行工具(档位 deny / allowlist / full;tools.exec.security 未配置时按主机分流:沙箱取 deny,网关/节点取 allowlist;但 host=sandbox 时命令直接在容器内执行,不走档位与审批判定) — Ch6, Ch10, Ch13
Extension — 扩展 — Ch9
F
Fallback — 降级 / 回退 — Ch1, Ch2, Ch3, Ch4, Ch5, Ch6, Ch7, Ch16, Ch17, Ch18
Feishu / Lark — 飞书 — Ch8
G
Gateway — 网关(常驻进程;对 CLI、Control UI、移动端 App 与节点提供 WebSocket 控制面,以"请求/响应 + 事件推送"帧调用 Gateway 方法) — 前言, Ch1, Ch2, Ch3, Ch4, Ch6, Ch7, Ch8, Ch9, Ch10, Ch11, Ch12, Ch13, Ch14, Ch15, Ch17, Ch18
GatewayService — 网关服务类 — Ch3, Ch14
H
Heartbeat — 心跳 — Ch3, Ch5, Ch6, Ch7, Ch8, Ch11, Ch12, Ch14
Hook — 钩子 — 前言, Ch1, Ch2, Ch3, Ch9, Ch12, Ch17
Hot Reload — 热重载(gateway.reload.mode:off / restart / hot / hybrid,默认 hybrid) — Ch1, Ch3
I
Inbound Debounce — 入站防抖 — Ch7
J
Jiti — Jiti(运行时 TypeScript 加载器,插件加载器用它即时转译并加载 TS 模块) — Ch9
L
LLM (Large Language Model) — 大语言模型 — Ch1, Ch2, Ch4, Ch6
M
Memory (System) — 记忆系统(作为扩展实现,位于 extensions/memory-core/,不在 src/ 下) — Ch1, Ch2, Ch3, Ch5, Ch6, Ch10, Ch17, Ch18
Mention Gating — @提及门控 — Ch7
Message Normalization — 消息标准化 — Ch2, Ch7
Middleware — 中间件 — 前言, Ch17
Model Catalog — 模型目录 — Ch4
Modular Monolith — 模块化单体 — Ch2
N
Node (Device) — 节点(设备;先经设备配对 device.pair.*,再经节点配对 node.pair.* 由运营者批准) — 前言, Ch1, Ch2, Ch3, Ch6, Ch9, Ch10, Ch11, Ch12, Ch13, Ch15, Ch16, Ch17, Ch18
O
On-Demand Loading — 按需加载 — Ch15, Ch16, Ch17, Ch18
OpenClaw — OpenClaw — 全专栏
P
Plugin — 插件(原生插件与 Gateway 同进程运行,属受信代码、不在沙箱里;防线是安装扫描、allow/deny 与信任) — 前言, Ch1, Ch2, Ch3, Ch4, Ch5, Ch6, Ch7, Ch8, Ch9, Ch10, Ch16, Ch17, Ch18
PluginRegistry — 插件注册表 — Ch7, Ch9
PluginRuntime — 插件运行时 — Ch3, Ch7, Ch9
Proactive Agent — 主动 Agent — Ch12
Progressive Deployment — 渐进式部署 — Ch15
Progressive Disclosure — 渐进式复杂度 — Ch1, Ch2, Ch5, Ch9, Ch11, Ch13, Ch16, Ch18
Prompt (System Prompt) — 提示词(系统提示词) — Ch1, Ch2, Ch3, Ch4, Ch5, Ch6, Ch9, Ch14
Prompt Caching — 提示缓存 — Ch4, Ch15
Provider — 模型提供商(每个 provider 是 extensions/ 下的一个插件,靠 openclaw.plugin.json 的 providers 字段声明) — 前言, Ch1, Ch2, Ch3, Ch4, Ch5, Ch6, Ch7, Ch8, Ch9, Ch10, Ch11, Ch13, Ch17, Ch18
Provider Abstraction — Provider 抽象 — Ch1, Ch2, Ch4
R
Registry — 注册表 — Ch2, Ch3, Ch4, Ch5, Ch6, Ch7, Ch9, Ch10, Ch18
Restart Sentinel — 重启哨兵 — Ch3
Runtime — 运行时 — 前言, Ch1, Ch2, Ch6, Ch9, Ch17
S
SafeBins — 可免 allowlist 条目执行的"仅读 stdin"低风险流过滤器(tools.exec.safeBins;每项需有限定参数的 profile,普通命令应登记到审批白名单) — Ch10, Ch13
SecretRef — 凭证引用({ source: "env" | "file" | "exec", provider, id }) — Ch2, Ch13, Ch15
Security — 安全 — 前言, Ch1, Ch2, Ch3, Ch4, Ch5, Ch6, Ch7, Ch8, Ch9, Ch10, Ch11, Ch13, Ch14, Ch15, Ch16, Ch17, Ch18
Session — 会话 — Ch1, Ch2, Ch3, Ch4, Ch5, Ch6, Ch7, Ch8, Ch9, Ch10, Ch11, Ch12, Ch13, Ch14, Ch17, Ch18
Session Key — 会话键 — Ch2, Ch5, Ch6, Ch7
Signal — Signal — Ch8
Skill — 技能(SKILL.md + YAML frontmatter;从 extra、bundled、managed、personal、project、workspace 六个来源加载,高优先级同名技能完全替换低优先级) — 前言, Ch1, Ch2, Ch3, Ch6, Ch12, Ch16, Ch17, Ch18
Slack — Slack — Ch8
SSRF Protection — SSRF 防护 — Ch1, Ch10, Ch15
Stream / Streaming — 流式处理 — Ch1, Ch2, Ch4, Ch6, Ch7, Ch9, Ch14, Ch17
Sub-agent — 子代理 / 子 Agent — Ch1, Ch2, Ch3, Ch5, Ch6, Ch9, Ch17, Ch18
T
Telegram — Telegram — Ch1, Ch2, Ch3, Ch7, Ch8
Token — Token(令牌) — Ch2, Ch4, Ch5, Ch6, Ch7, Ch8, Ch12, Ch14, Ch15, Ch17, Ch18
Token Budget — Token 预算 — Ch4, Ch5, Ch16, Ch17, Ch18
Tool — 工具 — 前言, Ch1, Ch2, Ch3, Ch4, Ch5, Ch6, Ch7, Ch8, Ch9, Ch10, Ch11, Ch12, Ch13, Ch14, Ch15, Ch16, Ch17, Ch18
Tool Execution Loop — 工具调用循环 — Ch2, Ch15
Tool Policy Pipeline — 工具策略管线(7 级默认阶段,调用处再追加 sandbox 与 subagent 两级) — Ch6, Ch10, Ch13
Tree Orchestration — 树形编排模型(默认深度 DEFAULT_SUBAGENT_MAX_SPAWN_DEPTH = 1,即子 Agent 默认是叶子) — Ch18
TUI (Text User Interface) — 终端用户界面(openclaw tui;三模式输入:! 本地 Shell、/ TUI 命令、纯文本发给 Agent) — Ch14
W
WebSocket — WebSocket — Ch2, Ch3, Ch6, Ch7, Ch8, Ch11, Ch14, Ch15
Webhook — Webhook — Ch1, Ch3, Ch7, Ch8
WhatsApp — WhatsApp — Ch8
数字 / 符号
AGENTS.md — 工作区里的 Agent 工作规范文件(不是配置文件,配置在 ~/.openclaw/openclaw.json) — 前言, Ch1, Ch2, Ch5, Ch6, Ch11, Ch15
SKILL.md — 技能定义文件 — 前言, Ch1, Ch2, Ch16, Ch18
索引覆盖本专栏前言及第 1–18 章。术语释义已对照 openclaw/openclaw v2026.3.31(commit 213a704)核实。