最近技术圈有个项目特别火 —— OpenClaw，一个开源的本地 AI Agent 平台，GitHub Star 数已经飙到 287k+。
- GitHub：https://github.com/openclaw/openclaw
- 官方文档：https://openclaws.io
- 中文文档：https://openclaws.io/zh/
简单说，它能让你在本地跑一个 AI 助手，接入 Telegram / WhatsApp / Discord 等聊天平台，而且支持多模型、多智能体、工具调用，相当于一个能操控你电脑的私人 AI 管家。
我自己折腾了好几天，踩了不少坑，最后成功部署了多 Bot + 多智能体的架构。这篇文章把所有经验整理出来，保证是你能找到的最详细的教程。
在聊安装之前，先说说它打动我的几个点：
和其他 AI 平台有什么不同？
简单说：OpenClaw 更像一个能干活的 AI 助手，而不只是一个聊天机器人。它能直接操控你的电脑执行任务。
⚠️ 重要提醒：Node.js 版本必须 >= 22，这是最常见的安装失败原因！我第一次装的时候用的 Node 18，直接报错了。
如果你的电脑还没有 Node.js，或者版本太旧，强烈建议用 nvm 来管理 Node.js 版本，这样可以随时切换，不影响其他项目。
- 下载 nvm-windows：https://github.com/coreybutler/nvm-windows/releases
- 安装完成后，打开 管理员权限的 PowerShell，执行：
有三种安装方式，按推荐顺序排列：
截至 2026 年 3 月，OpenClaw 仍处于 beta 阶段，所以需要加 标签。
安装完成后验证：
如果输出版本号，说明安装成功。
Windows (PowerShell)：
macOS / Linux：
如果你更习惯用 Docker Compose，可以创建 ：
然后 即可。
安装完成后，运行配置向导：
这个命令会引导你完成：
- ✅ 选择 AI 模型提供商
- ✅ 输入 API Key
- ✅ 选择接入的聊天平台
- ✅ 自动安装为系统守护进程
如果你想手动配置（更灵活，推荐有经验的用户），继续往下看。
OpenClaw 的核心配置文件位于 ，使用 JSON5 格式（支持注释和尾逗号）。
Windows 路径： macOS/Linux 路径：
创建或编辑 ：
- 访问 https://platform.deepseek.com/
- 注册账号，新用户有免费额度
- 进入「API Keys」页面，创建新 Key
- 复制 Key，填入配置文件的 字段
推荐模型：
- ：日常对话、写代码，速度快、便宜
- ：复杂推理任务，效果媲美 Claude
费用参考（2026年3月）：
- 访问 https://aistudio.google.com/apikey
- 用 Google 账号登录
- 点击「Create API Key」
- 复制 Key
Gemini 是 OpenClaw 内置支持的提供商，只需要在配置中添加环境变量：
如果你不想用云端 API，OpenClaw 也支持通过 Ollama 接入本地模型：
- 安装 Ollama：https://ollama.com/download
- 拉取模型： 或
- OpenClaw 会自动检测本地 Ollama 服务
优点是完全免费、完全离线、数据零泄露，但对电脑配置要求较高（建议 16GB+ 内存、有独立显卡）。
编辑完配置文件后，运行验证命令：
如果输出 ，说明配置没问题。如果报错，根据错误提示修改。
常见验证错误：
Telegram 是目前 OpenClaw 接入最成熟的平台，推荐首选。
- 打开 Telegram，搜索 @BotFather（官方机器人管理器）
- 发送
- 输入 Bot 的显示名称（例如 ）
- 输入 Bot 的用户名（必须以 结尾，例如 ）
- BotFather 会返回一个 Token，类似
- 妥善保管这个 Token，泄露了别人就能控制你的 Bot
- 搜索 @userinfobot 并发送
- 它会回复你的用户 ID（一串数字，例如 ）
- 记下来，后面配置白名单要用
在 中添加 channels 配置：
关键参数说明：
由于众所周知的原因，国内直连 Telegram API 会失败。你需要一个代理。
如果你用的是 Clash for Windows：
如果你用的是 v2ray / Xray：
你可以为 Bot 添加自定义命令菜单，在 Telegram 中输入 时会自动显示：
把这段加到 配置里即可。
除了 Telegram，OpenClaw 还支持：
本教程以 Telegram 为主，其他平台请参考官方文档。
看到类似输出就说明 Telegram 连接成功了：
打开 Telegram，给你的 Bot 发条消息试试！
OpenClaw 最强大的功能之一就是多智能体，你可以创建多个 AI 角色，每个角色有不同的专长、模型和工具权限。
我自己配置了 4 个智能体：
是智能体操作文件的根目录，非常重要：
- AI 的文件读写、代码修改都限定在这个目录范围内
- 不同智能体可以指向不同的 workspace（不同项目）
- 如果不设置，默认是
配置好后，你可以在 Telegram 对话中通过命令切换：
如果你不满足于一个 Bot 承载多个角色，想要每个 Bot 独立运营不同的项目，OpenClaw 也支持！
在 BotFather 里再创建一个 Bot，获取第二个 Token。
关键配置说明：
这样，你给 Bot1 发消息会触发 智能体，给 Bot2 发消息会触发 智能体，互不干扰。
除了 里的简短描述，你还可以创建一个 文件来定义详细的系统指令。
在智能体的 workspace 目录或 下创建 ：
这个文件会作为 AI 的长期记忆，每次对话都会参考。
OpenClaw 是一个能操控电脑的 AI，这意味着你需要注意安全问题：
意味着 AI 可以执行任何 Shell 命令，包括删除文件、修改系统设置等。建议：
- ✅ 仅对你信任的智能体启用
- ✅ 始终使用 限制访问
- ❌ 不要在公共环境或共享电脑上启用
- ❌ 不要让 Bot 处于 模式（任何人都能控制你的电脑）
是模型降级机制：当主模型不可用（超时、余额不足、API 故障）时，自动切换到备用模型：
降级顺序： → →
- 绝不要把包含 API Key 的配置文件上传到公开仓库
- 在 中添加
- 定期在各平台的控制台检查 API 用量是否异常
配置好一切后，最后一步是把 OpenClaw 安装为守护进程，实现后台持续运行 + 开机自启。
OpenClaw 自带一个 Web 管理面板，可以可视化管理所有配置。
默认地址：
Control UI 提供以下功能：
- Overview：总览所有智能体和渠道状态
- Agents：管理智能体配置、切换模型
- Channels：查看 Telegram 等渠道连接状态
- Sessions：管理会话历史
- Logs：查看运行日志、排查问题
- Config：在线编辑配置文件
装好之后，你会发现 OpenClaw 的能力远超你的想象：
- 📝 写代码、审查代码、调试 Bug
- 🔧 执行 Git 操作（commit、push、pull）
- 📦 管理项目依赖
- 🧪 运行测试
- 🖥️ SSH 连接服务器执行命令
- 📊 查看服务器状态（CPU、内存、磁盘）
- 🐳 管理 Docker 容器
- 📋 分析日志
- 🌐 自动打开网页、截图
- 📱 填写表单、点击按钮
- 🔍 搜索信息、爬取数据
- 📄 读取、创建、编辑文件
- 📁 管理文件夹结构
- 🗜️ 压缩、解压文件
- 💬 智能问答、知识查询
- ✍️ 写文案、翻译
- 📅 提醒、总结
把前面所有配置整合在一起，这是一份生产级的完整配置（根据自己需求修改）：
这里整理了我在安装过程中遇到的所有问题和解决方案：
原因：Node.js 版本太低。
解决：
原因：国内无法直连 Telegram API。
解决：配置代理（见第五章 5.4 节）。
原因：Control UI 认证令牌不匹配或过期。
解决：
原因：没有设置网关模式。
解决：在配置文件中添加：
解决：
原因：OpenClaw Telegram 代理只支持 HTTP。
解决：将 改为 。
解决：
解决：检查代理是否正常运行，确保能访问 。
OpenClaw 确实是 2026 年最值得一试的开源 AI 助手平台。虽然安装配置过程有些折腾（特别是国内用户的代理问题），但一旦配好，体验真的很棒。
核心优势回顾：
- 开源免费，数据完全本地化
- 多模型切换，DeepSeek + Gemini 搭配，几乎零成本
- 多智能体，不同角色各司其职
- 工具调用，能操控电脑执行实际任务
- Telegram 接入，手机上随时随地使用
如果你正在寻找一个开源免费、数据本地化、能操控电脑的 AI 助手平台，OpenClaw 绝对是 2026 年的**选择。
如果这篇教程对你有帮助，欢迎分享给需要的朋友！有问题或踩坑经验也欢迎在下面留言讨论 👇
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/231437.html