随笔分类 - 流行框架的源代码分析
process.ts —— OpenClaw 如何像开发者一样管理后台进程
摘要:关键词:进程管理|服务监控|日志追踪|自动恢复|权限隔离|状态快照 在现代开发运维中,“部署”只是开始,真正的挑战在于服务的持续运行与可观测性。一个合格的开发者会: 启动 Web 服务并确认其监听端口 实时跟踪日志中的错误 在崩溃后自动重启 根据资源使用调整配置 OpenClaw 的 src/age
阅读全文
exec.ts 下篇 —— OpenClaw用户审批、后台任务与权限提升控制
摘要:关键词:用户审批|后台任务|权限提升|交互式终端|租户隔离|超时熔断 在上一篇中,我们介绍了 OpenClaw exec.ts 的三层隔离模型(Sandbox / Gateway / Remote),为 Shell 命令执行建立了基础安全边界。然而,真正的挑战在于运行时控制:当 AI 提出一个高风险
阅读全文
exec.ts 上篇 —— OpenClaw 安全执行 Shell 命令的三层隔离模型
摘要:关键词:安全执行|沙箱隔离|Docker|权限提升|用户审批|环境注入 在 AI 智能体系统中,工具调用(Tool Calling)是实现“行动能力”的核心。而其中最强大也最危险的能力,莫过于执行任意 Shell 命令——它能让 AI 重启服务、部署代码、分析日志,但也可能被滥用为“删库跑路”的入口
阅读全文
长期记忆与会话同步 —— 如何让OpenClaw记住跨天对话
摘要:关键词:长期记忆|会话持久化|增量同步|上下文压缩|跨设备一致性 在传统聊天机器人中,对话一旦关闭,上下文即被遗忘。但人类的交流是连续的——今天讨论的项目,明天可能继续推进;上周提到的偏好,下周仍应被尊重。 OpenClaw 的目标是让 AI 智能体具备类人的记忆能力:不仅能记住单次对话,还能在跨天
阅读全文
向量检索实战 —— OpenClaw 如何实现混合搜索(向量 + 全文)
摘要:关键词:混合检索|向量数据库|SQLite FTS5|ONNX 嵌入|相似度归一化|候选重排序 在上一篇中,我们了解了 OpenClaw 记忆系统的配置体系。但配置只是“蓝图”,真正的挑战在于如何高效、准确、低延迟地执行检索。尤其当系统需同时处理: 用户历史对话(非结构化文本) 企业知识库(PDF/
阅读全文
OpenClaw记忆系统基石 —— memory-search.ts 中的 RAG 配置解析与合并逻辑
摘要:关键词:RAG|配置合并|向量检索|全文搜索|路径解析|数值校验 在 AI 智能体系统中,“记忆”是实现上下文延续性与知识个性化的关键能力。OpenClaw 的记忆系统不仅支持长期会话回溯,还能接入企业知识库、个人笔记甚至实时文件,形成一个动态、可扩展的混合检索引擎。 这一切的起点,是 src/ag
阅读全文
run.ts 下篇 —— OpenClaw故障转移、重试策略与结果封装
摘要:关键词:Failover|多级重试|错误分类|幂等性|结果标准化 在上一篇中,我们探讨了 run.ts 如何通过模型调度、账号轮询与上下文压缩构建第一道防线。然而,在真实生产环境中,失败是常态——网络抖动、模型返回乱码、工具执行超时……系统必须具备智能的故障转移(Failover)能力。 本文将深入
阅读全文
run.ts 上篇 —— OpenClaw模型调度、账号轮询与上下文守护机制
摘要:关键词:LLM 调度|API Key 轮询|上下文压缩|Token 监控|弹性推理 在 OpenClaw 的智能体系中,src/agents/run.ts 是真正的“心脏”——它负责将用户请求转化为一次完整的 AI 推理过程。这个看似简单的函数,实则承载了高可用、自适应、安全可控三大工业级要求。 本
阅读全文
启动与配置体系 —— openclaw.mjs、config.yaml 与环境变量管理
摘要:关键词:配置分层|CLI 入口|YAML 解析|敏感信息隔离|环境注入 一个工业级系统能否被可靠部署、灵活调优和安全运维,很大程度上取决于其配置管理能力。OpenClaw 作为支持多模型、多渠道、多租户的 AI 智能体网关,必须在“开箱即用”与“精细控制”之间找到平衡。 为此,OpenClaw 设计
阅读全文
OpenClaw 配置完全指南:从零开始掌握 AI 网关设置
摘要:OpenClaw 的配置系统是其强大功能的基石。无论你是第一次接触的新手,还是需要精细调优的资深用户,本文都将带你全面掌握从基础设置到高级功能的每一个细节。 配置文件位置 路径:~/.openclaw/openclaw.json 格式:JSON5 (支持注释 // 和尾随逗号 ,) 机制:可选配置。
阅读全文
OpenClaw 配置参考大全:从入门到精通
摘要:OpenClaw 拥有超过 200 个可配置项,构建了极其灵活的系统。本文是 ~/.openclaw/openclaw.json 的完整字段参考手册。无论你是初次上手的新手,还是查找特定参数的高级用户,都能在此找到答案。 格式说明 配置文件采用 JSON5 格式,支持注释 // 和尾随逗号 ,。 所
阅读全文
OpenClaw 配置全景指南:从入门到精通
摘要:OpenClaw 的配置系统以灵活和强大著称,但丰富的选项也让新手望而却步。本文是一份实战导向的配置百科全书,收录了从“最小可用”到“企业级集群”的所有关键配置模式。 阅读建议 新手:直接从 快速入门 开始。 进阶:参考 完整配置详解 理解各模块作用。 场景化:在 常见场景模板 中查找你的具体需求。
阅读全文
OpenClaw CLI 后端:构建“永远在线”的本地 AI 安全网
摘要:在 AI 应用的生产环境中,API 服务中断、速率限制(Rate Limit)或网络波动是不可避免的痛点。OpenClaw 的 CLI 后端(CLI Backend) 机制提供了一种优雅的解决方案:将本地安装的 AI 命令行工具(如 Claude Code CLI, Codex CLI)作为云 AP
阅读全文
OpenClaw Bridge 协议:历史回顾与架构演进
摘要:状态说明:已弃用 (Deprecated) Bridge 协议(TCP/JSONL)已在当前 OpenClaw 版本中移除。 bridge.* 配置项已失效。 TCP 监听器(默认端口 18790)不再启动。 新节点客户端请统一使用 Gateway WebSocket 协议。 本文档保留作为历史参考
阅读全文
OpenClaw 设备发现机制指南:Bonjour/mDNS 与 Tailscale 集成
摘要:在分布式 AI 网关架构中,如何让用户在局域网或虚拟网络中零配置地发现可用网关,是提升用户体验的关键。OpenClaw 采用 Bonjour (mDNS/DNS-SD) 作为核心发现协议,并深度集成 Tailscale 以实现跨网络的广域发现。 核心设计原则 便利性优先:自动发现减少手动 IP 配置
阅读全文
OpenClaw 后台执行与进程管理指南
摘要:在 AI Agent 与系统深度交互的场景中,处理长时间任务(如代码编译、数据流水线、构建脚本)是核心需求。OpenClaw 通过 exec(执行入口)和 process(进程管理)两大工具,提供了一套完整的后台任务生命周期管理方案。 核心设计理念 前台即时响应:短任务直接返回结果。 后台持久化管理
阅读全文
OpenClaw 模型认证指南:API 密钥与 OAuth 最佳实践
摘要:在 AI 网关架构中,模型认证是连接应用与底层大语言模型(LLM)的生命线。OpenClaw 支持灵活的认证机制,从简单的 API 密钥到复杂的 OAuth 流程。本文旨在帮助你根据业务场景,构建稳定、安全且可维护的认证体系。 核心建议:对于长期运行的生产环境网关,API 密钥通常是比 OAuth/
阅读全文
OpenClaw 安全实战指南:构建个人 AI 助手的信任边界
摘要:核心前提:OpenClaw 是个人助手网关,而非多租户安全边界。 警告:如果你的 AI 助手被互不信任的多方使用,他们共享的是同一套权限。若需隔离对抗性用户,请部署独立的网关实例(建议独立 OS 用户或主机)。 随着 AI Agent 能力的爆发,我们将文件读写、命令执行、浏览器控制等高危权限交给了
阅读全文
ACP 协议设计哲学 —— 为什么 OpenClaw 选择自研 Agent Client Protocol
摘要:关键词:ACP|Agent Client Protocol|JSON-RPC 扩展|TypeBox|流式通信|多端同步 在构建一个支持 WhatsApp、Telegram、Web、iOS、Android 和 CLI 的 AI 智能体系统时,通信协议的选择直接决定了系统的扩展性、一致性与开发效率。 O
阅读全文
三位一体架构详解 —— 网关层、协议层、智能体系如何协同工作
摘要:关键词:分层架构|ACP 协议|解耦设计|Monorepo|数据流 在第 1 篇中,我们明确了 OpenClaw 的使命:成为连接 AI 大脑与现实世界的工业级智能体网关。但一个系统能否真正支撑复杂生产场景,关键在于其架构是否清晰、模块是否解耦、扩展是否灵活。 OpenClaw 采用了一种被称为“三
阅读全文
浙公网安备 33010602011771号