OpenClaw(开放性的抓取者) — 个人 AI 助手

EXFOLIATE! EXFOLIATE!
（字面意思是“去壳！去壳！”，这里更像是一种口号式表达，带点玩笑/品牌风格意味。）

状态信息

  • Build：失败（Failing）
  • Release：V2026.2.25-BETA.1
  • Discord：2.2 万人在线
  • License：MIT（Massachusetts Institute of Technology License麻省理工学院许可证。MIT License 是一种非常宽松的开源许可证。最早由（麻省理工学院）使用，因此得名。）

Note：

1、它允许你做什么？

如果一个项目使用 MIT License，你可以，所以这个项目是开源的：

✅ 自由使用
✅ 修改代码
✅ 商业用途
✅ 私人用途
✅ 再发布
✅ 改成闭源再卖

你只需要做一件事：保留原作者的版权声明和许可证文本。就这么简单。

2、为什么很多项目用 MIT？

因为它：

  • 非常开放
  • 几乎没有限制
  • 适合商业公司使用
  • 传播成本低

很多流行项目都使用 MIT License。

3、结合 OpenClaw 的情况

如果 OpenClaw 使用 MIT License，意味着：

  • 你可以自己修改源码
  • 可以二次开发
  • 可以部署商业版本
  • 甚至可以 fork 一个自己的版本

但注意：**许可证只约束代码版权，不代表项目安全性或权限风险。**它只是说明“法律使用方式”。

4、MIT内容全文：

MIT 许可证

版权所有 (c) 2025 Peter Steinberger

特此免费授予任何获得本软件及其相关文档文件（以下简称“软件”）副本的个人，不受限制地处理本软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售本软件副本的权利，并允许向其提供本软件的人员在符合以下条件的情况下这样做：

上述版权声明和本许可声明必须包含在本软件的所有副本或实质性部分中。

本软件按“原样”（AS IS）提供，不提供任何形式的明示或暗示担保，包括但不限于对适销性、特定用途适用性以及非侵权的担保。在任何情况下，作者或版权所有者均不对因软件或软件的使用或其他处理所产生的、由此引起的或与之相关的任何索赔、损害或其他责任负责，无论该责任是基于合同、侵权行为或其他法律理论。

项目介绍

OpenClaw 是一个个人 AI 助手，运行在你自己的设备上。

它可以在你已经使用的聊天渠道中回复你，例如：

  • WhatsApp
  • Telegram
  • Slack
  • Discord
  • Google Chat
  • Signal
  • iMessage
  • Microsoft Teams
  • WebChat

以及扩展渠道，例如：

  • BlueBubbles
  • Matrix
  • Zalo
  • Zalo Personal

它可以在 macOS / iOS / Android 上进行语音对话（说和听），
还可以渲染一个你可以控制的实时 Canvas（可视化画布）。

Gateway（网关）只是控制平面 —— 真正的产品是这个“助手”本身。

定位说明

如果你想要一个：

  • 个人使用
  • 单用户
  • 本地运行
  • 快速响应
  • 始终在线

的 AI 助手 —— 这就是它。

相关链接

  • Website（官网）
  • Docs（文档）
  • Vision（愿景）
  • DeepWiki
  • Getting Started（快速开始）
  • Updating（更新）
  • Showcase（展示）
  • FAQ
  • Wizard（向导）
  • Nix
  • Docker
  • Discord

推荐安装方式

Preferred setup: run the onboarding wizard (openclaw onboard) in your terminal.
推荐的安装方式：在终端中运行入门向导（openclaw onboard）。

The wizard guides you step by step through setting up the gateway, workspace, channels, and skills.
该向导会一步步引导你完成网关、工作空间、通信渠道和技能的设置。

The CLI wizard is the recommended path and works on macOS, Linux, and Windows (via WSL2; strongly recommended).
CLI 向导是官方推荐的方式，支持 macOS、Linux，以及 Windows（通过 WSL2；强烈推荐使用）。

Works with npm, pnpm, or bun.
支持使用 npm、pnpm 或 bun。

New install? Start here: Getting started
新安装？从这里开始：Getting Started（快速开始）。

Sponsors 赞助商

OpenAI 和 Blacksmith两家公司

Subscriptions（OAuth 订阅）

  • OpenAI（ChatGPT / Codex）

模型说明：
虽然支持任意模型，但我强烈推荐使用 Anthropic Pro/Max（100/200）+ Opus 4.6，因为它在长上下文能力和提示注入（prompt injection）防护方面表现更强。
详见：Onboarding（入门指南）。

