OpenClaw 设计与实现

术语索引 / Terminology Index

作者 杨艺韬 · 1,607 字 · 发布于 · 更新于

格式: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)核实。