OpenClaw 个人人工智能助手详细中文介绍

🦞 OpenClaw — 个人人工智能助手，一款完全运行在用户自有设备上的私有AI助手，核心定位是“本地优先、全渠道接入、可控可定制”，无需依赖第三方云服务，所有数据和操作均在用户设备上完成，兼顾速度、安全性与实用性，由Peter Steinberger和社区共同开发，专为太空龙虾AI助手Molty打造，遵循MIT许可证开源。

一、核心定位与核心优势

1.1 核心定位

OpenClaw 并非传统的云端AI助手，而是一个“本地AI中枢”——以Gateway（网关）为核心控制平面，整合多渠道交互、多设备联动、本地硬件调用、AI模型部署等功能，让用户可以通过任意常用聊天软件、设备终端，快速调用AI能力，且全程由用户掌控数据和配置，主打“单人专属、始终在线、响应迅速”的使用体验。

适用人群：追求隐私安全、需要本地AI能力的个人用户；希望在多聊天渠道统一使用AI的用户；喜欢自主部署、定制化配置的极客/开发者；需要调用本地硬件（相机、屏幕、麦克风）的AI使用者。

1.2 核心优势

本地优先：所有会话、配置、数据均存储在用户自有设备，不泄露隐私，响应速度远超云端AI（无需网络传输延迟），断网环境下可正常使用本地功能。
全渠道接入：支持几乎所有主流即时通讯平台作为交互入口，无需切换APP，在常用聊天软件中即可调用AI，覆盖工作、生活全场景。
多设备联动：支持macOS/iOS/Android多系统协同，网关可部署在Linux/macOS/Windows（WSL2），客户端可在手机、电脑上联动，实现跨设备操作。
强大本地能力：可调用设备硬件（相机、屏幕、麦克风、定位），支持语音唤醒、通话模式、实时Canvas可视化，还能实现浏览器自动化、定时任务等功能。
高度可定制：支持多AI模型切换、故障转移，可配置沙箱隔离、权限管控，还能通过ClawHub技能注册中心添加自定义技能，适配不同用户需求。
安全可控：默认开启私信配对验证，陌生人无法触发AI；支持Docker沙箱隔离风险会话，可配置工具权限白名单，远程访问需通过安全隧道，全方位保障使用安全。

二、核心功能模块详解

2.1 核心平台（Gateway 网关 + 基础组件）

Gateway（网关）是OpenClaw的核心控制平面，负责统筹所有会话、状态、配置、定时任务、Webhooks、控制UI和Canvas主机，本质是一个WebSocket网络服务（默认地址：ws://127.0.0.1:18789），所有客户端、工具、设备均通过网关进行通信。

核心基础组件包括：

CLI接口：提供完整的命令行操作，涵盖网关启动、代理调用、消息发送、入职引导、故障排查等所有功能，是核心操作入口。
Pi代理运行时环境：采用RPC模式，支持工具流式传输和块流式传输，负责执行AI指令、调用本地工具，实现AI与设备的联动。
会话模型：默认提供main主会话（用于直接聊天），支持群组隔离、激活模式、队列模式，可根据场景切换会话规则，避免不同场景的会话干扰。
媒体管道：支持图像、音频、视频的处理，包含转录钩子、大小限制、临时文件生命周期管理，可实现语音转文字、图像识别等功能（音频功能需依赖ElevenLabs或系统TTS）。

2.2 全渠道接入（聊天渠道详解）

OpenClaw支持30+主流聊天渠道，用户可在任意渠道发送指令、获取AI响应，无需额外安装专用APP，具体支持渠道及配置要点如下：

常用社交/办公渠道：WhatsApp（基于Baileys）、Telegram（基于grammY）、Slack（基于Bolt）、Discord（基于discord.js）、Google Chat（基于Chat API）、Signal（基于signal-cli）、飞书、LINE、Microsoft Teams、Matrix、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、Twitch、Zalo、Zalo Personal。
苹果生态渠道：BlueBubbles（推荐的iMessage集成方案，需搭配BlueBubbles服务器）、iMessage（旧版，需登录macOS“信息”应用）。
其他渠道：IRC（互联网中继聊天）、WebChat（网关自带，无需额外配置）、微信（通过腾讯官方插件@tencent-weixin/openclaw-weixin，需OpenClaw ≥2026.3.22版本）。

