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.policychannels.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.allowFromchannels.slack.dm.allowFrom