OpenClaw开源 AI Agent 完全指南

OpenClaw 🦞 龙虾的崛起：开源 AI Agent 完全指南一个让 AI 助手住在你自己机器上、通过你常用聊天 App 响应你的开源 Agent 平台——从周末黑客项目到 GitHub 历史上增长最快的仓库之一。目录项目背景：一段混乱而精彩的重命名史核心功能快速安装基础使用：日常对话场景Lobster 工作流引擎生态仓库导览安全须知一、项目背景：一段混乱而精彩的重命名史2025 年 11 月，奥地利独立开发者 Peter Steinberger 在一个周末把一个"WhatsApp 消息转发中继"的实验脚本发布到了 GitHub，最初命名为Clawd——一个对 Anthropic 旗下 Claude 模型的文字游戏（Clawd = Claude + claw，爪子）。他的初衷不过是让自己的 AI 助手能在 WhatsApp 上回复消息。没想到这个项目在社区迅速引发共鸣——人们渴望一个运行在自己设备上、不依赖任何 SaaS 平台、通过现有聊天 App 交互的 AI 代理。项目病毒式传播，数天内获得数万 Star。重命名时间线🦀 2025 年 11 月 — Clawd 诞生Peter Steinberger 发布初版，定位"WhatsApp AI 中继"。项目以 Anthropic Claude 模型为 AI 引擎，命名致敬其 Clawd ≈ Claude + claw。⚖️ 2026 年 1 月 27 日 — Anthropic 商标投诉 → 更名 MoltbotAnthropic 法务团队认为 “Clawd” 与其模型名 “Claude” 过于相似，发出通知要求更名。Steinberger 在凌晨 5 点与社区 Discord 进行了一场混乱的头脑风暴，最终选定Moltbot（取"蜕壳"之意，龙虾蜕壳象征成长）。🦞 2026 年 1 月 30 日 — 最终更名 OpenClawSteinberger 觉得 Moltbot “说起来完全不顺口”，仅三天后再度更名为OpenClaw。这次做足了功课：商标检索通过、域名已购入、迁移代码已写好。吉祥物依然是龙虾，一些神圣的事物不可改变。📦 2026 年 2 月 14 日 — Steinberger 加入 OpenAI，项目移交社区基金会在项目 GitHub Star 突破 24.7 万之际，Steinberger 宣布加入 OpenAI，项目进入由社区主导的开源基金会治理阶段。同期 Tencent 宣布基于 OpenClaw 构建全套 WeChat 集成 AI 产品。⚡重命名风波中的 10 秒事故Steinberger 在更名时先释放了旧 GitHub 和 X 账户，再注册新账户。这 10 秒的窗口期被加密骗局立刻利用——他们抢注账户并在 Solana 上发行了假代币，市值一度冲到 1600 万美元后归零。这一事件被安全研究人员称为"AI 时代的操作安全教科书反面案例"。二、核心功能OpenClaw 的定位是本地优先、频道无关的个人 AI Agent。它运行在你自己的设备上（笔记本、家庭服务器、VPS 均可），通过你日常使用的消息平台响应指令。支持的消息频道（20+）类别频道主流即时通讯WhatsApp、Telegram、Signal、iMessage、LINE、Zalo团队协作Slack、Discord、Microsoft Teams、Google Chat、Mattermost、飞书中国平台微信（WeChat）、企业微信、Zalo Personal去中心化 / 其他Matrix、IRC、Nostr、Tlon、BlueBubbles、Twitch、WebChat核心能力一览功能说明🖥️ 本地优先，数据不离机Gateway 跑在你自己的硬件上，API 密钥、历史记录、技能配置全部存本地，不经过任何第三方 SaaS 服务器🎙️ 语音交互在 macOS / iOS / Android 上支持语音说话和收听，真正的对话体验，而非仅文字🎨 Canvas 实时渲染可渲染一个你能交互的实时 Canvas，用于展示图表、代码执行结果、可视化输出🔧 Skills 技能扩展通过 SKILL.md 文件包为 Agent 安装专项知识和操作规程，社区已有数千个技能可用⚙️ MCP 工具集成支持 MCP（Model Context Protocol），可接入数据库、GitHub、日历、邮件等外部服务🔄 多模型支持除 Claude 外，支持 OpenAI、Gemini、DeepSeek、Ollama 本地模型及任意 OpenAI 兼容端点📅 记忆与上下文跨对话保留记忆，记住用户偏好、项目上下文、历史指令🤖 自主 Agent 模式支持多步骤任务规划与自主执行，无需逐条指令三、快速安装环境要求：Node.js 24（推荐）或 Node.js 22.16 以上版本。支持 macOS、Linux（含 Docker）和 Windows（通过 openclaw-windows-node 套件）。GitHub 主仓库：https://github.com/openclaw/openclaw方式一：npm 标准安装（推荐新手）OpenClaw 官方推荐通过 npm 全局安装后运行交互式 onboard 向导，向导会引导你一步步完成 Gateway 守护进程、工作区、频道和技能的配置。第 1 步：安装 OpenClaw CLI# 推荐：npmnpminstall-gopenclaw@latest# 或使用 pnpmpnpmadd-gopenclaw@latest# 验证安装成功openclaw--version第 2 步：运行 onboard 向导这是官方最推荐的入口，会自动完成所有配置并安装守护进程（launchd / systemd）让 Gateway 常驻后台：openclaw onboard --install-daemon# 向导会依次引导你完成：# 1. 选择 AI 模型提供商（Claude / OpenAI / Ollama / DeepSeek...）# 2. 输入 API 密钥# 3. 配置消息频道（如 Telegram Bot Token）# 4. 安装 Gateway 守护进程（launchd on macOS / systemd on Linux）# 5. 验证连通性第 3 步：以 Telegram 为例配置第一个频道向导会询问频道类型。选择 Telegram 后，需要先在 Telegram 中和 @BotFather 对话创建一个 Bot 并获取 Token：# 1. 在 Telegram 搜索 @BotFather 并发送：/newbot# 2. 按提示输入 Bot 名称和用户名，获得类似以下的 Token：# 7123456789:AAHdqTcvE-Xe_abcdefghij1234567890# 3. 回到 onboard 向导，粘贴 Token 即可# 4. 完成后，向 Bot 发送任意消息验证连通第 4 步：检查 Gateway 状态# 查看 Gateway 运行状态openclaw status# 查看日志openclaw logs--tail50# 停止 / 重启openclaw stop openclaw restart方式二：Docker 安装（服务器 / VPS 部署推荐）如果你想部署在 VPS 或家庭服务器上，官方提供 Docker 镜像，这是生产环境最稳定的部署方式：