渠道通用配置要点：所有渠道均支持“允许列表”（allowFrom），可指定允许与AI对话的用户/群组；群组支持“提及门控”“回复标签”，可按频道分块路由会话，避免无关消息干扰。

2.3 多设备客户端（应用 + 节点）

OpenClaw的客户端分为“网关主机”和“设备节点”，网关主机负责运行核心服务，设备节点负责提供本地硬件能力，两者通过WebSocket联动，所有客户端均为可选，仅部署网关即可实现基础AI功能。

（1）macOS 应用（OpenClaw.app）

功能：菜单栏控制面板（可查看网关状态、启动/停止服务）、语音唤醒+一键通话叠加、WebChat界面、调试工具、远程网关控制（通过SSH）。

注意：需使用已签名的构建版本，否则macOS权限（如屏幕录制、相机访问）会失效，具体可参考macOS权限文档。

（2）iOS 节点

功能：通过网关WebSocket完成设备配对、语音触发转发、Canvas可视化界面、相机控制、屏幕录制，可通过“openclaw nodes …”命令进行远程控制。

配置：需遵循iOS连接操作手册，完成节点配对后即可联动网关，实现跨设备操作。

（3）Android 节点

功能：包含“连接/聊天/语音”三大选项卡，支持Canvas可视化、相机快照/剪辑、屏幕录制、Android设备命令（获取通知、定位、短信、照片、联系人、日历、运动数据、应用更新）。

配置：通过“openclaw devices …”命令完成WS节点配对，无需额外安装复杂组件，遵循Android连接操作手册即可。

（4）节点核心能力

所有设备节点均可通过“node.invoke”指令，向网关发送本地操作请求，核心能力包括：相机快照/剪辑、屏幕录制、位置获取、系统通知、macOS专属的system.run（运行本地命令）/system.notify（发送系统通知）。

2.4 工具与自动化功能

OpenClaw内置丰富工具，支持自动化场景配置，无需额外开发即可实现多种实用功能，核心工具包括：

浏览器控制：专用openclaw Chrome/Chromium浏览器，支持快照、自动化操作、文件上传、配置文件管理，基于CDP协议实现，可用于网页爬取、自动化测试等场景。
Canvas 可视化：基于A2UI技术，由AI驱动的可视化工作空间，支持推送、重置、评估、快照，可用于展示AI生成的内容、操作界面等。
定时任务与Webhooks：支持Cron定时任务、唤醒功能，可配置Webhooks接收外部触发器，还能集成Gmail发布/订阅，实现邮件触发AI操作。
技能平台：支持捆绑式、管理式、工作区三种技能类型，技能存储在~/.openclaw/workspace/skills/目录下，每个技能包含SKILL.md配置文件，可通过ClawHub技能注册中心自动搜索、添加新技能。
代理到代理（sessions_* 工具）：用于跨会话协调工作，无需切换聊天界面，核心命令包括sessions_list（查看活跃会话）、sessions_history（获取会话日志）、sessions_send（向其他会话发送消息）。

2.5 语音与通话功能

OpenClaw支持语音交互，覆盖多设备场景，核心功能包括：

语音唤醒：macOS/iOS设备支持唤醒词触发，Android设备支持连续语音识别，无需手动输入指令。
通话模式：macOS/iOS支持通话模式叠加，可通过语音与AI实时对话，Android设备支持语音转文字、文字转语音（依赖ElevenLabs或系统TTS，提供回退方案）。

三、安装与快速入门（详细步骤）

3.1 前置要求

运行时：Node.js 24（推荐）或 Node.js 22.16+，需提前安装。
包管理器：支持npm、pnpm、bun，推荐使用pnpm（构建源代码时更稳定）。
系统支持：网关可运行在macOS、Linux、Windows（需通过WSL2，强烈推荐）；设备节点支持macOS、iOS、Android。
可选依赖：Docker（用于沙箱隔离）、Tailscale（用于远程访问）、signal-cli（用于Signal渠道）、BlueBubbles服务器（用于iMessage集成）。

3.2 推荐安装方式（入门首选）

通过npm/pnpm全局安装，配合onboard命令完成引导式配置，适合新手，步骤如下：

