openclaw/openclaw View GitHub Homepage for Latest Official Releases

开源个人AI助手，可在任何操作系统上本地运行，连接100多个消息平台，并具备自主任务执行能力

MITTypeScriptopenclawopenclaw 187.3k Last Updated: February 12, 2026

OpenClaw - 个人人工智能助手

概述

OpenClaw 是一个免费开源的自主人工智能助手框架，允许用户在自己的基础设施上部署个人人工智能助手。该项目最初由奥地利软件工程师 Peter Steinberger 于 2025 年 11 月以“Clawdbot”的名称开发，后来在 2026 年初更名为“Moltbot”，最终定名为“OpenClaw”。它已获得巨大成功，在 GitHub 上获得了超过 117,000 颗星和 16,500 个分支。

项目链接

核心理念

OpenClaw 的独特之处在于它是一个能够“真正做事”的人工智能助手，而不仅仅是响应提示。它作为一个自主代理，能够通过大型语言模型 (LLM) 独立执行任务，并使用消息平台作为其主要用户界面。

主要功能

1. 多平台集成

  • 连接到 100 多个消息服务，包括：
    • WhatsApp (通过 Baileys)
    • Telegram (通过 grammY)
    • Slack (通过 Bolt)
    • Discord (通过 discord.js)
    • Google Chat
    • Signal
    • iMessage
    • Microsoft Teams
    • Matrix
    • BlueBubbles
    • WebChat
    • 以及更多

2. 本地优先网关架构

  • 用于会话、频道、工具和事件的单一 WebSocket 控制平面
  • 完全在您自己的硬件上运行（Mac mini、Linux 服务器、通过 WSL2 的 Windows）
  • 注重隐私：所有数据都保留在您的基础设施上
  • 核心功能无云依赖

3. 多代理路由

  • 将入站频道/账户路由到隔离的代理
  • 基于工作区的组织，每个代理都有独立的会话
  • 支持多个并发人工智能模型和提供商

4. 语音和语音功能

  • 语音唤醒：macOS/iOS/Android 的始终开启语音识别
  • 对话模式：通过 ElevenLabs 集成进行连续对话
  • 通过配套应用程序支持一键通

5. 实时画布

  • 由代理驱动的视觉工作区
  • A2UI (Agent-to-UI) 框架，用于动态界面
  • 实时渲染和交互

6. 高级工具集成

  • 浏览器控制: 使用 CDP 进行专用的 Chrome/Chromium 自动化
  • 画布操作: 推送/重置、评估、快照功能
  • 设备节点: 摄像头、屏幕录制、位置服务
  • 系统集成: 通知、本地命令执行
  • 自动化: Cron 作业、Webhook、Gmail Pub/Sub 触发器

7. 技能平台

  • 模块化技能系统，包含捆绑、托管和工作区技能
  • ClawdHub 技能注册表，用于发现和安装
  • 支持自定义技能开发

8. 模型灵活性

支持多个 AI 提供商：

  • Anthropic (Claude 模型 - Opus 4.5、Sonnet 4.5、Haiku 4.5)
  • OpenAI (GPT 模型、Codex)
  • Google (Gemini)
  • 通过 API 的其他 LLM 提供商

架构

核心组件

网关

  • 中央 WebSocket 服务器（默认：ws://127.0.0.1:18789）
  • 管理会话、在线状态、配置
  • 处理消息路由和传递
  • 提供控制 UI 仪表板

Pi Agent Runtime

  • 基于 RPC 的执行引擎
  • 工具流和块流
  • 上下文窗口管理
  • 会话隔离

会话模型

  • 用于直接聊天的主要会话
  • 具有激活模式的分组隔离
  • 用于并发请求的队列管理
  • 回复路由

安全模型

默认行为：

  • 工具在主会话的主机上运行（已认证用户完全访问）
  • 分组/频道会话的可配置沙箱模式
  • DM 配对系统，防止未经授权的访问

沙箱选项：

  • 非主会话的每个会话 Docker 容器
  • 工具允许列表/拒绝列表
  • 网络隔离功能

安装与部署

系统要求

  • 运行时: Node.js ≥22
  • 操作系统支持: macOS、Linux、Windows (通过 WSL2)
  • 包管理器: npm、pnpm 或 bun

快速入门

# 全局安装
npm install -g openclaw@latest

# 运行入门向导
openclaw onboard --install-daemon

# 启动网关
openclaw gateway --port 18789 --verbose

# 发送测试消息
openclaw message send --to +1234567890 --message "Hello from OpenClaw"

# 与代理交互
openclaw agent --message "Ship checklist" --thinking high

从源码构建

git clone https://github.com/openclaw/openclaw.git
cd openclaw

pnpm install
pnpm ui:build
pnpm build

pnpm openclaw onboard --install-daemon
pnpm gateway:watch  # 开发模式，自动重载

