OpenClaw Agent 架构深度解析:AI 网关的设计哲学

// Gateway 启动后，所有渠道收敛于一个 WebSocket 端口// 默认：ws://127.0.0.1:18789// 客户端连接示例{  type: "req",  method: "connect",  params: {    auth: { token: "xxx" },    device: { id: "macbook-pro", platform: "darwin" }  }}

// 传统方式（子进程）const child = spawn('pi', ['--prompt', message]);child.stdout.on('data', handleOutput);// OpenClaw 方式（嵌入式）const { session } = await createAgentSession({  cwd: workspaceDir,  model: 'claude-sonnet-4-20250514',  tools: openClawTools,  // 自定义工具集  sessionManager: SessionManager.open(sessionFile)});await session.prompt(message);

sequenceDiagram    participant Channel    participant Gateway    participant Agent    participant Tools    Channel->>Gateway: 消息到达    Gateway->>Gateway: 入队 (Session Lane)    Gateway->>Agent: 创建会话 + 注入上下文    Agent->>Agent: 构建系统提示 (Skills + Bootstrap)    Agent->>Agent: 调用 LLM    Agent->>Tools: 执行工具 (exec/read/browser...)    Tools-->>Agent: 返回结果    Agent-->>Gateway: 流式输出 (assistant/tool 事件)    Gateway-->>Channel: 回复消息    Gateway->>Gateway: 持久化会话 (JSONL)

// Session Lane：每会话一个队列，保证串行// Global Lane：所有会话共享，控制并发上限// 配置示例{  agents: {    defaults: {      maxConcurrent: 4  // 最多 4 个会话并行执行    }  },  messages: {    queue: {      mode: "collect",      // 合并多条消息为一次运行      debounceMs: 1000,     // 等待 1 秒静默期      cap: 20,              // 最多排队 20 条      drop: "summarize"     // 溢出时生成摘要    }  }}

{"id":"turn-1","parentId":null,"role":"user","content":"帮我查天气"}{"id":"turn-2","parentId":"turn-1","role":"assistant","content":"好的..."}{"id":"turn-3","parentId":"turn-2","role":"tool","name":"exec","result":"25°C"}

---name: feishu-bitabledescription: 飞书多维表格管理metadata: {  "openclaw": {    "requires": {      "bins": ["node"],      "env": ["FEISHU_APP_ID"],      "config": ["channels.feishu.enabled"]    }  }}---

// Agent Run 开始前process.env.FEISHU_APP_ID = "app_123";  // 注入技能所需环境变量// Agent Run 结束后process.env.FEISHU_APP_ID = original;   // 恢复原始环境

// Controller@PostMapping("/weather")public Response checkWeather(@RequestBodyMessage msg) {    String weather = weatherService.getWeather("北京");    messageService.sendToGroup(msg.getGroupId(), weather);    return Response.ok();}// 需要：API 路由、参数校验、服务层、消息队列、错误重试...

# SKILL.md 定义能力当用户查询天气时，使用 `weather` 工具获取数据当用户要求发送消息时，使用 `message` 工具发送# 系统自动处理- 意图识别（LLM）- 工具调用（weather → message）- 错误重试（自动）- 结果回复（流式输出）

// OpenClaw 的工具审批机制{  tools: {    exec: {      approval: "always",  // 所有 exec 命令需要人工审批      allowlist: ["git", "npm test"],  // 或者白名单命令      denylist: ["rm -rf", "curl | bash"]  // 或者黑名单命令    }  }}

相关阅读：

• 普通人上手 Deepseek 的实用攻略

• 近期爆火的 AI Agent，运行原理全解析

• 私藏多年的系统性能优化十大绝招（万字干货）

• 面对复杂业务系统，通用架构设计法则

• 高可用高性能核心原理探究，Kafka 核心全面总结

• 服务接口优化的常见方案实战总结

• 聊聊分布式服务下的八种异步实现方式

• 有没有那么一瞬间，你也曾有过“失业焦虑”？
• 浅析分布式系统中的补偿机制设计问题
• 聊聊分布式日志系统的设计与实践
• 执行个 DEL 竟然也会阻塞 Redis？深挖一下果然不简单
• PHP 中数组是如何灵活支持多数据类型的？
• 一文带你看通透，MySQL事务ACID四大特性实现原理

• 通过alter table 来实现重建表，同事大呼开眼界了

• 实习生疑问：为什么要在需要排序的字段上加索引呢？

• 代码多版改造，应用责任链设计模式