openclaw的commands-ststem-prompt 翻译

提示词翻译文档

元信息

• 原文件位置: src/auto-reply/reply/commands-system-prompt.ts
• 函数名称: resolveCommandsSystemPromptBundle()
• 功能模块: 命令系统提示词解析
• 调用场景: 处理用户命令时解析完整的系统提示词包

中文翻译

此函数负责解析命令处理所需的完整系统提示词包。

返回类型

export type CommandsSystemPromptBundle = {
  systemPrompt: string;           // 系统提示词
  tools: AgentTool[];             // 可用工具列表
  skillsPrompt: string;           // 技能提示词
  bootstrapFiles: WorkspaceBootstrapFile[];  // 引导文件
  injectedFiles: EmbeddedContextFile[];      // 注入的上下文文件
  sandboxRuntime: SandboxRuntimeStatus;      // 沙箱运行时状态
};

处理流程

1. 解析引导文件和上下文文件

   const { bootstrapFiles, contextFiles: injectedFiles } = 
     await resolveBootstrapContextForRun({
       workspaceDir,
       config: params.cfg,
       sessionKey: params.sessionKey,
       sessionId: params.sessionEntry?.sessionId,
     });
   

2. 构建技能快照

   const skillsSnapshot = buildWorkspaceSkillSnapshot(workspaceDir, {
     config: params.cfg,
     eligibility: { remote: getRemoteSkillEligibility() },
     snapshotVersion: getSkillsSnapshotVersion(workspaceDir),
   });
   

3. 解析沙箱运行时状态

   const sandboxRuntime = resolveSandboxRuntimeStatus({
     cfg: params.cfg,
     sessionKey: params.ctx.SessionKey ?? params.sessionKey,
   });
   

4. 创建工具

   const tools = createOpenClawCodingTools({
     config: params.cfg,
     agentId: params.agentId,
     workspaceDir,
     sessionKey: params.sessionKey,
     messageProvider: params.command.channel,
     // ... 其他参数
   });
   

5. 构建系统提示词

   const systemPrompt = buildAgentSystemPrompt({
     workspaceDir,
     defaultThinkLevel: params.resolvedThinkLevel,
     reasoningLevel: params.resolvedReasoningLevel,
     toolNames,
     toolSummaries,
     skillsPrompt,
     // ... 其他参数
   });
   

关键参数

• params: HandleCommandsParams 类型，包含命令处理的所有参数
  • workspaceDir: 工作空间目录
  • cfg: OpenClaw 配置
  • sessionKey: 会话标识
  • command: 用户命令
  • agentId: Agent ID
  • model: 当前模型

相关代码上下文

此函数在命令处理流程中被调用，用于：

• 准备 Agent 运行所需的所有上下文
• 构建完整的系统提示词
• 获取可用工具列表
• 确定沙箱状态

调用位置：

• src/auto-reply/reply/ 目录下的回复处理逻辑