短短几天GitHub 30万Star!2026年必玩的开源AI网关OpenClaw保姆级部署教程
一、为什么说它是 2026 年值得折腾的前沿项目简单讲它就是你一直想要的那种“真正能干活”的私人 AI 助手。GitHub 上从 9k 星直接冲到 21 万 星然后又一路涨到 30 万被称为2026 年增长最快的开源项目之一。支持的通道多到离谱WhatsApp、Telegram、Slack、Discord、Signal、iMessage、Matrix、飞书、LINE、Mattermost、Nostr……二十多种聊天平台统一接入一个“大脑”。你也可以在你自己的机器上跑网关Gateway数据不离开你的环境非常适合在意隐私的人。我也部署了一个汉化的版本试试很值得我们这种普通用户折腾。像是这里我接入了飞书国际Lark直接在lark app上就可以和他发消息。我一句话概括一下它不是那种“演示项目”而是真正可以当成你 24 小时在线的“AI 私人助理”来用。那么接下来我们就一步一步的来部署这一个软件。二、服务器与账号准备1. 选一台云服务器OpenClaw 本身对资源要求不算夸张但如果你打算同时跑很多模型或者要跑本地模型比如通过 Ollama或者要跑浏览器自动化工具那建议配置稍微宽裕一点。推荐配置跑网关 几个云端模型CPU2 核以上内存4GB 起步建议 8GB系统Ubuntu 22.04 / Debian 12 或类似 Linux 发行版网络有公网 IP端口可放行强烈建议用新出的香港五区带宽大得多价格也合适实测2h4g完美运行。你可以用自己喜欢的云服务商如果暂时没有合适机器可以考虑雨云线路对国内用户比较友好。注册链接在这了雨云-新一代云服务器提供商新注册记得填优惠码techaser绑定微信后有首月五折折扣和永久八折优惠。注后面所有命令都以 root 或有 sudo 权限的用户执行。四、基础环境安装 Docker 和 Docker Composeemmm...其实后面才发现可以用官方的脚本不管了写了就留着吧建议大家都直接使用官方给的一键脚本最好是非大陆地域的服务器可能封海外我用的是香港五区我放在第六小节讲了。OpenClaw 官方已经把 Docker 部署方式文档化了。我们先在服务器上装好 Docker。如果你在雨云买好了服务器并且选了预装docker那你就可以直接跳过了。下面以 Ubuntu/Debian 为例CentOS / Rocky / Alma 等可以对照改包管理器# 1. 更新系统 apt update apt upgrade -y # 2. 安装必要工具 apt install -y ca-certificates curl gnupg lsb-release # 3. 添加 Docker 官方 GPG key 和源 install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg chmod ar /etc/apt/keyrings/docker.gpg echo \ deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable | tee /etc/apt/sources.list.d/docker.list /dev/null # 4. 安装 Docker apt update apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin # 5. 启动并设置开机自启 systemctl enable --now docker 验证安装 docker --version docker compose version能看到版本号就说明没问题。五、获取 OpenClaw 代码并运行 Docker 部署脚本建议使用官方一键脚本而不是docker见第六部分。1. 克隆仓库cd /opt git clone https://github.com/openclaw/openclaw.git cd openclaw仓库根目录下有 docker-compose.yml 和 docker-setup.sh就是用来做容器化部署的。2. 运行 Docker 部署脚本官方推荐直接用脚本./docker-setup.sh这个脚本会做几件事构建或拉取 OpenClaw Gateway 镜像运行 onboard 向导帮你初始化配置生成一个网关令牌写入 .env最后通过 Docker Compose 启动网关。如果你不想本地构建镜像也可以直接用官方预构建镜像export OPENCLAW_IMAGEghcr.io/openclaw/openclaw:latest ./docker-setup.sh脚本会自动用 docker pull 拉镜像而不是本地构建。构建镜像时建议机器内存至少 4GB否则 pnpm install 容易被 OOM kill。六、使用官方一键脚本配置后来写的时候发现一键脚本更简单所以加上来。ssh连接服务器执行:curl -fsSL https://openclaw.ai/install.sh | bash根据官方的说法它会直接安装依赖和本体之后直接启动onboard配置。当然我测了确实是这样的。这里没图因为安装的时候忘记截图了等到它输出openclaw的logo和标题并且下面有一些选项的时候就说明onboard配置启动了。接下来教一下怎么配置:I understand this is powerful and inherently risky. Continue?| 选择 ●YesOnboarding mode| 选择 ●Quick StartModel/auth provider| 这里我选择 ●Z.AI因为智谱给了免费模型bushi虽然还是买了coding plan)继续完成剩余的 OpenClaw 功能配置。Select channel| 选择并配置需要的频道可以跳过。Configure skills| 选择并安装需要的功能。完成设置接下来选择hatch in tui就可以和上图一样开始配置龙虾了七、浏览器访问 Gateway 控制台并完成初始化1. 打开控制台脚本执行完后会提示你访问网关控制台默认地址http://服务器公网IP:18789。此时我猜你一定访问不了。因为openclaw的安全策略默认绑定了loopback即回环地址导致外网无法访问。此时你需要做的:安装opencode以ai制ai)执行命令:curl -fsSL https://opencode.ai/install | bash接着:source /root/.bashrc之后直接opencode就可以打开了。直接在聊天框里输入提示词:我在这台云服务器上安装了openclaw但是我无法在电脑上访问它的页面。检查一下配置看看是不是绑定loopback了如果是改成lan之后重启openclaw gateway。就这样enter以后要是有什么权限要求的通通选always allow和comfirm。以后你就发现你可以打开了。但是此时你点击连接一定会告诉你什么https什么的连不上。这个也是由于openclaw的安全策略不在同一台机子上的无法连接。这个时候你需要使用SSH端口映射在你的电脑上执行命令ssh -L 18789:127.0.0.1:18789 root服务器ip不出意外的话此时你在电脑上访问127.0.0.1:18789就可以正常填写令牌了2. 填写网关令牌脚本会在最后提示你生成的令牌例如Gateway token: xxxxxxxxxxxxxxxx在浏览器打开控制台后进入 Settings → Token把令牌粘贴进去保存刷新页面。如果看到“unauthorized”或“disconnected (1008): pairing required”说明令牌不对或需要重新配对可以在服务器上执行docker compose run --rm openclaw-cli dashboard --no-open docker compose run --rm openclaw-cli devices list按提示在浏览器中完成设备配对。八、模型供应商配置让 OpenClaw 真正“聪明”起来OpenClaw 本身只是一个“壳”真正的大脑来自你接入的模型供应商OpenAI、Anthropic、Ollama 等。官方文档已经给了比较清晰的配置方式。1. 最小配置示例在服务器上OpenClaw 的主配置文件在~/.openclaw/openclaw.json如果你是在 Docker 容器里跑这个文件会被挂载到宿主机同名路径。一个最小示例同时配置 OpenAI 和 Anthropic{ models: { providers: { openai: { apiKey: ${OPENAI_API_KEY} }, anthropic: { apiKey: ${ANTHROPIC_API_KEY} } } }, agents: { defaults: { model: { primary: openai/gpt-4.1-mini } } } }说明models.providers 下配置各个供应商的连接信息agents.defaults.model.primary 指定默认使用的模型格式为 provider/model例如openai/gpt-4.1-mini、anthropic/claude-sonnet-4-62. 通过环境变量注入密钥推荐做法是不要在配置文件里写死密钥而是用环境变量export OPENAI_API_KEY你的OpenAI密钥 export ANTHROPIC_API_KEY你的Anthropic密钥 //或者在 ~/.openclaw/.env 里写 OPENAI_API_KEY你的OpenAI密钥 ANTHROPIC_API_KEY你的Anthropic密钥OpenClaw 会按优先级读取环境变量进程真实环境变量 当前目录 .env ~/.openclaw/.env。3. 验证模型是否接入成功在服务器上执行docker compose run --rm openclaw-cli models status --check如果配置正确会看到类似[openai] gpt-4.1-mini: OK[anthropic] claude-sonnet-4-6: OK如果失败可以检查环境变量是否存在models.providers 是否写错agents.defaults.model.primary 的 provider/model 是否能匹配上。八、接入第一个聊天通道以 Telegram 为例OpenClaw 最吸引人的地方就是一个网关统一管理所有聊天通道。这里以 Telegram 为例快速演示如何接入。1. 创建 Telegram Bot在 Telegram 中搜索 BotFather发送 /newbot按提示创建一个 Bot记下返回的 Token例如123456:ABCDEF。2. 配置 OpenClaw 的 Telegram 通道编辑 ~/.openclaw/openclaw.json在 channels 下添加 Telegram 配置{ channels: { telegram: { botToken: ${TELEGRAM_BOT_TOKEN} } }, models: { providers: { openai: { apiKey: ${OPENAI_API_KEY} }, anthropic: { apiKey: ${ANTHROPIC_API_KEY} } } }, agents: { defaults: { model: { primary: anthropic/claude-sonnet-4-6 } } } }然后在环境变量或 .env 中设置TELEGRAM_BOT_TOKEN123456:ABCDEF重启网关如果你用的是 Docker 部署docker compose restart openclaw-gateway3. 在 Telegram 里测试在 Telegram 搜索你刚创建的 Bot发送 /start根据 OpenClaw 的安全策略第一次私聊需要“配对”Bot 会给你一个配对码在服务器上执行docker compose run --rm openclaw-cli pairing approve telegram 配对码配对成功后你就可以在 Telegram 里和这个 Bot 聊天它背后的模型就是你配置的 claude-sonnet-4-6。其他通道WhatsApp、Discord、Slack 等流程类似只是认证方式略有不同可以看官方 Channels 文档。九、安全和运维的一些小建议OpenClaw 能做的事情很多浏览器控制、Shell 命令、访问文件等所以安全上要稍微上心一点。DM 安全策略默认对陌生人的私聊会开启“配对模式”只有你批准的联系人才能和 Bot 交互不要随意设置 dmPolicyopen否则任何人都能直接和你的 Bot 聊。OpenClaw 更新节奏很快可以用openclaw update --channel stable 来切换到稳定频道并升级到最新版本。但是据我所知每次升级必宕机十、小结这一波“前沿”值得上车吗从几个维度看OpenClaw 都算得上 2026 年值得一试的项目成熟度已经有稳定发布版本Release 列表已经到 2026.3.13说明已经不是“玩具项目”了生态支持二十多种主流聊天通道配合多种模型供应商可以做很多自动化场景隐私本地网关 多通道统一接入特别适合不想把聊天记录都交给第三方平台的人。如果你想要一个“统一入口”管理多个 AI 模型想让 AI 真正帮你处理消息、邮件、日程而不是只聊天又不想把数据完全交给某个 SaaS那花一两个小时把 OpenClaw 跑起来是非常值得的。如果你已经按这篇教程把 OpenClaw 跑起来了欢迎在评论区说说你用它做了什么场景比如“自动整理 Telegram 群消息”、“结合飞书做值班机器人”、“给项目加一个 AI 运维助手”等等。有问题也可以直接贴报错日志一起排查。