OpenClaw 是一款基于 Node.js 和 TypeScript 构建的本地化个人 AI 助手。其核心采用 Gateway 控制平面与 Pi Agent 推理核心分离的模块化架构，支持 WebSocket 实时通信。系统涵盖多渠道集成（WhatsApp、Telegram 等）、设备节点协同（macOS、iOS、Android）及浏览器自动化能力。安全方面提供沙箱隔离与权限控制，支持本地、远程及 Docker 部署。通过技能平台和插件系统实现功能扩展，适用于个人助理、团队协作及开发辅助场景。
OpenClaw 是一款运行在用户本地设备上的个人 AI 助手，采用模块化、分布式的现代架构设计。系统以 Gateway 为核心控制平面，通过 WebSocket 协议连接各种客户端和服务，实现多渠道消息处理、AI 推理、设备控制等功能。
OpenClaw 的设计理念围绕以下几个核心原则：
模型层 服务层 控制平面 用户交互层 消息 消息 消息 消息 消息 消息 消息 消息 消息 消息 消息 消息 消息 控制 设备操作 设备操作 请求处理 浏览器操作 Canvas 操作 设备操作 定时任务 技能调用 AI 推理 AI 推理 AI 推理 WhatsApp Telegram Slack Discord Feishu Google Chat Signal iMessage BlueBubbles Microsoft Teams Matrix Zalo WebChat macOS 应用 iOS 节点 Android 节点 Gateway ws://127.0.0.1:18789 Pi Agent RPC 模式 浏览器控制 Chrome/Chromium Canvas 可视化界面 设备节点 本地操作 定时任务 Cron 技能平台 Skills Anthropic Claude OpenAI ChatGPT 其他模型 提供商
Gateway 是 OpenClaw 的核心控制平面，负责管理所有客户端连接、消息路由和服务协调。它是整个系统的神经中枢，处理所有组件之间的通信和协作。
主要功能：
技术实现：
ws 库)，实现实时双向通信配置示例：
{
"gateway": {
"port": 18789,
"bind": "loopback",
"auth": {
"mode": "password",
"password": "your-secure-password"
},
"tailscale": {
"mode": "serve",
"resetOnExit": true
}
}
}
Pi Agent 是 OpenClaw 的 AI 推理核心，以 RPC 模式运行，处理所有 AI 相关任务。它是系统的智能大脑，负责理解用户意图并生成响应。
主要功能：
技术实现：
@mariozechner/pi-agent-core，提供核心 AI 能力工作流程：
OpenClaw 支持多种通信渠道，实现全平台覆盖。这使得用户可以通过自己习惯的通信工具与 AI 助手交互。
支持的渠道：
技术实现：
渠道配置示例（以 Telegram 为例）：
{
"channels": {
"telegram": {
"botToken": "123456:ABCDEF",
"groups": {
"*": {
"requireMention": true
}
}
}
}
}
设备节点允许 OpenClaw 与用户设备交互，执行本地操作。这使得 AI 助手能够控制用户的设备，实现更丰富的交互体验。
支持的设备：
主要功能：
system.run)：在设备上运行命令并获取结果system.notify)：向用户发送系统通知camera.*)：拍摄照片和录制视频screen.record)：捕获屏幕内容location.get)：获取设备当前位置技术实现：
权限管理： OpenClaw 严格遵循各平台的权限模型，确保设备操作符合安全要求：
OpenClaw 提供内置的浏览器控制功能，支持网页操作和自动化。这使得 AI 助手能够浏览网页、执行在线任务。
主要功能：
技术实现：
使用场景：
Canvas 是 OpenClaw 的可视化工作区，支持 agent 驱动的界面交互。它为用户提供了一个直观的可视化界面，增强了与 AI 助手的交互体验。
主要功能：
技术实现：
应用场景：
OpenClaw 提供技能平台，支持扩展功能和自动化。技能是 OpenClaw 的核心扩展机制，允许用户和开发者添加新功能。
主要功能：
技术实现：
技能示例结构：
skills/
weather/
SKILL.md
index.js
github/
SKILL.md
index.js
SKILL.md 示例：
# Weather Skill
## Description
Get current weather information for any location.
## Commands
- `/weather <location>`: Get weather for a specific location
- `/forecast <location>`: Get weather forecast for a specific location
## Permissions
- network: required for API calls
| 类别 | 技术/库 | 版本 | 用途 | 选择理由 |
|---|---|---|---|---|
| 运行时 | Node.js | ≥22.12.0 | 核心运行环境 | 异步事件驱动架构，适合 I/O 密集型应用 |
| 包管理 | pnpm | 10.23.0 | 依赖管理 | 快速、节省空间的包管理，支持工作区 |
| 语言 | TypeScript | 5.9.3 | 主要开发语言 | 类型安全，提高代码质量和可维护性 |
| 通信 | WebSocket | [email protected] | 实时通信 | 轻量级、双向通信协议，适合实时应用 |
| 通信 | HTTP | [email protected] | Web 服务 | 成熟的 Web 框架，处理 HTTP 请求 |
| AI SDK | Pi Agent | 0.50.7 | AI 推理核心 | 专为 AI 助手设计，支持多种模型 |
| 数据验证 | TypeBox | 0.34.48 | 类型定义和验证 | 高性能数据验证，与 TypeScript 集成 |
| 配置 | dotenv | 17.2.3 | 环境变量管理 | 简单易用，支持不同环境配置 |
| 日志 | tslog | 4.10.2 | 日志记录 | 结构化日志，支持不同日志级别 |
| 渠道 | 技术/库 | 版本 | 特点 |
|---|---|---|---|
| Baileys | 7.0.0-rc.9 | 轻量级 WhatsApp 客户端库 | |
| Telegram | grammY | 1.39.3 | 现代化 Telegram 机器人框架 |
| Slack | Bolt | 4.6.0 | 官方 Slack 开发工具包 |
| Discord | discord.js | - | 功能丰富的 Discord 客户端库 |
| Feishu | Lark SDK | 1.37.0 | 飞书开放平台 SDK |
| Line | Line Bot SDK | 10.6.0 | Line 官方机器人 SDK |
| 平台 | 技术 | 工具链 | 特点 |
|---|---|---|---|
| macOS | Swift | Xcode | 原生 macOS 应用，深度集成系统功能 |
| iOS | Swift | Xcode, xcodegen | 原生 iOS 应用，支持最新 iOS 特性 |
| Android | Java/Kotlin | Gradle | 跨设备 Android 应用，适配多种屏幕 |
| 工具 | 用途 | 优势 |
|---|---|---|
| TypeScript | 类型检查和编译 | 类型安全，减少运行时错误 |
| oxlint | 代码 linting | 快速、严格的代码风格检查 |
| oxfmt | 代码格式化 | 统一代码风格，提高可读性 |
| vitest | 测试框架 | 快速、现代的测试工具 |
| playwright-core | 浏览器自动化测试 | 可靠的浏览器测试能力 |
OpenClaw 的消息处理流程设计高效，确保消息从接收、处理到响应的全链路通畅。
消息路由策略：
设备操作流程确保 OpenClaw 能够安全、可靠地与用户设备交互。
设备选择策略：
AI 推理流程是 OpenClaw 的核心处理环节，确保 AI 模型能够高效、准确地处理用户请求。
模型选择策略：
安全是 OpenClaw 设计的核心考虑因素，确保用户数据和系统安全。
OpenClaw 采用多层次的安全模型，保护系统和用户数据：
OpenClaw 实施多种安全措施，确保系统安全：
安全配置示例：
{
"security": {
"dmPolicy": "pairing",
"sandbox": {
"mode": "non-main",
"allowedTools": ["bash", "read", "write"]
},
"elevated": {
"enabled": true,
"allowlist": ["your-username"]
}
}
}
使用 OpenClaw 时的安全最佳实践：
OpenClaw 支持多种部署方案，适应不同的使用场景和需求。
本地部署是最常见的使用方式，适合个人用户和小型团队。
推荐配置：
部署步骤：
npm install -g openclaw@latestopenclaw onboard --install-daemonopenclaw gateway --port 18789 --verbose本地部署优势：
OpenClaw 可以部署在远程服务器上，通过 Tailscale 或 SSH 隧道进行访问。
远程部署架构：
部署步骤：
远程部署优势：
Docker 部署提供了隔离、一致的运行环境，适合生产环境和团队使用。
Docker 配置示例：
version:'3.8'
services:
openclaw:
image: openclaw/openclaw:latest
ports:
- "18789:18789"
volumes:
- ./data:/root/.openclaw
environment:
- NODE_ENV=production
restart: unless-stopped
Docker 部署优势：
OpenClaw 设计了强大的扩展和集成能力，允许用户根据需求定制和扩展系统功能。
OpenClaw 支持插件扩展，可通过以下方式扩展功能：
插件开发流程：
OpenClaw 提供多种集成方式，便于与其他系统和服务集成：
API 示例（CLI 命令）：
# 发送消息
openclaw message send --to +1234567890 --message "Hello from OpenClaw"
# 执行 AI 任务
openclaw agent --message "Write a blog post about AI" --thinking high
# 管理设备
openclaw nodes list
OpenClaw 支持与多种第三方服务集成，扩展系统能力：
集成示例（AI 模型配置）：
{
"agent": {
"model": "anthropic/claude-opus-4-5",
"fallbackModels": [
"openai/gpt-4o",
"openai/gpt-3.5-turbo"
]
}
}
OpenClaw 提供完善的监控和维护系统，确保系统稳定运行和及时故障处理。
OpenClaw 的日志系统设计详细，便于问题排查和系统监控：
日志配置示例：
{
"logging": {
"level": "info",
"file": "/path/to/logs/openclaw.log",
"maxSize": "10MB",
"maxFiles": 5
}
}
OpenClaw 内置健康检查功能，定期检查系统状态：
openclaw health，检查 Gateway 运行状态健康检查示例输出：
Gateway: OK
Channels: WhatsApp: Connected Telegram: Connected Slack: Disconnected
Models: Anthropic Claude: Available OpenAI GPT-4: Available
Devices: macOS: Connected iOS: Connected Android: Disconnected
OpenClaw 提供多种故障排查工具和方法，帮助用户解决系统问题：
openclaw doctor，自动检测和修复常见问题故障排查流程：
openclaw doctor 检测常见问题OpenClaw 实施多种性能优化策略，确保系统运行高效、响应迅速。
OpenClaw 团队规划了清晰的未来发展方向，持续改进和扩展系统功能。
场景描述：作为个人 AI 助手，帮助用户管理日常任务和信息。
功能需求：
配置示例：
{
"agent": {
"model": "anthropic/claude-opus-4-5",
"thinkingLevel": "medium"
},
"channels": {
"whatsapp": {
"enabled": true,
"allowFrom": ["+1234567890"]
},
"telegram": {
"enabled": true,
"botToken": "your-telegram-bot-token"
}
}
}
场景描述：作为团队协作助手，帮助团队成员协调工作和共享信息。
功能需求：
配置示例：
{
"agent": {
"model": "openai/gpt-4o",
"thinkingLevel": "high"
},
"channels": {
"slack": {
"enabled": true,
"botToken": "your-slack-bot-token",
"appToken": "your-slack-app-token"
},
"discord": {
"enabled": true,
"token": "your-discord-bot-token"
}
},
"security": {
"sandbox": {
"mode": "non-main"
}
}
场景描述：作为开发助手，帮助开发者编写代码、解决问题。
功能需求：
配置示例：
{
"agent": {
"model": "anthropic/claude-opus-4-5",
"thinkingLevel": "xhigh"
},
"browser": {
"enabled": true,
"color": "#FF4500"
},
"skills": {
"enabled": true,
"include": ["github", "code"]
}
}
OpenClaw 采用现代化、模块化的技术架构，以 Gateway 为核心控制平面，通过 WebSocket 连接各种客户端和服务，实现了一个功能强大、灵活可扩展的个人 AI 助手系统。
OpenClaw 为用户提供了一个功能强大、安全可靠的个人 AI 助手解决方案，具有以下应用价值：
OpenClaw 作为一个开源项目，具有广阔的发展前景：
OpenClaw 的技术架构为构建个人 AI 助手提供了一个完整的解决方案，不仅满足了当前的需求，也为未来的发展预留了充足的空间。它展示了如何将现代 AI 技术、实时通信和多设备集成结合起来，创建一个真正实用的个人 AI 助手系统。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online