安装OpenClaw： npm install -g openclaw@latest# 或使用pnpm（推荐）pnpm add -g openclaw@latest
启动入职引导，安装网关守护进程： openclaw onboard --install-daemon说明：OpenClaw Onboard会引导用户逐步完成网关、工作区、通道、技能的配置，自动安装Gateway守护进程（launchd/systemd用户服务），确保网关始终运行，无需手动启动。
启动网关（手动启动，若守护进程未自动运行）： openclaw gateway --port 18789 --verbose说明：–port指定网关端口（默认18789），–verbose开启详细日志，便于排查问题。
测试功能（发送消息、调用AI）： # 发送消息（替换手机号为目标号码）openclaw message send --to +1234567890 --message "Hello from OpenClaw"# 调用AI助手（可指定消息内容，thinking指定思考级别）openclaw agent --message "帮我生成一份旅行 checklist" --thinking high

3.3 源代码安装（开发/定制化需求）

适合需要修改源代码、自定义功能的开发者，推荐使用pnpm构建，步骤如下：

克隆代码仓库： git clone https://github.com/openclaw/openclaw.gitcd openclaw
安装依赖并构建： pnpm installpnpm ui:build # 首次运行会自动安装UI依赖pnpm build说明：pnpm build会生成dist/目录，用于通过Node运行或打包OpenClaw二进制文件。
启动入职引导并安装守护进程：pnpm openclaw onboard --install-daemon说明：pnpm openclaw … 可直接运行TypeScript代码（通过tsx），无需额外编译。
开发调试（自动重载）： pnpm gateway:watch说明：修改源代码或配置文件后，会自动重载网关，无需手动重启。

3.4 版本升级与渠道切换

（1）版本升级

运行更新命令，并使用doctor工具排查潜在问题：

openclaw update

openclaw doctor # 排查配置错误、风险项

（2）开发渠道切换

OpenClaw提供3种开发渠道，可根据需求切换，切换命令如下： openclaw update --channel stable|beta|dev

稳定版（stable）：已标记版本（格式vYYYY.M.D或vYYYY.M.D-<patch>），npm dist-tag为latest，适合日常使用，稳定性最高。
beta版（beta）：预发布版本（格式vYYYY.M.D-beta.N），npm dist-tag为beta，可能缺失macOS应用，适合测试新功能。
dev版（dev）：基于main分支最新代码，npm dist-tag为dev（发布时更新），适合开发者测试，稳定性较差。

四、配置详解（核心配置 + 渠道配置）

4.1 基础配置（最小配置）

OpenClaw的配置文件存储在~/.openclaw/openclaw.json，最小配置仅需指定AI模型，示例如下：

  "agent": {

    "model": "anthropic/claude-opus-4-6" // 可替换为其他支持的模型

}

说明：虽然支持多种模型提供商，但为了获得最佳体验并降低即时注入风险，推荐使用最新一代最强模型，具体可参考入门指南。

4.2 核心配置模块

agent（代理配置）：指定模型、思考级别、会话上下文策略等，支持模型故障转移（身份验证配置文件轮换，支持OAuth与API密钥）。
gateway（网关配置）：指定端口、绑定地址、Tailscale模式、认证方式等，核心参数包括bindloopback（绑定环回接口）、auth（认证配置）、tailscale（远程访问配置）。
channels（渠道配置）：每个渠道的专属配置，如Bot Token、允许列表、群组规则等，具体参考各渠道配置要点。
browser（浏览器配置）：启用浏览器控制、设置浏览器颜色等，示例： {"browser": {"enabled": true,"color": "#FF4500"}}
sandbox（沙箱配置）：用于隔离风险会话，配置非主会话（群组/渠道）在Docker沙箱中运行，限制工具权限。

4.3 常用渠道配置示例

（1）Telegram 配置

