本附录列出全专栏引用的主要源码文件路径，按模块分组，方便读者快速定位相关代码。
如何使用本附录
本索引覆盖 OpenClaw 源码中 23 个子系统、213 个关键文件。每个条目包含三列信息：
- 文件路径：相对于仓库根目录的路径，可直接在 IDE 中
Ctrl+P 搜索打开
- 说明：该文件的核心职责（一句话概括）
- 相关章节：正文引用该文件的章节编号；少数正文未直接引用路径的文件，标注的是其所属主题的章节
阅读建议：初次阅读本专栏时无需逐行浏览本附录；当你在正文中遇到某个源码引用想了解其上下文时，回到这里按模块查找即可。如果你打算对 OpenClaw 进行二次开发，本索引也是快速建立代码地图的起点。
B.1 入口与核心
| 文件路径 |
说明 |
相关章节 |
src/entry.ts |
CLI 进程入口：启动前的环境预处理、根级 help 快路径，再转入 src/cli/run-main.ts |
第1、2、3章 |
B.2 配置系统（src/config/）
| 文件路径 |
说明 |
相关章节 |
src/config/types.ts |
配置类型定义（聚合导出） |
第3章 |
src/config/types.base.ts |
基础配置类型 |
第6章 |
src/config/types.gateway.ts |
Gateway 配置类型 |
第3章 |
src/config/types.agents.ts |
Agent 配置类型 |
第6章 |
src/config/types.channels.ts |
通道配置类型 |
第7章 |
src/config/types.tools.ts |
工具配置类型 |
第6、10、13章 |
src/config/types.skills.ts |
技能配置类型 |
第16章 |
src/config/types.cron.ts |
定时任务配置类型 |
第9、12章 |
src/config/types.secrets.ts |
凭证配置类型 |
第13章 |
src/config/types.models.ts |
模型配置类型 |
第9章 |
src/config/defaults.ts |
默认值与模型别名 |
第2、12章 |
src/config/schema.ts |
配置 Schema 生成 |
第3章 |
src/config/zod-schema.ts |
Zod Schema 定义 |
第8章 |
src/config/io.ts |
配置读写 I/O |
第3章 |
src/config/paths.ts |
配置路径解析 |
第1、2、3章 |
src/config/includes.ts |
配置文件 include 机制 |
第2、3章 |
src/config/env-vars.ts |
环境变量处理 |
第3章 |
src/config/env-substitution.ts |
环境变量替换 |
第2、3章 |
src/config/validation.ts |
配置校验 |
第3、6、9章 |
src/config/logging.ts |
配置写入后的提示输出（logConfigUpdated()、formatConfigPath()） |
第15章 |
src/config/sessions.ts |
会话存储相关模块的聚合导出（实现在 src/config/sessions/） |
第5章 |
src/config/port-defaults.ts |
默认端口定义 |
第3章 |
B.3 Gateway（src/gateway/）
| 文件路径 |
说明 |
相关章节 |
src/gateway/config-reload.ts |
配置热重载 |
第1、3、15章 |
src/gateway/config-reload-plan.ts |
重载计划生成 |
第3章 |
src/gateway/server-methods/config.ts |
Gateway config.* RPC 方法处理 |
第3章 |
src/gateway/protocol/schema/config.ts |
config.* 方法的协议参数 Schema |
第3章 |
B.4 Agent 系统（src/agents/）
| 文件路径 |
说明 |
相关章节 |
src/agents/system-prompt.ts |
系统提示组装 |
第1、2、6、12、16章 |
src/agents/tool-policy-pipeline.ts |
工具策略管线 |
第6、10、17章 |
src/agents/tool-policy.ts |
工具策略定义 |
第2、6、10章 |
src/agents/tool-catalog.ts |
工具目录 |
第6、10、18章 |
src/agents/openclaw-tools.ts |
OpenClaw 内置工具组装（createOpenClawTools()） |
第10章 |
src/agents/pi-tools.ts |
Agent 完整工具集装配（createOpenClawCodingTools()） |
第6、10章 |
src/agents/bash-tools.ts |
Exec/Process 工具的导出入口（实现在 src/agents/bash-tools.exec.ts、src/agents/bash-tools.process.ts） |
第10章 |
src/agents/model-selection.ts |
模型选择逻辑 |
第4章 |
src/agents/model-fallback.ts |
模型降级链 |
第1、2、4、6、17章 |
src/agents/model-catalog.ts |
模型目录 |
第1、4章 |
src/agents/models-config.ts |
模型配置 |
第4章 |
src/agents/provider-capabilities.ts |
Provider 能力发现 |
第4、9章 |
src/agents/provider-id.ts |
Provider ID 规范化 |
第4章 |
src/agents/defaults.ts |
Agent 默认值 |
第2、3、4章 |
src/agents/agent-scope.ts |
Agent 作用域 |
第2、6章 |
src/agents/compaction.ts |
上下文压缩 |
第2、5、17章 |
src/agents/context-window-guard.ts |
上下文窗口守卫 |
第4、6、17章 |
src/agents/session-write-lock.ts |
会话写锁 |
第5、18章 |
src/agents/usage.ts |
Token 用量统计 |
第4章 |
src/agents/failover-error.ts |
故障转移错误处理 |
第6章 |
src/agents/custom-api-registry.ts |
自定义 API 注册 |
第4、17章 |
src/agents/auth-profiles.ts |
认证 Profile |
第4、6章 |
src/agents/auth-profiles/usage.ts |
认证用量 |
第4、6章 |
src/agents/pi-embedded.ts |
Pi 嵌入式 Runner |
第6章 |
src/agents/pi-embedded-runner.ts |
Pi 嵌入式执行器 |
第4章 |
src/agents/pi-embedded-subscribe.ts |
Pi 嵌入式订阅 |
第4章 |
Sub-agent 系统
| 文件路径 |
说明 |
相关章节 |
src/agents/subagent-spawn.ts |
Sub-agent 创建 |
第6、18章 |
src/agents/subagent-control.ts |
Sub-agent 控制 |
第6章 |
src/agents/subagent-registry.ts |
Sub-agent 注册表 |
第6、17、18章 |
src/agents/subagent-announce.ts |
Sub-agent 完成通知 |
第6章 |
src/agents/subagent-depth.ts |
Sub-agent 深度控制 |
第6章 |
src/agents/subagent-lifecycle-events.ts |
Sub-agent 生命周期事件 |
第6章 |
src/agents/acp-spawn.ts |
ACP 模式 Sub-agent 创建 |
第6章 |
src/agents/acp-spawn-parent-stream.ts |
ACP 父流管理 |
第6章 |
技能系统
| 文件路径 |
说明 |
相关章节 |
src/agents/skills.ts |
技能加载主逻辑 |
第16章 |
src/agents/skills/config.ts |
技能配置 |
第16章 |
src/agents/skills/types.ts |
技能类型定义 |
第16章 |
src/agents/skills/workspace.ts |
技能工作区 |
第16、17章 |
src/agents/skills/env-overrides.ts |
技能环境变量覆盖 |
第16章 |
src/agents/skills-install.ts |
技能依赖安装 |
第16章 |
src/agents/skills/frontmatter.ts |
技能 frontmatter 与元数据解析 |
第16章 |
src/agents/skills/refresh.ts |
技能文件监视与快照刷新 |
第16章 |
src/agents/skills-status.ts |
技能依赖就绪度报告 |
第16章 |
src/plugins/install-security-scan.ts |
安装前安全扫描 |
第9、16章 |
工具系统
| 文件路径 |
说明 |
相关章节 |
src/agents/tools/sessions-spawn-tool.ts |
会话创建工具 |
第6章 |
src/agents/tools/sessions-send-tool.ts |
会话消息发送工具 |
第6章 |
B.5 ACP（src/acp/）
| 文件路径 |
说明 |
相关章节 |
src/acp/server.ts |
ACP 服务端 |
第6章 |
src/acp/client.ts |
ACP 客户端 |
第6、18章 |
src/acp/types.ts |
ACP 类型定义 |
第6章 |
src/acp/control-plane/manager.ts |
ACP 控制面管理器 |
第6章 |
src/acp/runtime/types.ts |
ACP 运行时类型 |
第6章 |
src/acp/runtime/session-identity.ts |
ACP 会话身份 |
第6章 |
B.6 通道系统（src/channels/）
| 文件路径 |
说明 |
相关章节 |
src/channels/registry.ts |
通道注册表 |
第7章 |
src/channels/ids.ts |
通道标识 |
第1、7章 |
src/channels/plugins/registry.ts |
通道插件注册表 |
第1、7章 |
src/channels/plugins/types.ts |
通道插件类型 |
第7章 |
src/channels/plugins/bundled.ts |
内置通道插件 |
第7章 |
src/channels/channel-config.ts |
通道配置 |
第7章 |
src/channels/session.ts |
通道会话 |
第7章 |
src/channels/run-state-machine.ts |
运行状态机 |
第7章 |
src/channels/typing.ts |
打字指示 |
第7章 |
src/channels/allow-from.ts |
来源白名单 |
第7章 |
src/channels/command-gating.ts |
命令门控 |
第7章 |
src/channels/mention-gating.ts |
@提及门控 |
第7章 |
src/channels/inbound-debounce-policy.ts |
入站防抖策略 |
第7章 |
B.7 通道实现（extensions/）
| 文件路径 |
说明 |
相关章节 |
extensions/telegram/src/channel.ts |
Telegram 通道实现 |
第8章 |
extensions/telegram/src/accounts.ts |
Telegram 账户管理 |
第8章 |
extensions/discord/src/channel.ts |
Discord 通道实现 |
第8章 |
extensions/whatsapp/src/channel.ts |
WhatsApp 通道实现 |
第8章 |
extensions/signal/src/channel.ts |
Signal 通道实现 |
第8章 |
extensions/slack/src/channel.ts |
Slack 通道实现 |
第8章 |
extensions/feishu/src/channel.ts |
飞书通道实现 |
第8章 |
extensions/feishu/src/accounts.ts |
飞书账户管理 |
第8章 |
extensions/feishu/src/conversation-id.ts |
飞书会话 ID 解析 |
第8章 |
B.8 插件系统（src/plugins/）
| 文件路径 |
说明 |
相关章节 |
src/plugins/registry.ts |
插件注册表 |
第9章 |
src/plugins/loader.ts |
插件加载器 |
第9章 |
src/plugins/types.ts |
插件类型定义 |
第9章 |
src/plugins/hooks.ts |
插件钩子系统 |
第9、12、17章 |
src/plugins/commands.ts |
插件命令 |
第9章 |
src/plugins/discovery.ts |
插件发现 |
第9章 |
src/plugins/config-schema.ts |
插件配置 Schema |
第9章 |
src/plugins/config-state.ts |
插件配置状态 |
第9章 |
src/plugins/runtime/index.ts |
插件运行时 |
第9章 |
src/plugins/runtime/types.ts |
运行时类型 |
第9章 |
src/plugin-sdk/config-runtime.ts |
SDK 运行时配置 |
第9章 |
src/plugin-sdk/config-paths.ts |
通道账户配置路径解析 |
第9章 |
B.9 浏览器自动化（extensions/browser/）
| 文件路径 |
说明 |
相关章节 |
extensions/browser/src/browser/profiles-service.ts |
浏览器 Profile 服务 |
第10章 |
extensions/browser/src/browser/navigation-guard.ts |
导航安全守卫 |
第10章 |
extensions/browser/src/browser/pw-role-snapshot.ts |
Playwright 角色快照 |
第10章 |
extensions/browser/src/browser/snapshot-roles.ts |
快照角色解析 |
第10章 |
extensions/browser/src/browser/url-pattern.ts |
URL 模式匹配 |
第10章 |
extensions/browser/src/browser/config.ts |
浏览器配置 |
第10、15章 |
B.10 Node 系统（src/node-host/）
| 文件路径 |
说明 |
相关章节 |
src/node-host/config.ts |
Node Host 配置 |
第11章 |
src/node-host/runner.ts |
Node Host 运行主循环 |
第11章 |
src/node-host/invoke.ts |
节点命令调用分发 |
第6、10、11、13章 |
src/node-host/exec-policy.ts |
节点侧 exec 策略 |
第11章 |
B.11 自动回复与钩子（src/auto-reply/）
| 文件路径 |
说明 |
相关章节 |
src/auto-reply/skill-commands.ts |
技能斜杠命令生成与解析 |
第16章 |
src/auto-reply/reply/config-commands.ts |
聊天内 /config 命令解析 |
第3章 |
src/auto-reply/reply/config-value.ts |
聊天内配置值格式化 |
第3章 |
src/auto-reply/reply/config-write-authorization.ts |
配置写入授权 |
第13章 |
B.12 凭证管理（src/secrets/）
| 文件路径 |
说明 |
相关章节 |
src/secrets/configure-plan.ts |
凭证配置计划 |
第13章 |
src/config/types.secrets.ts |
SecretRef 类型与解析 |
第13章 |
B.13 CLI（src/cli/）
| 文件路径 |
说明 |
相关章节 |
src/cli/run-main.ts |
CLI 主入口 |
第3章 |
src/cli/argv.ts |
CLI 参数解析 |
第14章 |
src/cli/banner.ts |
CLI 启动横幅 |
第14章 |
src/cli/banner-config-lite.ts |
Banner 的轻量配置读取 |
第14章 |
src/cli/program/build-program.ts |
Commander 程序装配 |
第14章 |
src/cli/program/core-command-descriptors.ts |
核心命令描述表 |
第14章 |
src/cli/program/subcli-descriptors.ts |
子 CLI 描述表 |
第14章 |
src/infra/cli-root-options.ts |
根级选项预扫描 |
第14章 |
src/cli/daemon-cli/lifecycle.ts |
网关服务 start/stop/restart |
第14章 |
src/cli/daemon-cli/restart-health.ts |
重启后端口健康轮询 |
第14、15章 |
src/cli/gateway-cli/run-loop.ts |
网关运行循环与信号处理 |
第15章 |
src/tui/tui-submit.ts |
TUI 三模式输入分发 |
第14章 |
B.14 日志（src/logging/）
| 文件路径 |
说明 |
相关章节 |
src/logging/config.ts |
日志配置 |
第15章 |
src/logging/logger.ts |
日志记录器 |
第15、18章 |
src/logging/redact.ts |
日志脱敏 |
第15章 |
src/logging/levels.ts |
日志级别定义 |
第15章 |
src/logging/console.ts |
控制台日志 |
第15章 |
src/logging/env-log-level.ts |
环境变量日志级别 |
第15章 |
B.15 上下文引擎（src/context-engine/）
| 文件路径 |
说明 |
相关章节 |
src/context-engine/types.ts |
Context Engine 类型定义 |
第5章 |
src/context-engine/registry.ts |
Context Engine 注册表 |
第2、5章 |
src/context-engine/legacy.ts |
Legacy Context Engine 实现 |
第5章 |
B.16 定时任务（src/cron/）
| 文件路径 |
说明 |
相关章节 |
src/cron/service.ts |
Cron 服务主入口 |
第12章 |
src/cron/service/ops.ts |
Cron 操作 |
第12章 |
src/cron/service/state.ts |
Cron 状态管理 |
第12章 |
src/cron/service/timer.ts |
Cron 定时器 |
第12章 |
src/cron/store.ts |
Cron 存储 |
第12章 |
src/cron/stagger.ts |
Cron 错峰调度 |
第12章 |
src/cron/types.ts |
Cron 类型定义 |
第12章 |
B.17 Daemon 管理（src/daemon/）
| 文件路径 |
说明 |
相关章节 |
src/daemon/service.ts |
Daemon 服务管理 |
第3、14、15章 |
src/daemon/systemd.ts |
systemd 集成 |
第3、14、15章 |
src/daemon/systemd-unit.ts |
systemd unit 文件生成 |
第15章 |
src/daemon/systemd-linger.ts |
systemd linger 配置 |
第15章 |
src/daemon/launchd.ts |
macOS launchd 集成 |
第3、14、15章 |
src/daemon/launchd-plist.ts |
launchd plist 生成 |
第15章 |
src/daemon/schtasks.ts |
Windows 计划任务 |
第3、14、15章 |
src/daemon/constants.ts |
Daemon 常量 |
第14、15章 |
src/daemon/diagnostics.ts |
Daemon 诊断 |
第15章 |
src/daemon/runtime-binary.ts |
运行时二进制定位 |
第14、15章 |
src/daemon/service-audit.ts |
服务审计 |
第14、15章 |
B.18 安全子系统（src/security/、src/infra/）
| 文件路径 |
说明 |
相关章节 |
src/security/audit.ts |
安全审计引擎 |
第10、13、17章 |
src/security/dangerous-tools.ts |
危险工具检测 |
第10、13章 |
src/security/dangerous-config-flags.ts |
危险配置标志 |
第13章 |
src/security/external-content.ts |
外部内容安全 |
第13章 |
src/security/fix.ts |
安全自动修复 |
第13章 |
src/infra/exec-approvals.ts |
Exec 审批流 |
第1、13章 |
src/infra/exec-safety.ts |
配置中可执行文件名/路径的安全校验（isSafeExecutableValue()） |
第10、13章 |
src/infra/net/ssrf.ts |
SSRF 防护 |
第1、10、15章 |
src/infra/heartbeat-runner.ts |
心跳运行器 |
第12章 |
B.19 会话管理（src/sessions/）
| 文件路径 |
说明 |
相关章节 |
src/sessions/session-id.ts |
会话 ID 生成 |
第5章 |
src/sessions/send-policy.ts |
发送策略 |
第5章 |
src/sessions/model-overrides.ts |
模型覆盖 |
第5章 |
src/sessions/level-overrides.ts |
会话级 verbose 级别覆盖 |
第5章 |
src/sessions/input-provenance.ts |
输入来源追踪 |
第5、6章 |
src/sessions/session-lifecycle-events.ts |
会话生命周期事件 |
第3、5章 |
src/sessions/transcript-events.ts |
对话记录事件 |
第3章 |
B.20 记忆系统（extensions/memory-core/）
| 文件路径 |
说明 |
相关章节 |
extensions/memory-core/src/memory/index.ts |
记忆系统入口 |
第5章 |
extensions/memory-core/src/memory/manager.ts |
记忆管理器 |
第5章 |
extensions/memory-core/src/memory/hybrid.ts |
混合搜索引擎 |
第5章 |
packages/memory-host-sdk/src/host/types.ts |
记忆类型定义 |
第5章 |
B.21 TUI（src/tui/）
| 文件路径 |
说明 |
相关章节 |
src/tui/tui.ts |
TUI 主入口 |
第14章 |
src/tui/commands.ts |
TUI 命令注册 |
第14章 |
src/tui/tui-command-handlers.ts |
TUI 命令处理器 |
第14章 |
src/tui/tui-event-handlers.ts |
TUI 事件处理器 |
第14章 |
src/tui/tui-formatters.ts |
TUI 格式化 |
第14章 |
src/tui/tui-local-shell.ts |
TUI 本地 Shell |
第14章 |
src/tui/tui-overlays.ts |
TUI 覆盖层 |
第14章 |
src/tui/theme/theme.ts |
TUI 主题 |
第14章 |
B.22 路由与基础设施
| 文件路径 |
说明 |
相关章节 |
src/routing/session-key.ts |
Session Key 路由解析 |
第2、5、7章 |
src/routing/resolve-route.ts |
路由解析 |
第2、7章 |
src/infra/backoff.ts |
退避策略 |
第15章 |
src/infra/gateway-lock.ts |
网关单实例锁 |
第15章 |
src/infra/restart.ts |
重启调度：延迟窗口、去重、冷却、跨平台触发 |
第3、15章 |
src/gateway/boot.ts |
Gateway 启动后执行工作区 BOOT.md 的自举检查 |
第1、3章 |
src/gateway/server-startup.ts |
Gateway 服务启动 |
第3、9章 |
src/gateway/server-restart-sentinel.ts |
重启哨兵实现 |
第3章 |
src/gateway/server-http.ts |
Gateway HTTP 服务与 /healthz、/readyz 探针 |
第3、15章 |
src/gateway/server-ws-runtime.ts |
Gateway WebSocket 运行时 |
第3章 |
src/gateway/channel-health-monitor.ts |
通道健康监控 |
第3、15章 |
src/gateway/auth-rate-limit.ts |
认证限速 |
第3章 |
B.23 部署文件
| 文件路径 |
说明 |
相关章节 |
Dockerfile |
Docker 多阶段构建 |
第15章 |
docker-compose.yml |
Docker Compose 编排 |
第15章 |
fly.toml |
Fly.io 部署配置 |
第15章 |
render.yaml |
Render 部署配置 |
第15章 |
.dockerignore |
构建上下文排除 |
第15章 |
说明：本索引以本专栏正文引用的源码路径为主编制，全部条目已对照 openclaw/openclaw v2026.3.31（commit 213a704）逐条核实存在。OpenClaw 仓库结构会随版本迭代变化，阅读更新版本的源码时请以对应 tag 为准。
两点容易踩的结构性事实：浏览器自动化和记忆系统都不在 src/ 下，而是作为扩展位于 extensions/browser/ 和 extensions/memory-core/；仓库根目录的 packages/ 存放工作区子包（如 packages/memory-host-sdk/，以及旧包名 clawdbot / moltbot 的兼容转发包），apps/ 存放 iOS/Android/macOS 伴侣应用；网关进程的核心代码在 src/ 下，内置扩展在 extensions/ 下、运行时加载进同一进程。