Models（模型：选择 + 认证）

  • 模型配置 + CLI：Models
  • 认证配置轮换（OAuth vs API keys）+ 备用机制：Model failover（模型故障切换）

Install（推荐安装）

运行环境：Node ≥ 22

安装命令：

1
2
3
4
5
npm install -g openclaw@latest
# 或：
pnpm add -g openclaw@latest

openclaw onboard --install-daemon

说明：
该向导会安装 Gateway 守护进程（launchd / systemd 用户服务），
以确保它持续在后台运行。

Quick start（快速开始；TL;DR = 简而言之）

运行环境：Node ≥ 22

完整新手指南（认证、配对、渠道配置）：Getting started（快速开始）

安装并启动：

1
2
3
4
5
6
7
8
9
openclaw onboard --install-daemon

openclaw gateway --port 18789 --verbose

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

# 与助手对话（可选择将回复发送到任意已连接渠道：WhatsApp / Telegram / Slack / Discord 等）
openclaw agent --message "Ship checklist" --thinking high

升级？查看：Updating guide（更新指南）
并运行：

1
openclaw doctor

Development channels（开发版本渠道）

  • stable（稳定版）
    带标签的正式发布版本（vYYYY.M.D 或 vYYYY.M.D-），
    npm 分发标签：latest
  • beta（测试版）
    预发布标签（vYYYY.M.D-beta.N），
    npm 分发标签：beta
    （macOS 应用可能暂未提供）
  • dev（开发版）
    main 分支的最新开发版本，
    npm 分发标签：dev（发布时提供）

切换版本渠道（git + npm）：

1
openclaw update --channel stable|beta|dev

详情参见：Development channels

From source（从源码构建 / 开发模式）

推荐使用 pnpm 进行源码构建。
如果要直接运行 TypeScript，Bun 也是可选方案。

1
2
3
4
5
6
7
8
9
10
11
git clone https://github.com/openclaw/openclaw.git
cd openclaw

pnpm install
pnpm ui:build # auto-installs UI deps on first run
pnpm build

pnpm openclaw onboard --install-daemon

# Dev loop (auto-reload on TS changes)
pnpm gateway:watch

使用 pnpm openclaw ... 会直接运行 TypeScript（通过 tsx）。

使用 pnpm build 会生成 dist/ 目录，用于通过 Node 或打包后的 openclaw 可执行文件运行。

🔹 pnpm openclaw ...
👉 是“开发模式”运行
👉 直接执行源码（.ts 文件）
👉 不需要提前编译
👉 适合开发调试

🔹 pnpm build
👉 会把 TypeScript 编译成 JavaScript
👉 输出到 dist/ 文件夹
👉 这是“生产运行版本”
👉 之后可以用 Node 或打包好的二进制程序运行

简单理解就是：

  • 开发阶段 → 直接跑 TS
  • 正式运行 / 发布 → 先 build 再运行

Security defaults（默认安全设置：私信访问 DM access）

OpenClaw 会连接真实的消息平台。
请将收到的私信（DM）视为不受信任的输入。

完整安全指南：Security

在以下平台上的默认行为：

Telegram / WhatsApp / Signal / iMessage / Microsoft Teams / Discord / Google Chat / Slack

• DM 配对机制（DM pairing）

（dmPolicy="pairing" / channels.discord.dmPolicy="pairing" /
channels.slack.dmPolicy="pairing"；旧版本配置：channels.discord.dm.policy、channels.slack.dm.policy）

👉 对于未知发送者：

  • 系统会发送一个简短的配对验证码
  • 机器人不会处理对方的消息

批准方式：

1
openclaw pairing approve <channel> <code>

批准后，该发送者会被加入本地允许名单（allowlist）。

• 如果你想允许公开私信（Public inbound DMs）：

必须显式开启：

  • 设置 dmPolicy="open"
  • 并在频道允许列表中加入 "*"

（配置项：allowFrom / channels.discord.allowFrom / channels.slack.allowFrom；
旧版本：channels.discord.dm.allowFrom、channels.slack.dm.allowFrom）

检查安全配置

运行：

1
openclaw doctor

可以检测存在风险或配置错误的 DM 策略。

Highlights（功能亮点）

• Local-first Gateway

本地优先的网关 ——
为会话、渠道、工具和事件提供一个统一的控制平面。

• Multi-channel inbox

多渠道收件箱 ——
支持 WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、BlueBubbles（iMessage）、iMessage（旧版）、Microsoft Teams、Matrix、Zalo、Zalo Personal、WebChat，以及 macOS / iOS / Android。

