折腾了整整两天终于把 OpenClaw 部署好了过程中踩了不少坑今天把完整流程记录下来希望能帮到想入门的小伙伴。本文适合零基础新手大佬请绕道~既然都开始养虾了那肯定少不了让它来生成一篇养虾的过程文章。目录 什么是 OpenClaw️ 环境准备硬件要求软件要求 安装步骤方式一macOS 用户最简单方式二命令行安装跨平台方式三Docker 部署适合服务器 详细配置 渠道配置详解Telegram 配置步骤Discord 配置步骤 启动与验证架构流程图 常见问题汇总⚠️ 注意事项 参考资料 最后 什么是 OpenClaw简单来说OpenClaw 是一个自托管的 AI 网关它可以把你常用的聊天软件微信、Telegram、Discord、iMessage…和一个 AI 助手连接起来。举几个例子 在微信上发消息AI 就能自动回复 在 Discord 群里 它AI 就能参与讨论 人在外面用 WhatsApp 随时召唤你的私人 AI为什么叫龙虾官方 Logo 就是一只红色卡通龙虾 英文名 OpenClaw 直译是开源的钳子像龙虾的大爪子️ 环境准备硬件要求配置最低要求推荐配置操作系统macOS 10.15 / Linux / Windows WSL2macOS 12内存8GB16GB存储空间5GB20GB网络能访问国际互联网稳定带宽软件要求# 检查 Node.js 版本需要 Node 22node--version# 如果没有 Node.js推荐使用 nvm 安装curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh|bashnvminstall22nvm use22 小提示如果你用的是 macOS推荐直接用 Homebrew 安装brewinstallnode22 安装步骤方式一macOS 用户最简单如果你用的是 Mac强烈推荐使用官方 App体验最丝滑# 方法 1直接下载安装包# 访问 https://github.com/openclaw/openclaw/releases 下载 .dmg 文件# 方法 2使用 Homebrewbrewinstallopenclaw/tap/openclaw安装完成后打开 OpenClaw.app它会出现在菜单栏。方式二命令行安装跨平台这是最通用的安装方式Linux/Windows WSL/Mac 通用# 1. 全局安装 OpenClaw CLInpminstall-gopenclaw# 2. 验证安装openclaw--version# 3. 初始化设置openclaw setup运行 openclaw setup 后会出现交互式引导按提示选择即可。⚠️ 注意有些渠道需要额外配置比如 Telegram 需要先找 BotFather 申请 Bot TokenDiscord 需要创建开发者应用。方式三Docker 部署适合服务器如果你是部署在服务器上Docker 是最省心的选择# 1. 拉取镜像dockerpull openclaw/openclaw:latest# 2. 创建配置目录mkdir-p~/.openclaw# 3. 运行容器dockerrun-d\--nameopenclaw\-p18789:18789\-v~/.openclaw:/root/.openclaw\openclaw/openclaw:latest 详细配置配置文件位置~/.openclaw/openclaw.json基础配置示例{gateway:{port:18789,verbose:true},channels:{telegram:{enabled:true,botToken:YOUR_BOT_TOKEN_HERE},discord:{enabled:true,botToken:YOUR_DISCORD_BOT_TOKEN}},model:{provider:anthropic,model:claude-sonnet-4-20250514,apiKey:sk-ant-xxx...}} 安全提醒建议使用环境变量而非直接在配置文件写敏感信息 渠道配置详解Telegram 配置步骤Step 1创建 Bot1.打开 Telegram搜索 BotFather2.发送 /newbot 命令3.给你的 Bot 起个名字比如 “我的 AI 助手”4.给你的 Bot 设置用户名必须以 _bot 结尾5.复制 Bot Father 给你的 TokenStep 2配置 OpenClawopenclaw configsetchannels.telegram.botToken你的TokenStep 3启动并测试openclaw gateway# 在 Telegram 中搜索你的 Bot 用户名发送 /start 进行配对Discord 配置步骤Step 1创建 Discord 应用1.访问 https://discord.com/developers/applications2.点击 “New Application”Step 2创建 Bot1.进入 “Bot” 页面2.点击 “Add Bot”3.复制 Bot Token记得开启 Message Content IntentStep 3邀请 Bot 到服务器1.进入 “OAuth2” - “URL Generator”2.勾选 bot 权限3.复制生成的 URL在浏览器中打开并选择服务器 启动与验证启动 Gateway# 前台运行查看日志openclaw gateway--verbose# 后台运行openclaw gateway验证openclaw health打开控制台浏览器访问 http://127.0.0.1:18789架构流程图用户发送消息 → 聊天渠道 → Gateway → AI Model → 返回消息 常见问题汇总Q1启动报错 “Port 18789 already in use”lsof-i:18789# 或者换端口openclaw gateway--port18790Q2Telegram Bot 发消息没反应1.检查 Bot Token 是否正确2.确保已经和 Bot 发起对话需要先私聊 /start3.查看日志openclaw gateway --verboseQ3Discord 提示 “Missing Access”1.检查 Bot 权限是否足够2.确保 Bot 已在服务器中3.在 Discord Developer Portal 检查 intents 设置⚠️ 注意事项1.网络安全部署在公网时务必配置访问密码2.Token 消耗AI 对话需要消耗 API Token注意费用3.隐私安全不要在对话中输入敏感个人信息4.及时更新关注官方 releases 更新安全补丁 参考资料官方文档https://docs.openclaw.aiGitHub 仓库https://github.com/openclaw/openclaw问题交流https://discord.com/invite/clawd 最后部署完成的那一刻看到控制台显示 已连接你就成功开始养虾啦祝大家都能养好自己的小龙虾