01 Intro - Cygnus Tech Bloghttps://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/01-intro/技术 × 产品 × 机器人Hugo 0.160.1 & FixIt v0.4.6-20260517062719-ed8ec5c2zh-CNruohuyang@163.com (Cygnus Yang)ruohuyang@163.com (Cygnus Yang)Sat, 23 May 2026 00:00:00 +0800第01章 OpenClaw 是什么 —— 自托管个人 AI 助手的终极形态https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/01-intro/01-what-is-openclaw/Sat, 23 May 2026 00:00:00 +0800ruohuyang@163.com (Cygnus Yang)https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/01-intro/01-what-is-openclaw/<p>你有没有想过：拥有一个<strong>完全属于你自己</strong>的 AI 助手，它可以：</p> <ul> <li>在你所有常用的聊天平台（WhatsApp/Telegram/Discord/iMessage）上工作</li> <li>本地运行，你的数据不会离开你的设备</li> <li>支持多个 AI 模型，你可以自由切换 Anthropic/OpenAI/Google 等等</li> <li>内置浏览器自动化，可以帮你自动浏览网页</li> <li>支持定时任务，定期帮你收集信息</li> <li>多智能体协作，让多个专家 AI 一起帮你解决复杂问题</li> <li>开放技能市场，你可以随时安装新技能</li> </ul> <p>这就是 <strong>OpenClaw</strong>。</p> <h2 class="heading-element" id="openclaw-定义"><span>OpenClaw 定义</span> <a href="#openclaw-%e5%ae%9a%e4%b9%89" class="heading-mark"> <svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg> </a> </h2><p>OpenClaw 是一个<strong>开源自托管个人 AI 助手网关</strong>，它帮你把 AI 能力接入到你日常使用的聊天平台，让 AI 随时随地陪伴你。</p>第02章 核心架构总览 —— Gateway 为什么是中心控制平面https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/01-intro/02-architecture-overview/Sat, 23 May 2026 00:00:00 +0800ruohuyang@163.com (Cygnus Yang)https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/01-intro/02-architecture-overview/<p>上一章我们介绍了 OpenClaw 是什么。本章我们来看整体架构，理解 Gateway 为什么是中心控制平面。</p> <h2 class="heading-element" id="设计目标"><span>设计目标</span> <a href="#%e8%ae%be%e8%ae%a1%e7%9b%ae%e6%a0%87" class="heading-mark"> <svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg> </a> </h2><p>OpenClaw 架构设计要解决几个问题：</p>第03章 Gateway —— 核心网关服务到底做了什么https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/01-intro/03-gateway/Sat, 23 May 2026 00:00:00 +0800ruohuyang@163.com (Cygnus Yang)https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/01-intro/03-gateway/<p>上一章我们说了 Gateway 是中心控制平面。本章我们深入讲解 Gateway 核心服务，看它具体做了哪些事情。</p> <h2 class="heading-element" id="gateway-定位"><span>Gateway 定位</span> <a href="#gateway-%e5%ae%9a%e4%bd%8d" class="heading-mark"> <svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg> </a> </h2><p>Gateway 不是 AI 模型本身，它是<strong>胶水层</strong>：</p>第04章 多渠道接入 —— 如何支持 25+ 聊天平台https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/01-intro/04-multi-channel-inbox/Sat, 23 May 2026 00:00:00 +0800ruohuyang@163.com (Cygnus Yang)https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/01-intro/04-multi-channel-inbox/<p>OpenClaw 最方便的一点就是：<strong>你不用换聊天软件</strong>，AI 直接出现在你天天都用的聊天软件里。</p> <p>本章我们讲解 OpenClaw 怎么做到支持 25+ 聊天平台，架构设计是什么样的。</p> <h2 class="heading-element" id="什么是多渠道接入"><span>什么是多渠道接入</span> <a href="#%e4%bb%80%e4%b9%88%e6%98%af%e5%a4%9a%e6%b8%a0%e9%81%93%e6%8e%a5%e5%85%a5" class="heading-mark"> <svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg> </a> </h2><p>&ldquo;多渠道&quot;就是：</p>第05章 ACP —— 如何对接外部 AI 客户端https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/01-intro/05-acp/Sat, 23 May 2026 00:00:00 +0800ruohuyang@163.com (Cygnus Yang)https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/01-intro/05-acp/<p>如果你已经在本机装了 Codex、Claude Code、Gemini CLI、OpenCode 这类外部编码代理，OpenClaw 不需要重造一套运行时。它可以通过 <strong>ACP agents</strong> 把这些外部 harness 接进自己的会话体系里。</p> <p>这一章只讲当前源码里的真实能力，不讲已经废弃或不存在的旧接口。</p> <h2 class="heading-element" id="什么是-acp"><span>什么是 ACP</span> <a href="#%e4%bb%80%e4%b9%88%e6%98%af-acp" class="heading-mark"> <svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg> </a> </h2><p>ACP 指的是 <strong>Agent Client Protocol</strong>。在 OpenClaw 里，它的作用很明确：</p>第06章 消息路由 —— 消息如何正确送到对的会话https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/01-intro/06-routing/Sat, 23 May 2026 00:00:00 +0800ruohuyang@163.com (Cygnus Yang)https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/01-intro/06-routing/<p>OpenClaw 的路由不是“模型自己决定回复到哪里”，而是 <strong>Gateway 按确定性规则选定 agent 和 session key</strong>。当前源码里，这套逻辑主要围绕 <code>bindings</code>、<code>session key</code> 和线程绑定展开。</p> <h2 class="heading-element" id="路由真正解决的问题"><span>路由真正解决的问题</span> <a href="#%e8%b7%af%e7%94%b1%e7%9c%9f%e6%ad%a3%e8%a7%a3%e5%86%b3%e7%9a%84%e9%97%ae%e9%a2%98" class="heading-mark"> <svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg> </a> </h2><p>路由层要同时回答两个问题：</p>第07章 安全模型 —— 配对白名单如何保护你https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/01-intro/07-security-model/Sat, 23 May 2026 00:00:00 +0800ruohuyang@163.com (Cygnus Yang)https://cygnusyang.github.io/posts/01-ai-%E5%B7%A5%E5%85%B7%E4%B8%8E%E6%99%BA%E8%83%BD%E4%BD%93/01-openclaw/01-intro/07-security-model/<p>OpenClaw 跑在你自己服务器上，对外开放吗？谁能访问你的 AI？这就是安全模型要解决的问题。</p> <p>OpenClaw 默认安全策略：<strong>默认拒绝，手动配对允许</strong>。本章我们讲解这个设计。</p> <h2 class="heading-element" id="威胁模型"><span>威胁模型</span> <a href="#%e5%a8%81%e8%83%81%e6%a8%a1%e5%9e%8b" class="heading-mark"> <svg class="octicon octicon-link" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg> </a> </h2><p>你把 Gateway 暴露在互联网上，可能的威胁：</p>