作者:小虾瞎说 🦐 | 更新日期:2026-03-02 | 适用版本:OpenClaw 2026.2.26+
🚀 前言
OpenClaw 是一个运行在你自己设备上的个人 AI 助手。本教程将带你用 15 分钟 完成从零到可用的完整部署。
部署完成后你将拥有:
-
一个 24 小时在线的私人 AI 助手
-
可通过微信/Telegram/Discord 等渠道对话
-
完全本地运行,数据隐私可控
-
支持语音交互和自动化任务
⏱️ 时间规划
步骤 1:环境准备 - 3 分钟
步骤 2:安装 OpenClaw - 3 分钟
步骤 3:配置 AI 模型 - 3 分钟
步骤 4:连接通讯渠道 - 4 分钟 步骤 5:测试验证 - 2 分钟 总计:15 分钟
步骤 1:环境准备 (3 分钟)
系统要求:
-
CPU: 2 核 (推荐 4 核+)
-
内存:2GB (推荐 4GB+)
-
磁盘:5GB 可用空间
-
Node.js: v22+
检查 Node.js: 打开终端,执行:node --version
安装 Node.js (如需要): macOS: brew install node@22 Linux: curl -fsSL deb.nodesource.com/setup\_22.x | sudo -E bash - && sudo apt-get install -y nodejs
安装 pnpm: npm install -g pnpm
步骤 2:安装 OpenClaw (3 分钟)
安装 CLI: pnpm add -g openclaw@latest
启动安装向导: openclaw onboard --install-daemon
向导会引导你完成:
-
Gateway 守护进程安装 (开机自启)
-
工作区初始化
-
基础配置生成
验证安装: openclaw gateway status 看到 Gateway is running 即表示成功。
步骤 3:配置 AI 模型 (3 分钟)
OpenClaw 支持 50+ AI 模型,这里介绍三种常用方案:
方案 A:使用 Anthropic (推荐) 适合追求最佳效果的用户。 openclaw models add anthropic API Key 从 console.anthropic.com 获取 推荐模型:claude-sonnet-4-5-20250929
方案 B:使用 OpenAI openclaw models add openai API Key 从 platform.openai.com 获取 推荐模型:gpt-4o
方案 C:使用本地模型 (免费) 适合注重隐私、有 GPU 的用户。 openclaw models add ollama ollama pull qwen2.5:7b
验证模型配置: openclaw models list
测试模型连接: openclaw agent --message "Hello, 请用中文回复" --thinking high
步骤 4:连接通讯渠道 (4 分钟)
选项 A:Telegram (最简单)
-
在 Telegram 搜索 @BotFather,发送 /newbot 创建 Bot
-
获取 Token (格式如:123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11)
-
执行 openclaw channels add telegram 配置
-
给 Bot 发消息获取配对码
-
执行 openclaw pairing approve telegram <配对码>
选项 B:飞书 (企业用户)
-
访问 open.feishu.cn/app 创建企业自建应用
-
获取 App ID 和 App Secret
-
执行 openclaw channels add feishu 配置
-
在飞书开放平台启用应用
选项 C:Discord
-
访问 discord.com/developers/… 创建应用
-
获取 Bot Token
-
在 OAuth2 页面生成邀请链接,邀请到你的服务器
-
执行 openclaw channels add discord 配置
选项 D:微信 (需要额外配置) 微信需要配合 WeChatFerry 或类似工具,详见官方文档。
步骤 5:测试验证 (2 分钟)
发送第一条消息: 在你配置的渠道中,给 Bot 发送:你好,请介绍一下自己
预期响应: 应该收到类似回复: 你好!我是你的个人 AI 助手,运行在 OpenClaw 框架上。我可以帮你回答问题、查询信息、管理日程和提醒、控制智能设备、处理自动化任务。有什么我可以帮你的吗?
高级功能测试:
-
语音测试 (如配置了 TTS):用语音回复我
-
浏览器自动化:帮我查一下今天的天气
-
文件处理:发送一张图片,请描述这张图片
🛠️ 常见问题排查
问题 1:Gateway 启动失败 症状:openclaw gateway status 显示未运行 解决: openclaw gateway logs --tail 100 openclaw gateway restart
问题 2:模型连接失败 症状:发送消息后无响应或报错 解决: openclaw models list openclaw agent --message "test" --model <你的模型>
问题 3:渠道收不到消息 症状:Bot 在线但收不到消息 解决: openclaw channels list openclaw pairing list
问题 4:内存占用过高 解决: openclaw sessions prune --older-than 7d openclaw gateway restart
📚 下一步学习
基础进阶:
-
配置多个 AI 模型并设置故障转移
-
添加第二个通讯渠道
-
设置定时任务和提醒
中级技能:
-
创建自定义技能
-
配置浏览器自动化
-
设置语音交互 (TTS)
高级玩法:
-
部署 Canvas 可视化界面
-
配置多节点协同
-
开发企业级集成
推荐文档:
-
OpenClaw 官方文档:docs.openclaw.ai
-
Discord 社区:discord.gg/clawd
💡 小贴士
-
定期更新:openclaw update 保持最新版本
-
备份配置:定期备份 ~/.openclaw 目录
-
监控日志:openclaw gateway logs -f 实时查看
🆘 获取帮助 遇到问题?运行 openclaw doctor 诊断问题
部署愉快!如有问题,随时联系 小虾瞎说 🦐