需设置TELEGRAM_BOT_TOKEN（环境变量）或channels.telegram.botToken（配置文件），示例：

  "channels": {

    "telegram": {

      "botToken": "123456:ABCDEF", // 替换为你的Telegram Bot Token

      "groups": { "*": { "requireMention": true } }, // 群组需@机器人才能触发

      "allowFrom": ["123456789"] // 允许的用户ID

}

（2）Discord 配置

需设置DISCORD_BOT_TOKEN（环境变量）或channels.discord.token（配置文件），示例：

  "channels": {

    "discord": {

      "token": "1234abcd", // 替换为你的Discord Bot Token

      "allowFrom": ["user123", "guild456"], // 允许的用户/服务器

      "mediaMaxMb": 10 // 媒体文件最大大小（MB）

}

（3）微信配置

需安装腾讯官方插件，步骤如下：安装插件： openclaw plugins install "@tencent-weixin/openclaw-weixin"登录配对： openclaw channels login --channel openclaw-weixin在微信中启用插件：微信 > 我 > 设置 > 插件，找到ClawBot并启用。注意：仅支持私聊，需OpenClaw ≥2026.3.22版本，腾讯正在逐步推出该插件，部分用户可能无法使用。

（4）BlueBubbles（iMessage）配置

推荐的iMessage集成方案，需搭配BlueBubbles服务器（运行在macOS上），配置示例：

  "channels": {

    "bluebubbles": {

      "serverUrl": "http://localhost:1234", // BlueBubbles服务器地址

      "password": "your-password", // BlueBubbles服务器密码

      "webhookPath": "/webhook/openclaw" // 回调路径

}

五、安全配置（重点）

OpenClaw连接多个即时通讯平台，接收外部消息，默认开启安全防护，核心安全配置如下：

5.1 私信访问权限（默认安全策略）

Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/Google Chat/Slack等渠道，默认启用dmPolicy=”pairing”（配对模式），规则如下：

未知发件人发送消息时，会收到一个简短的配对代码，AI不会处理其消息。
用户需手动批准未知发件人： openclaw pairing approve <channel> <code>批准后，发件人会被添加到本地允许列表，后续可正常与AI对话。
若需允许公开私信，需手动设置dmPolicy=”open”，并在allowFrom中添加”*”（允许所有用户），不推荐日常使用。

建议：运行openclaw doctor命令，可自动发现有风险/配置错误的DM策略，及时修复。

5.2 沙箱隔离（群组/渠道安全）

为避免群组/外部渠道的恶意指令风险，可配置沙箱隔离，让非主会话在Docker沙箱中运行，配置示例：

  "agents": {

    "defaults": {

      "sandbox": {

        "mode": "non-main" // 非主会话启用沙箱

}

沙箱默认权限：允许bash、process、read、write、edit、sessions_list、sessions_history、sessions_send、sessions_spawn、browser、canvas、nodes、cron、discord、gateway等工具；拒绝其他高风险操作。

5.3 远程访问安全（Tailscale/SSH）

若需远程访问网关（如在Linux服务器部署网关，在手机/电脑远程控制），推荐使用Tailscale或SSH隧道，避免直接暴露网关端口，核心配置如下：

（1）Tailscale 配置

OpenClaw可自动配置Tailscale Serve（仅限尾网）或Funnel（公共网络），网关保持绑定到环回接口，配置示例：

  "gateway": {

    "tailscale": {

      "mode": "serve", // 可选：off（默认）、serve（尾网访问）、funnel（公共访问）

      "resetOnExit": true // 关机时撤销Serve/Funnel操作

},

    "auth": {

      "mode": "password", // 公共访问（funnel）必须设置密码

      "password": "your-secure-password"

},

    "bindloopback": true // 启用Serve/Funnel时必须保留

}

注意：使用Funnel模式时，必须设置密码认证（gateway.auth.mode: “password”），否则无法启动。

（2）SSH 隧道

通过SSH隧道远程访问网关，无需额外配置网关，仅需在本地终端运行SSH命令，将远程网关端口映射到本地，示例： ssh -L 18789:localhost:18789 user@remote-server映射后，本地可通过ws://127.0.0.1:18789访问远程网关。

5.4 其他安全注意事项

将收到的私信视为不可信输入，避免输入敏感信息（如密码、隐私数据）。
定期运行openclaw doctor，排查配置错误、权限漏洞。
不随意添加未知技能，避免恶意技能获取设备权限。
macOS系统中，开启屏幕录制、相机访问等权限时，需手动授权OpenClaw，避免权限泄露。

六、聊天命令（快速操作）

可通过任意已配置的聊天渠道（如WhatsApp、Telegram、WebChat）发送以下命令，实现快速操作（群组命令仅限群主使用）：

/status：查看精简会话状态（模型类型、代币使用情况、可用时显示费用）。
/new 或 /reset：重置当前会话，清除上下文。
/compact：压缩会话上下文（生成摘要），减少代币消耗。
/think <level>：设置AI思考级别（off|最低|低|中|高|超高），仅支持GPT-5.2 + Codex型号。
/verbose on|off：开启/关闭详细日志输出。
/usage off|tokens|full：设置每次响应的使用情况页脚（关闭/仅显示代币/显示完整使用信息）。
/restart：重启网关（仅限群组所有者）。
/activation mention|always：设置群组激活开关（仅提及机器人时响应/始终响应），仅限群组。

七、工作原理与架构

7.1 核心架构流程

OpenClaw的架构以Gateway（网关）为核心，所有渠道、客户端、工具均通过网关联动，流程如下：

聊天渠道（WhatsApp/Telegram/微信等） → Gateway（控制平面，ws://127.0.0.1:18789） → 分支联动（Pi agent/RPC、CLI、WebChat UI、macOS应用、iOS/Android节点）

关键说明：

网关主机：运行核心服务，执行工具调用、通道连接、模型推理等操作。
设备节点：仅提供本地硬件能力（如相机、屏幕），通过node.invoke指令向网关发送操作请求，不直接执行核心逻辑。
AI模型：由网关调用，支持多模型切换和故障转移，确保AI服务稳定。

7.2 关键子系统

Gateway WebSocket网络：客户端、工具和事件的单一WS控制平面，负责所有组件的通信。
Tailscale曝光：用于远程访问网关仪表板，支持Serve（尾网）和Funnel（公共网络）模式。
浏览器控制：基于CDP协议，由OpenClaw管理的Chrome/Chromium浏览器，实现自动化操作。
Canvas + A2UI：AI驱动的可视化工作空间，用于展示内容、操作界面。
语音唤醒+通话模式：跨设备语音交互，支持唤醒词、实时通话。
节点系统：整合多设备硬件能力，实现跨设备操作联动。

八、进阶功能与资源

8.1 进阶功能

ClawHub（技能注册中心）：极简的技能注册系统，启用后AI可自动搜索、添加新技能，扩展功能。
代理工作区：工作区根目录为~/.openclaw/workspace，可通过配置agents.defaults.workspace修改，支持注入提示文件（AGENTS.md、SOUL.md、TOOLS.md），定制AI性格和能力。
macOS权限扩展：macOS应用可通过node.invoke执行本地命令（system.run）、发送通知（system.notify），需开启对应TCC权限。
会话管理：支持会话修剪、会话迁移，可通过sessions_*工具跨会话协调工作。

8.2 官方资源

官方网站：openclaw.ai
文档索引：包含架构概述、配置参考、操作手册、故障排除等完整资料。
代码仓库：https://github.com/openclaw/openclaw
社区支持：Discord频道、GitHub Issues，可获取技术支持和更新信息。
进阶文档：涵盖远程访问、节点配置、安全指南、平台内部结构等深度内容。

九、常见问题（FAQ）

Q：OpenClaw 必须部署在本地设备吗？ A：是的，核心网关必须运行在用户自有设备（macOS/Linux/Windows WSL2），设备节点（手机）可通过网络联动网关，无需部署核心服务。
Q：支持哪些AI模型？ A：支持OpenAI（ChatGPT/Codex）、Anthropic（Claude）等多种提供商的模型，推荐使用最新一代模型，具体可参考入门指南。
Q：微信渠道无法使用怎么办？ A：确保OpenClaw版本≥2026.3.22，已安装腾讯官方插件并启用，若仍无法使用，可等待腾讯逐步推送插件支持。
Q：如何排查网关启动失败？ A：使用–verbose参数启动网关，查看详细日志；运行openclaw doctor排查配置错误；检查Node.js版本是否符合要求。
Q：可以同时使用多个聊天渠道吗？ A：可以，只需在配置文件中同时配置多个渠道，网关会自动统筹所有渠道的会话，无需额外操作。

总结：OpenClaw 是一款功能强大、安全可控的本地个人AI助手，核心优势在于“本地优先、全渠道接入、多设备联动”，适合追求隐私安全、需要定制化AI体验的用户，无论是日常聊天、本地工具调用，还是自动化场景配置，都能满足需求，且开源免费，支持用户自定义开发和扩展。

OpenClaw 个人人工智能助手 详细中文介绍