3分钟搞懂 OpenClaw

HarryPoint
0 阅读4分钟

一、项目概述

OpenClaw 是一款开源的自托管 AI 代理网关，支持将 WhatsApp、Telegram、Discord、iMessage 等主流聊天应用与 AI 编码代理（如 Pi）无缝连接，让用户可以随时随地通过消息渠道访问个人 AI 助手，完全掌控数据主权。

核心定位

  • 目标用户：开发者和高级用户，需要可自定义、数据可控的个人 AI 助理
  • 核心优势：自托管、多渠道支持、Agent 原生设计、完全开源（MIT 许可证）
  • 最低要求：Node 22+ 运行环境，以及你选择的 AI 提供商 API Key

二、最新版本信息

最新稳定版：2026.3.8（发布于 2026 年 3 月 8 日）

可通过 npm 直接安装最新版本：

npm install -g openclaw@latest

三、核心功能与架构

工作原理

OpenClaw 采用网关架构，作为唯一的流量入口，统一管理会话、路由和渠道连接：

聊天应用 + 扩展插件 → OpenClaw 网关 → AI 代理 / CLI / 控制面板 / 移动节点

关键能力

功能分类具体能力
多渠道网关同时支持 WhatsApp、Telegram、Discord、iMessage，可通过扩展插件新增 Mattermost 等渠道
多代理路由支持按代理、工作区、发送者隔离会话，实现多场景并行工作
媒体支持原生支持图片、音频、文档等富媒体消息传输
Web 控制面板内置浏览器管理界面，支持聊天、配置、会话管理、节点监控
移动节点可配对 iOS/Android 设备，实现画布、相机、语音等移动端工作流

四、快速上手

3 分钟安装部署

  1. 安装 OpenClaw
npm install -g openclaw@latest
  1. 初始化配置并安装后台服务
openclaw onboard --install-daemon
  1. 登录聊天渠道并启动网关
openclaw channels login
openclaw gateway --port 18789

访问控制面板

启动后可通过浏览器访问本地管理界面：

  • 默认地址：http://127.0.0.1:18789/
  • 远程访问：支持 SSH 隧道或 Tailscale 配置

五、配置说明

配置文件默认路径：~/.openclaw/openclaw.json

基础配置示例

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+15555550123"],
      "groups": { "*": { "requireMention": true } }
    }
  },
  "messages": {
    "groupChat": { "mentionPatterns": ["@openclaw"] }
  }
}

默认情况下，OpenClaw 会使用内置的 Pi 二进制文件以 RPC 模式运行，按发送者自动隔离会话。

六、生态系统

ClawHub 技能市场

ClawHub 是 OpenClaw 官方的技能市场，提供可直接安装的扩展能力：

  • 访问地址：clawhub.ai/
  • 支持搜索、安装、更新、发布 Agent 技能，扩展 OpenClaw 能力边界

六、常用技能介绍

OpenClaw 提供丰富的技能扩展，覆盖各类常见工作场景，以下是常用技能列表：

技能名称功能描述使用场景
飞书多维表格（feishu-bitable）支持飞书多维表格的创建、查询、编辑和管理，包含27种字段类型、高级筛选、批量操作和视图管理需要管理飞书数据表、批量导入/导出数据、自定义表格结构
飞书日历（feishu-calendar）飞书日历与日程管理工具集，包含日历管理、日程管理、参会人管理、忙闲查询安排会议、查询日程、查看他人忙闲状态、管理会议邀请
飞书云文档（feishu-fetch-doc/feishu-create-doc）飞书云文档的读取与创建，支持Markdown格式互转、图片和附件处理读取飞书文档内容、从Markdown创建飞书文档、批量处理文档
飞书IM消息（feishu-im-read）飞书消息读取工具，支持历史消息获取、话题回复读取、跨会话消息搜索、资源下载查看群聊历史、搜索聊天记录、下载消息中的图片和文件
飞书任务（feishu-task）飞书任务管理工具，支持任务创建、查询、更新，清单管理，负责人和截止时间设置创建待办任务、管理任务清单、设置任务提醒和负责人
编码代理（coding-agent）自动将编码任务委托给Codex、Claude Code等AI代理，支持文件探索和迭代编码开发新功能、代码重构、PR审查、复杂代码项目开发
GitHub（github）集成GitHub CLI，支持Issue、PR、CI运行和高级查询管理管理GitHub仓库、处理Issue和PR、查看CI运行状态
安全检查（healthcheck）主机安全加固和风险配置工具，支持安全审计、防火墙/SSH/更新加固、定期检查服务器安全配置、漏洞检查、定期安全审计
天气查询（weather）无需API Key的天气查询工具，支持当前天气和预报获取查询任意地区的天气情况、温度和天气预报
技能创建器（skill-creator）自定义Agent技能的创建和打包工具，支持脚本、引用和资产打包开发自定义技能、扩展OpenClaw能力

七、资源链接

八、安全特性

  • 完全自托管，所有数据存储在用户自己的设备上
  • 支持白名单、提及规则等访问控制
  • 内置令牌管理和安全控制机制
  • 开源透明，无隐藏数据上传逻辑
avatar
文章
阅读
粉丝