openclaw/openclaw

TL;DR

OpenClaw 是一个运行在本地设备上的个人 AI Assistant Gateway，核心卖点是将 LLM、工具链与 WhatsApp/Telegram/Discord 等即时通讯渠道打通。它通过单一控制平面实现跨平台交互，适合希望将 AI 助手融入日常通讯流且重视数据隐私的开发者。

它解决什么问题

当前 AI Agent 生态存在严重的“渠道割裂”：ChatGPT、Claude 等 API 服务通常只存在于 Web UI，而 WhatsApp/Telegram/iMessage 等平台缺乏原生的、可定制的 Agent 接入方案。OpenClaw 解决了这一痛点，允许用户在自己的设备上运行 Gateway，将 AI 能力“注入”到已有的通讯频道中。其动机是提供真正的“Own-your-data”体验，避免敏感对话数据经过第三方云端中转。

核心做法

架构上采用 Client-Server 模式： 1. Gateway: 本地运行的核心进程，负责会话管理、事件分发和渠道连接。它充当控制平面（Control Plane），统一管理状态。 2. Channels: 适配器层，支持 WhatsApp, Telegram, Slack, Discord, Signal, iMessage (macOS) 等。通过配对机制（Pairing）确保只有授权用户能发送指令。 3. Tools & Skills: 扩展层。工具直接在宿主机执行，Skills 提供特定领域的逻辑封装。 4. Companion Apps: 通过 Nodes 机制连接设备本地能力（如语音、摄像头），实现多模态交互。技术栈基于 TypeScript 和 Node.js，利用 pnpm workspace 进行模块化开发。它不绑定特定 LLM，支持通过 Model Providers 接入本地或云端模型。

作者

核心维护者是 Peter Steinberger (steipete)，他是 iOS/macOS 开发领域的知名专家（Masonry, SnapKit 作者）。项目由 OpenClaw Foundation (非营利组织) 运营，并得到了 Mario Zechner (pi framework 作者) 的支持。这种背景意味着项目底层架构在工程化、跨平台兼容性和稳定性上会有较高水准，不同于一般的个人 hobby 项目。

社区反应

数据表现极其惊人：Stars 高达 387,415，Forks 超过 80k。在短短几个月内达到这一量级属于现象级的增长，表明其在“个人 AI 助手”赛道具有极强的吸引力。然而，Open Issues 高达 5,886 个，这反映了两个事实：一是用户基数极大导致反馈量大；二是项目目前处于快速迭代期，Bug 修复和功能请求堆积明显。Discord 社区活跃度高，但 Issue 的响应速度可能成为早期用户的痛点。

怎么上手

依赖环境：Node.js (22.22.3+, 24.15+ or 25.9+)。

最小复现步骤：

# macOS / Linux 一键安装
curl -fsSL https://openclaw.ai/install.sh | bash
# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

安装后运行 openclaw onboard --install-daemon 完成向导（配置模型 Key、创建工作区）。最后通过 openclaw dashboard 打开 Web UI 测试，或通过配置好的 IM 渠道发送消息。

争议与局限

安全性风险（推断）：README 明确警告“Tools run on the host”，这意味着如果 LLM 被 Prompt Injection 攻击，恶意代码将直接在宿主机执行。虽然支持沙箱（Sandboxing），但默认配置可能不够安全，不适合多用户共享场景。
平台限制：虽然号称 Any OS，但 iMessage 仅限 macOS；Windows 下部分高级功能（如原生桌面集成）可能不如 Linux/macOS 完善。
维护压力：5k+ Issues 与快速迭代并存，API/CLI 的稳定性在早期版本中可能存在波动。
模型依赖：虽然支持本地模型，但复杂的 Tool Use 和长上下文仍高度依赖高质量云端 API（如 OpenAI/Gemini），本地小模型可能无法发挥其全部能力。