什么是 OpenClaw？
OpenClaw（原名 Clawdbot/Moltbot）是一个开源、跨平台的 AI 代理网关。它充当一个桥梁，将流行的即时通讯平台（如 WhatsApp、Telegram、Discord）与后端的大语言模型（如 OpenAI GPT、Anthropic Claude 等）连接起来，让你可以在日常聊天工具中使用个人 AI 助手。
核心架构与特性
OpenClaw 采用中心化的网关架构，主要组件包括：
- Gateway（网关）：核心后台服务，负责管理所有通道连接、消息路由、会话状态和工具调用。
- 控制面板（Dashboard）：基于 Web 的图形界面，用于监控状态、配置代理、管理会话和查看日志。
- 多通道支持：可同时连接 WhatsApp、Telegram、Discord、Google Chat、Mattermost、Signal、iMessage 等多个平台。
- 多代理与路由：支持配置多个 AI 代理，并能根据联系人、群组或内容将消息路由到不同的代理。
- 沙箱与安全：提供会话隔离、工具执行沙箱和私密对话配对审批机制，增强安全性。
- 技能与工具：支持扩展技能（如网页搜索、代码执行、语音通话等），并可通过插件系统增强功能。
快速开始指南
推荐使用官方 CLI 工具进行快速部署和配置，这是最便捷的入门方式。
环境准备
确保系统满足以下要求：
- Node.js：版本 22 或更高。
- 包管理器：推荐使用 pnpm（如果从源码构建）。
- 操作系统：macOS、Linux 或 Windows（强烈建议通过 WSL2 使用）。
- 模型 API 密钥：准备一个可用的 AI 模型 API 密钥，例如 OpenAI、Anthropic 或 Moonshot。
安装 CLI 并运行向导
1. 安装 OpenClaw CLI：
curl -fsSL https://openclaw.bot/install.sh | bash2. 运行交互式配置向导，它会引导你完成核心设置：
openclaw onboard --install-daemon向导将引导你完成以下步骤：
- 选择认证方式：配置 OpenAI OAuth、Anthropic API 密钥或其他模型提供商。
- 设置网关：配置端口、绑定地址和认证令牌。
- 添加通讯通道：配置 WhatsApp（扫码登录）、Telegram（Bot Token）等。
- 安装后台服务：自动安装为 LaunchAgent（macOS）或 systemd 用户服务（Linux/WSL2），确保网关持久运行。
- 引导工作空间：创建初始的工作空间目录，包含代理所需的启动文件。
启动网关并验证
如果向导成功安装了服务，网关应已自动启动。你可以手动检查状态：
openclaw gateway status
openclaw health网关启动后，控制面板默认地址为 http://127.0.0.1:18789/。你可以直接在浏览器中打开并与 AI 助手对话，无需先配置任何聊天通道。
连接第一个聊天通道
以 WhatsApp 为例，在终端执行：
openclaw channels login使用 WhatsApp 手机应用扫描弹出的二维码即可完成链接。对于 Telegram 或 Discord，你需要在向导中提供 Bot Token。
配对与安全审批
默认情况下，来自新联系人的私聊（DM）消息会触发配对流程。助手会回复一个短码，你需要手动批准该配对，消息才会被处理：
openclaw pairing list whatsapp
openclaw pairing approve whatsapp <收到的短码>此机制防止了未经授权的访问。
进阶配置与管理
配置文件与工作空间
你的个性化配置和数据进行如下分离管理，便于更新和备份：
- 主配置文件：
~/.openclaw/openclaw.json，存储网关、通道、代理路由等设置。 - 工作空间：
~/.openclaw/workspace/，存放代理的技能、提示词、记忆等数据。建议将其初始化为私有 Git 仓库。 - 认证信息：OAuth 令牌存储在
~/.openclaw/credentials/，API 密钥存储在~/.openclaw/agents/<代理ID>/agent/auth-profiles.json。
使用 openclaw configure 命令可以交互式地修改特定配置段落。
添加更多 AI 代理
你可以创建多个独立的代理，每个代理拥有自己的工作空间、会话和认证配置：
openclaw agents add <代理名称>然后可以在路由规则中指定特定联系人或群组的消息由哪个代理处理。
技能与工具
OpenClaw 支持丰富的内置技能和工具，例如网页搜索、代码执行、语音通话等。配置向导会推荐安装一些常用技能。你可以在工作空间的 skills/ 目录下管理它们。
故障排除与维护
- 网关未运行：检查服务状态
openclaw gateway status，或手动启动openclaw gateway --verbose。 - 助手无响应：首先运行
openclaw health和openclaw status --all查看详细状态报告，常见原因是模型认证未配置或失败。 - 通道连接失败：检查对应通道的配置（如 Token 是否正确），并查看网关日志
/tmp/openclaw/中的错误信息。 - 保持服务运行：CLI 向导安装的后台服务通常能保证持久运行。在 Linux 上，如果网关在退出登录后停止，可能需要启用 lingering：
sudo loginctl enable-linger $USER。 - 更新：更新 CLI 使用
npm update -g openclaw。你的配置和数据（~/.openclaw/）在更新时会得到保留。
总结
OpenClaw 提供了一个企业级、可扩展的开源框架，用于构建和管理你的个人 AI 助手。通过 CLI 向导，你可以在几分钟内完成从零到第一个可用助手的部署。其清晰的架构分离（网关、配置、工作空间）和强大的功能（多通道、多代理、沙箱安全、技能扩展），使得它既能满足快速上手的简单需求，也能支撑复杂的定制化应用场景。