随笔分类 - 流行框架的源代码分析
OpenClaw 插件中的 Agent 工具开发指南
摘要:Agent 工具是 OpenClaw 插件向大语言模型(LLM)暴露的可调用函数。这些工具通过 JSON Schema 定义输入参数,并在代理(agent)运行时按需执行,从而扩展 AI 的能力边界——例如调用本地服务、查询数据库、触发工作流等。 一、工具类型:必需 vs 可选 OpenClaw 支
阅读全文
OpenClaw 插件(Plugins)系统开发与配置指南
摘要:适用版本:OpenClaw v2026.3.8+核心理念:插件是扩展 OpenClaw 能力的安全、模块化方式,用于添加命令、工具、渠道、模型认证、HTTP 接口等。 一、快速入门 1. 什么是插件? 插件是一个小型代码模块,用于在不修改 OpenClaw 核心代码的前提下,动态扩展其功能。典型用途
阅读全文
OpenClaw 技能(Skills)系统配置指南
摘要:适用版本:OpenClaw v2026.3.8+配置文件路径:~/.openclaw/openclaw.json OpenClaw 的核心能力通过 Skills(技能) 扩展实现。每个技能是一个独立的可执行单元,用于完成特定任务(如调用 AI 模型、处理文件、发送邮件等)。所有技能相关的配置均位于
阅读全文
基于 Kubernetes 构建安全、稳定、可长期运维的 OpenClaw 生产实例
摘要:作者:程序员老杨更新日期:2026 年 3 月 15 日适用对象:云原生工程师、AI 运维团队、企业 DevOps 一、为什么选择 Kubernetes 部署 OpenClaw? OpenClaw 作为“本地 AI 数字员工”,其生产价值体现在7×24 小时可靠运行、多渠道协同、状态持久化与灾备恢复
阅读全文
小白快速构建安全、稳定、可长期运维的 OpenClaw生产Docker版实例
摘要:当然。以下是完整、可直接执行、基于 OpenClaw 最新稳定版本 v2026.3.8 的单机生产环境 Docker 部署指南,包含所有必要步骤、配置文件和命令,无任何省略。 一、项目简介 OpenClaw 是一个本地优先、可自托管的 AI 执行引擎,能通过自然语言指令自主完成任务(如文件处理、邮件
阅读全文
OpenClaw 技能系统详解:从加载机制到安全管理
摘要:OpenClaw 采用 AgentSkills 兼容的技能(Skill)体系,通过模块化目录结构赋予智能体使用各类工具的能力。每个技能是一个独立文件夹,包含描述其功能与调用方式的 SKILL.md 文件。本文将系统阐述 OpenClaw 的技能加载机制、优先级规则、配置方法、安全模型及与 ClawH
阅读全文
OpenClaw 的 Docker 部署指南
摘要:OpenClaw 支持通过 Docker 容器化部署,适用于需要环境隔离、快速验证或在无本地安装权限的主机上运行的场景。本文将详细介绍两种主要使用模式:完整容器化网关 和 主机网关 + 代理沙箱,并提供配置建议、安全注意事项及高级用法。 一、是否该使用 Docker? 推荐使用: 希望获得一个干净、
阅读全文
从零部署 OpenClaw —— 实战:接入 WhatsApp + 创建自定义 Skill
摘要:关键词:快速上手|WhatsApp 集成|自定义 Skill|Web UI|扫码登录|本地开发 理论终需落地。本篇将带您完成一次完整的 OpenClaw 部署与扩展实战: 环境准备:安装 Node.js、pnpm、Docker 启动核心服务:配置并运行 OpenClaw 接入 WhatsApp:通过
阅读全文
深入解析 OpenClaw如何通过 ws-log.ts 模块实现高效、可读、低开销的 WebSocket 日志系统
摘要:关键词:WebSocket 日志|耗时追踪|紧凑模式|结构化日志|终端友好|性能优先 在 OpenClaw 的多端架构中,WebSocket 是 Web UI 与后端通信的核心通道。每秒可能有数十条 ACP(Agent Communication Protocol)消息穿梭其间——包含用户输入、AI
阅读全文
OpenClaw 架构下 Skills System —— 为什么“文档即工具”是 OpenClaw 的扩展灵魂
摘要:关键词:Skills System|SKILL.md|文档即工具|依赖声明|环境感知|零配置扩展 在 OpenClaw 中,AI 的能力边界不由代码硬编码决定,而由一组名为 Skills(技能)的轻量级模块动态扩展。每个 Skill 以纯文本文件 SKILL.md 形式存在,既是人类可读的使用文档,
阅读全文
OpenClaw 的聊天 RPC 接口 —— chat.ts 中的历史查询、发送与中止逻辑
摘要:关键词:ACP RPC|历史截断|运行中止|消息注入|内存安全|会话控制 在 OpenClaw 架构中,src/core/chat.ts 是智能体与外部世界交互的核心 RPC 接口层。它不仅处理用户消息的收发,更承担着会话状态管理、资源保护与紧急干预等关键职责。 所有客户端(Web、WhatsApp
阅读全文
OpenClaw 深度集成 WhatsApp —— session.ts 与 Baileys 的健壮连接管理
摘要:关键词:WhatsApp 集成|Baileys|会话持久化|凭据备份|QR 登录|智能重连|状态机|主动登出检测 在企业级 AI 助手系统中,WhatsApp 是用户最常使用的入口之一。然而,由于 Meta 未提供官方 Bot API,开发者必须依赖社区库(如 Baileys)模拟移动端行为——这带
阅读全文
OpenClaw 架构中消息流入中枢 —— monitor-inbox.ts 如何解析、去重与防抖
摘要:关键词:消息中枢|去重|防抖|媒体下载|时间窗口|幂等性|ACP 入口 在多渠道(WhatsApp、Web、Telegram 等)接入的 OpenClaw 架构中,原始消息如潮水般涌入:用户可能连发三条“重启服务”,或上传一张截图并附带说明。若直接将这些原始数据喂给 LLM,将导致: 重复执行(同一
阅读全文
server-channels.ts —— OpenClaw 渠道插件生命周期管理器
摘要:关键词:渠道插件|生命周期|ACP 协议|热插拔|统一消息模型|事件总线 OpenClaw 的核心能力之一是多端一致性:无论用户通过 WhatsApp、Web UI、终端 CLI 还是 Slack 与 AI 交互,体验必须无缝统一。然而,每个渠道的通信协议、认证方式、消息格式截然不同——如何避免为每
阅读全文
安全边界设计 —— OpenClaw 如何防范 AI 滥用系统权限
摘要:关键词:沙箱逃逸|输出消毒|日志脱敏|权限最小化|纵深防御|零信任执行 赋予 AI 执行系统命令的能力,如同交出一把万能钥匙——它能开门,也可能被用于撬锁。OpenClaw 的核心挑战之一,是在提供强大行动力的同时,确保 AI 始终在人类设定的安全边界内运行。 为此,系统构建了三层纵深防御体系: 执
阅读全文
测试 AI 系统 —— OpenClaw 的确定性测试与模糊验证策略
摘要:关键词:AI 测试|确定性模拟|LLM Mock|模糊测试|回归防护|工具调用验证 AI 系统的测试常被视为“不可能任务”: LLM 输出天然具有随机性 工具调用依赖外部状态 用户意图千变万化 若直接对真实 LLM + 真实环境进行端到端测试,结果将不可重复、难以调试、无法 CI/CD 集成。 Op
阅读全文
OpenClaw 部署模型演进 —— 从单机 Docker 到 Kubernetes Operator
摘要:关键词:部署演进|Docker Compose|Helm Chart|Kubernetes Operator|多租户|自动扩缩容 OpenClaw 的设计哲学之一是 “随处可运行”(Run Anywhere):无论是开发者的 MacBook、家庭 NAS,还是企业私有云,都应能以最小成本部署并获得一
阅读全文
Web UI 架构 —— OpenClaw 如何实现与 CLI/WhatsApp 一致的交互体验
摘要:关键词:ACP 协议|状态同步|响应式 UI|多端一致性|WebSocket|会话复用 在多渠道 AI 系统中,一个常见陷阱是:不同客户端体验割裂。用户在 WhatsApp 上能执行的操作,在 Web UI 中却不可用;CLI 输出的工具调用日志,在网页上却看不到——这不仅降低效率,更破坏信任。 O
阅读全文
技能即文档 —— SKILL.md 如何让 OpenClaw 自主学习新工具
摘要:关键词:SKILL.md|工具自描述|Markdown 解析|函数调用|动态注册|开发者友好 在传统 AI 系统中,为智能体添加新能力(如“查询数据库”或“部署服务”)通常需要: 编写 TypeScript 函数 注册到工具列表 更新提示词(prompt) 重启服务 这一过程对开发者不友好,更无法由
阅读全文
process.ts —— OpenClaw 如何像开发者一样管理后台进程
摘要:关键词:进程管理|服务监控|日志追踪|自动恢复|权限隔离|状态快照 在现代开发运维中,“部署”只是开始,真正的挑战在于服务的持续运行与可观测性。一个合格的开发者会: 启动 Web 服务并确认其监听端口 实时跟踪日志中的错误 在崩溃后自动重启 根据资源使用调整配置 OpenClaw 的 src/age
阅读全文
浙公网安备 33010602011771号