玩转 OpenClaw：打造你的私有 AI 助手网关一站式连接 WhatsApp、Telegram、Discord、iM

一站式连接 WhatsApp、Telegram、Discord、iMessage 等主流聊天平台，让 AI 助手触手可及。

前言

在 AI 大模型蓬勃发展的今天，我们习惯了与 ChatGPT、Claude 等 AI 助手对话。但你有没有想过：能不能用自己的 AI 助手，通过日常使用的聊天软件随时调用？

OpenClaw 应运而生。它是一个自托管的 AI 网关，让你在 WhatsApp、Telegram、Discord、iMessage 等平台上，无缝接入自己的 AI Agent。无需依赖第三方服务，数据完全掌握在自己手中。

什么是 OpenClaw？

OpenClaw 是一个开源的多渠道 AI 网关（MIT 许可证），核心定位如下：

【自托管】部署在自己的机器或服务器上，数据主权完全可控

【多渠道】单个 Gateway 进程同时服务 WhatsApp、Telegram、Discord、iMessage

【Agent 原生】专为 AI Agent 设计，支持工具调用、会话管理、记忆持久化、多代理路由

【插件生态】通过插件扩展支持 Mattermost 等更多平台

适用人群：开发者和高级用户，希望拥有一个随时随地可调用的个人 AI 助手，同时不希望将数据交给第三方托管服务。

架构概览

整个系统以 Gateway 为核心，上层连接各种聊天应用和插件，下层对接 AI Agent、CLI 工具和 Web 控制界面。

Gateway 是整个系统的单一可信源，负责会话管理、消息路由和渠道连接。

核心能力

1. 多渠道网关

一个 Gateway 进程，同时服务多个聊天平台：

WhatsApp — 通过 openclaw channels login 扫码配对

Telegram — 配置 Bot Token 即可接入

Discord — 支持 Bot 和 Webhook 模式

iMessage — macOS 原生支持

插件扩展 — Mattermost、飞书等通过插件支持

2. 多代理路由

支持复杂的代理架构：

按发送者隔离 — 每个用户独立的会话上下文

按工作区隔离 — 不同项目使用不同的 Agent 配置

按代理类型路由 — 编码任务路由到 Codex，日常对话路由到通用模型

3. 媒体支持

不仅仅是文本：发送和接收图片、处理音频消息（支持语音转文字）、处理文档和附件。

4. Web 控制界面

内置浏览器仪表盘，地址：http://127.0.0.1:18789/

功能包括：聊天、配置管理、会话查看、节点配对。

5. 移动端节点

支持 iOS 和 Android 设备配对，提供远程控制能力、Canvas 画布支持、推送通知。

快速开始

环境要求

Node.js 22+

API Key（推荐 Anthropic，也支持 OpenAI、智谱等）

5 分钟时间

安装步骤

Step 1：安装 OpenClaw

npm install -g openclaw@latest

Step 2：运行配置向导

openclaw onboard --install-daemon

向导会引导你完成 API Key 配置、默认模型选择、服务安装（可选）。

Step 3：配对聊天渠道

openclaw channels login

openclaw gateway --port 18789

Step 4：打开控制界面

浏览器访问 http://127.0.0.1:18789/，即可看到 Web 控制界面。

完成！现在你可以在 WhatsApp 中给配对的号码发消息，与你的 AI 助手对话了。

配置详解

配置文件位于 ~/.openclaw/openclaw.json。默认配置下，OpenClaw 使用内置的 Pi Agent，无需额外配置即可工作。

基础配置示例

{ model: "claude-sonnet-4-20250514", channels: { whatsapp: { allowFrom: ["+8613800138000"], groups: { "*": { requireMention: true } } }, telegram: { botToken: "your-bot-token" } }, messages: { groupChat: { mentionPatterns: ["@openclaw", "@助手"] } } }

多模型配置

OpenClaw 支持多个模型提供商：Anthropic (Claude 系列)、OpenAI (GPT 系列)、智谱 AI (GLM 系列)、MiniMax，以及其他兼容 OpenAI API 的服务。

安全配置

支持配置 API Token 用于远程访问、设置允许的来源 IP 白名单、只读模式等安全选项。

高级特性

Skills 技能系统

Skills 是 OpenClaw 的扩展机制，让 Agent 获得特定领域的专业能力。

内置 Skills 包括：feishu-doc（飞书文档读写）、feishu-drive（飞书云存储管理）、coding-agent（编码任务委托）、weather（天气查询）、healthcheck（主机安全加固）。

访问 ClawHub (clawhub.com) 可发现更多社区贡献的技能包。

Heartbeat 心跳机制

Heartbeat 让 Agent 能够定期主动检查任务，而不是被动等待消息。可以在 HEARTBEAT.md 中配置检查项，如检查新邮件、查看日程安排、检查天气预警等。

Subagent 子代理

对于复杂任务，可以派生子代理在后台工作。子代理工作在隔离的会话中，完成后自动汇报结果。

远程访问

支持三种方式：Tailscale（通过内网穿透安全访问）、SSH 隧道、反向代理（需配置 HTTPS 和安全措施）。

最佳实践

1. 生产环境部署

使用 PM2 管理 Gateway 进程，设置开机自启。

2. 日志管理

使用 openclaw logs --follow 查看实时日志，openclaw logs --export 导出日志。

3. 备份配置

定期备份 ~/.openclaw 目录。

4. 安全加固

定期更新：openclaw update

运行安全审计：openclaw security audit --deep

限制来源：配置 allowFrom 白名单

使用强 Token：生成 32 位以上随机 Token

常见问题

Q: 支持哪些 AI 模型？

A: 支持主流模型提供商，包括 Anthropic、OpenAI、智谱 AI、MiniMax 等。

Q: 可以在群聊中使用吗？

A: 可以。配置 requireMention: true 后，Agent 只在被 @ 提及时响应，避免干扰正常群聊。

Q: 数据存储在哪里？

A: 所有数据存储在本地 ~/.openclaw/ 目录，包括会话历史、配置文件、记忆文件、日志。

Q: 如何查看当前状态？

A: 使用 openclaw status 命令，加 --deep 参数可查看详细信息。

总结

OpenClaw 为开发者和高级用户提供了一个私密、可控、强大的 AI 助手解决方案。通过自托管网关，你可以在熟悉的聊天软件中随时调用 AI、完全掌控自己的数据、灵活配置模型和路由策略、通过 Skills 扩展无限可能。

开源免费，5 分钟上手，生产可用。

玩转 OpenClaw：打造你的私有 AI 助手网关

前言