Multi-agent routing

多智能体路由 ——
将不同的入站渠道 / 账号 / 对等方路由到相互隔离的智能体
（基于工作空间 + 每个智能体独立会话）。

Voice Wake + Talk Mode

语音唤醒 + 对话模式 ——
在 macOS / iOS / Android 上提供常驻语音功能（使用 ElevenLabs）。

Live Canvas

实时画布 ——
基于 A2UI 的、由智能体驱动的可视化工作空间。

First-class tools

一流工具支持 ——
浏览器、画布、节点、定时任务（cron）、会话管理，以及 Discord / Slack 操作。

Companion apps

配套应用 ——
macOS 菜单栏应用 + iOS / Android 节点（nodes）。

Onboarding + skills

入门向导 + 技能系统 ——
通过向导式配置，支持内置 / 托管 / 工作空间级别的技能。

Everything we built so far

Core platform 核心平台

  • Gateway WS 控制平面
    包含会话（sessions）、在线状态（presence）、配置（config）、定时任务（cron）、Webhooks、控制界面（Control UI）以及 Canvas 托管服务。
  • CLI 接口
    包含 gateway、agent、send、wizard（向导）和 doctor（诊断工具）。
  • Pi agent 运行时
    以 RPC 模式运行，支持工具流式传输（tool streaming）和分块流式传输（block streaming）。
  • 会话模型（Session model）
    使用 main 进行直接聊天，支持群组隔离、激活模式、队列模式、自动回复。
    群组规则详见：Groups。
  • 媒体处理管道（Media pipeline）
    支持图片 / 音频 / 视频处理、转录钩子、文件大小限制、临时文件生命周期管理。
    音频细节见：Audio。

Channels 渠道支持

  • 支持的渠道包括：
    WhatsApp（Baileys）、
    Telegram（grammY）、
    Slack（Bolt）、
    Discord（discord.js）、
    Google Chat（Chat API）、
    Signal（signal-cli）、
    BlueBubbles（iMessage，推荐方式）、
    iMessage（旧版 imsg）、
    Microsoft Teams（扩展方式）、
    Matrix（扩展方式）、
    Zalo（扩展方式）、
    Zalo Personal（扩展方式）、
    WebChat。

群组路由（Group routing）
支持 @提及控制（mention gating）、回复标签、按渠道分块和路由。
渠道规则详见：Channels。

Apps + nodes 应用 + 节点

  • macOS 应用
    菜单栏控制面板、语音唤醒（Voice Wake）/ 按键说话（PTT）、
    Talk Mode 悬浮层、WebChat、调试工具、远程网关控制。
  • iOS 节点（node）
    支持 Canvas、语音唤醒、Talk Mode、摄像头、屏幕录制、Bonjour 配对。
  • Android 节点（node）
    支持 Canvas、Talk Mode、摄像头、屏幕录制、可选 SMS 功能。
  • macOS 节点模式
    支持 system.run / notify，以及 Canvas / 摄像头权限暴露。

Tools + automation 工具与自动化

  • 浏览器控制（Browser control）
    专用的 openclaw Chrome / Chromium，支持页面快照（snapshots）、操作（actions）、上传（uploads）、配置文件（profiles）。
  • Canvas（画布）
    A2UI 推送 / 重置、执行（eval）、快照。
  • Nodes（节点能力）
    摄像头拍照 / 录制片段、屏幕录制、location.get（获取位置）、通知。
  • 定时任务 + 唤醒（Cron + wakeups）；
    Webhooks；
    Gmail 发布 / 订阅（Pub/Sub）。
  • 技能平台（Skills platform）
    支持内置、托管和工作空间级技能，并提供安装控制机制 + UI 界面。

Runtime + safety 运行时与安全

  • 渠道路由（Channel routing）、重试策略（retry policy）、流式 / 分块处理（streaming / chunking）。
  • 在线状态（presence）、正在输入指示（typing indicators）、使用情况统计（usage tracking）。
  • 模型管理（models）、模型故障切换（model failover）、会话清理（session pruning）。
  • 安全机制（security）和故障排查（troubleshooting）。

Ops + packaging 运维与打包

  • 控制界面（Control UI）+ WebChat 由 Gateway 直接提供服务。
  • 支持 Tailscale Serve / Funnel 或 SSH 隧道，并带有 token / 密码认证。
  • Nix 模式（声明式配置）；
    基于 Docker 的安装方式。
  • Doctor 迁移工具（migrations）、日志记录（logging）。