🦞 OpenClaw — 个人 AI 助手

本文是对 OpenClaw 官方 README 的中文翻译版本，原始项目：
https://github.com/openclaw/openclaw

OpenClaw — 个人 AI 助手

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

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

WhatsApp
Telegram
Slack
Discord
Google Chat
Signal
iMessage
Microsoft Teams
Feishu
LINE
IRC
Matrix
Nextcloud Talk
Twitch
Zalo
WebChat
等等

同时它还支持：

macOS / iOS / Android 语音对话
实时 Canvas 可视化界面
本地运行的控制网关

Gateway 只是控制平面，真正的产品是你的 AI 助手本身。

如果你想要一个：

只属于自己的 AI
本地运行
速度快
永远在线

那么 OpenClaw 就是为此设计的。

官方资源

官网：https://openclaw.ai
文档：https://docs.openclaw.ai
DeepWiki：https://deepwiki.com/openclaw/openclaw
新手教程：https://docs.openclaw.ai/start/getting-started
更新指南：https://docs.openclaw.ai/install/updating
Showcase：https://docs.openclaw.ai/start/showcase
FAQ：https://docs.openclaw.ai/help/faq
Discord：https://discord.gg/clawd

推荐使用 CLI 安装向导：

1	openclaw onboard

该向导会一步一步帮助你完成：

Gateway 设置
工作空间配置
通讯渠道接入
AI 技能配置

支持系统：

macOS
Linux
Windows（推荐使用 WSL2）

支持包管理器：

npm
pnpm
bun

安装（推荐）

运行环境：

1	Node >= 22

安装：

npm install -g openclaw@latest
# 或
pnpm add -g openclaw@latest

openclaw onboard --install-daemon

该命令会安装 Gateway 守护进程，保证助手一直运行。

快速开始

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

开发版本渠道

OpenClaw 提供三个版本渠道：

stable

正式版本
npm 标签：latest

beta

测试版本
npm 标签：beta

dev

最新开发版本
npm 标签：dev

切换版本：

1	openclaw update --channel stable\|beta\|dev

从源码运行

推荐使用 pnpm。

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

开发模式会自动监听 TypeScript 变化。

安全默认策略

OpenClaw 会连接真实的聊天平台，因此：

所有私信默认视为不可信输入。

默认行为：

未知用户发消息
系统返回一个配对码
需要手动批准

批准命令：

1	openclaw pairing approve <channel> <code>

主要功能

本地优先 Gateway

统一控制：

会话
通道
工具
事件

多聊天平台接入

支持：

WhatsApp
Telegram
Slack
Discord
Google Chat
Signal
iMessage
Feishu
LINE
Teams
Matrix
WebChat
等等

多 Agent 路由

可以为不同：

渠道
用户
工作空间

分配不同 AI。

语音助手

支持：

唤醒词
连续语音对话

Live Canvas

AI 可以控制可视化工作界面。

工具系统

内置工具包括：

浏览器控制
Canvas
自动任务
节点设备控制

Companion Apps

支持：

macOS 应用
iOS 节点
Android 节点

系统架构（简化）

WhatsApp / Telegram / Slack / Discord / Feishu / LINE / WebChat
           │
           ▼
        Gateway
     ws://127.0.0.1:18789
           │
   ├─ AI Agent
   ├─ CLI
   ├─ WebChat UI
   ├─ macOS App
   └─ iOS / Android Node

核心子系统

Gateway

WebSocket 控制平面。

负责：

客户端连接
工具调用
事件系统

Browser Control

OpenClaw 可以控制 Chrome / Chromium。

Canvas + A2UI

AI 控制的可视化界面。

Voice Wake

语音唤醒助手。

Nodes

设备节点能力：

摄像头
屏幕录制
通知
位置信息

Gateway 远程部署

Gateway 可以运行在 Linux 服务器上。

客户端可以通过：

Tailscale
SSH Tunnel

进行访问。

设备节点仍然可以执行本地操作，例如：

摄像头
屏幕录制
通知

聊天命令

在聊天中发送：

/status
/new
/reset
/compact
/think <level>
/verbose
/usage
/restart
/activation

示例：

1	/think high

工作空间

默认目录：

1	~/.openclaw/workspace

包含：

AGENTS.md
SOUL.md
TOOLS.md
skills/

配置文件

配置文件：

1	~/.openclaw/openclaw.json

示例：

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

安全模型

默认规则：

主会话：工具直接运行在宿主机
群聊会话：可以运行在 Docker 沙箱

沙箱默认允许：

bash
read
write
edit

禁止：

浏览器
canvas
节点控制

支持平台

OpenClaw 支持：

macOS
Linux
Windows（WSL2）
iOS
Android

社区

欢迎提交 PR。

项目由社区维护。

GitHub：
https://github.com/openclaw/openclaw

项目起源

OpenClaw 最初是为 Molty —— 一只“太空龙虾 AI 助手”打造的。 🦞

作者：

Peter Steinberger
以及开源社区。