配置

最小配置

{
  "agent": {
    "model": "anthropic/claude-opus-4-5"
  }
}

频道配置示例

WhatsApp:

pnpm openclaw channels login

Telegram:

{
  "channels": {
    "telegram": {
      "botToken": "YOUR_BOT_TOKEN"
    }
  }
}

Discord:

{
  "channels": {
    "discord": {
      "token": "YOUR_DISCORD_TOKEN"
    }
  }
}

安全与隐私

安全功能

  • DM 配对系统（陌生人接收配对码）
  • 基于允许列表的访问控制
  • 可配置的沙箱环境
  • 可选的 Docker 隔离，用于不受信任的会话
  • Tailscale 集成，用于安全的远程访问

隐私优势

  • 自托管：完整的数据所有权
  • 默认无云遥测
  • 本地凭证存储
  • 可配置的网络限制

安全注意事项

根据安全研究人员的说法：

  • 需要广泛的权限才能有效运行
  • 适用于了解安全影响的高级用户
  • 建议在生产环境中使用隔离的环境运行
  • 由于可扩展的架构存在供应链风险
  • 未经适当的安全措施，不应连接到生产服务

远程访问

OpenClaw 支持通过以下方式进行远程网关访问：

  • Tailscale Serve/Funnel: 安全的 tailnet 或公共 HTTPS
  • SSH 隧道: 传统的安全隧道
  • 令牌/密码认证: 可配置的认证模式

这允许在 Linux 服务器上运行网关，同时从任何设备进行控制。

聊天命令

用户可以使用命令控制会话：

  • /status - 会话信息
  • /new 或 /reset - 重置对话
  • /compact - 总结上下文
  • /think <level> - 调整思考深度
  • /verbose on|off - 切换详细输出
  • /usage off|tokens|full - 使用情况统计
  • /restart - 重启网关（仅限所有者）
  • /activation mention|always - 分组设置

配套应用程序

macOS 应用

  • 用于网关健康状况的菜单栏控制
  • 语音唤醒和一键通
  • WebChat 界面
  • 调试工具
  • 远程网关控制

iOS 节点

  • 语音触发器转发
  • 画布表面渲染
  • 基于节点的命令执行

Android 节点

  • 画布、摄像头、屏幕捕获
  • 通过 Bridge 进行节点配对

代理工作区与技能

  • 工作区根目录: ~/.openclaw/workspace
  • 提示文件: AGENTS.md、SOUL.md、TOOLS.md
  • 技能目录: ~/.openclaw/workspace/skills/

用例

  1. 个人生产力助手

    • 电子邮件管理和回复
    • 日历协调
    • 任务自动化

  2. 开发自动化

    • GitHub 通知
    • 自动化部署
    • 代码审查助手

  3. 多渠道通信中心

    • 跨平台的统一收件箱
    • 自动回复
    • 消息转发和路由

  4. 自定义工作流自动化

    • 与内部工具集成
    • 数据处理管道
    • 定时任务和提醒

社区与开发

  • 活跃开发: 8,368+ 次提交
  • 开源: MIT 许可证
  • 社区: 提供 Discord 服务器
  • 贡献: 欢迎 PR 和社区参与
  • 文档: docs.openclaw.ai 上的全面文档

显著成就

  • 117k+ GitHub 星标
  • 16.5k+ 分支
  • 在维基百科上被提及
  • 通过 Moltbook 集成获得病毒式传播
  • 获得硅谷和国际开发者的极大关注

与替代方案的比较

与 ChatGPT 或 Claude AI 不同：

  • 自主性: 独立执行任务，而非被动响应
  • 自托管: 在您的基础设施上运行
  • 多平台: 与 100 多个服务原生集成
  • 可扩展性: 自定义技能和工具
  • 隐私优先: 完全的数据控制

入门资源

  1. 官方文档
  2. 入门指南
  3. 配置参考
  4. 安全指南
  5. 故障排除

未来发展

OpenClaw 正在积极维护，包括：

  • 定期更新和错误修复
  • 新频道集成
  • 增强的安全功能
  • 扩展的 AI 模型支持
  • 不断增长的技能生态系统

致谢

  • 创建者: Peter Steinberger
  • 特别鸣谢: Mario Zechner (pi-mono)、Adam Doppelt (lobster.bot)
  • 社区: 200+ 贡献者，且仍在增长

结论

OpenClaw 代表了个人人工智能助手的一个范式转变，强调自主性、隐私和自托管。它非常适合希望完全控制其人工智能助手，同时又能灵活地与现有工作流和通信渠道集成的开发人员和高级用户。

对于那些熟悉自托管并正在寻找一个真正作为自主代理而非聊天机器人运行的人工智能助手的人来说，OpenClaw 提供了一个强大、开源的基础。

Star History Chart