1. 为什么要在宝塔面板里部署 OpenClawOpenClaw 这个项目从 Clawbot、Moltbot 一路改名到现在的 OpenClaw热度一直没降下来。它本质上是一个可自托管的 AI 助手框架你给它一个大模型 API 通道再挂上微信、飞书、钉钉这类 IM 工具它就能在聊天窗口里替你干活——查资料、写脚本、整理文档、跑定时任务。适合谁适合手里有一台闲置服务器、想拥有一个完全归自己控制的 AI 助手的个人开发者而不是只想点开网页随便聊两句的人。问题也很现实官方文档给的是命令行部署路径对不熟悉 Linux 的人门槛偏高而各种云端一键镜像虽然省事但配置项被锁死想换模型通道、想改 IM 接入方式都很别扭。宝塔面板刚好卡在中间——它把 Nginx、进程守护、文件管理、日志查看这些操作图形化了同时你又保留了完整的配置文件控制权。这篇就给你两种在宝塔环境下落地的方案二选一即可方案 A 走「宝塔应用商店 面板配置」适合想少敲命令的人方案 B 走「宝塔 手动拉取 systemd 守护」适合想要更高可控性、方便后续升级的人。两种方案最后都接入 TaoToken 的统一 Key/API 通道这样你只维护一个 Key就能在 OpenClaw 里切换不同模型。2. 前置准备服务器、宝塔与 TaoToken 通道先说服务器。我实测下来 2G 内存能跑起来但编译依赖和同时挂 IM 长连接时会非常吃力建议直接上 4G 内存的轻量服务器系统选 Debian 12/13 或 Ubuntu 22/24这两个版本在宝塔下的兼容性最稳。装宝塔面板本身很简单登录服务器后按官方脚本执行安装装完在浏览器打开面板地址绑定账号即可。这一步不展开重点在后面。然后是 TaoToken。它的作用是给你一个统一的 API 入口你不用在 OpenClaw 里分别填各家模型的地址和 Key而是把 TaoToken 的地址和 Key 填进去由它来转发到具体模型。对 OpenClaw 这种需要频繁切换模型的场景特别合适——今天想用这个模型写代码明天想换那个模型做总结只改一个 model 字段就行不用动 Key。你需要准备两样东西一个 API Key在控制台的 API Keys 页面创建复制出来保存好后面 config.toml 和 settings.json 都要用。接入地址https://taotoken.net/api注意这个地址不带任何查询参数直接作为 base_url 使用。注意Key 只在创建时完整显示一次建议创建后立刻存进密码管理器。如果泄露了直接在控制台吊销重建不要试图「改一改继续用」。如果你还没决定用哪个模型可以先去模型对话页面试几个确认响应风格和速度符合预期再回到部署环节。长期跑编码类任务的话Coding Plan 的额度模型会比按量计费更划算这个后面 CTA 部分再说。3. 方案 A宝塔应用商店一键装 面板配置这条路线适合不想碰命令行的人。宝塔的应用商店里能搜到 OpenClaw 相关的部署项不同版本商店条目名称可能略有差异认准 OpenClaw 字样即可。点击安装后面板会自动拉取依赖、创建运行目录、注册守护进程。安装完成后进入 OpenClaw 的配置界面。这里要填的核心就是模型通道。把 TaoToken 的地址和 Key 填进对应字段模型名按你实际要用的填。面板里通常还会有 IM 接入区微信、飞书、钉钉、QQ 都在这里绑定扫码或填 Webhook 即可。但面板配置有个坑它生成的配置文件字段名可能和官方文档不完全一致尤其是嵌套层级。所以装完之后建议你进文件管理找到 OpenClaw 的配置目录核对一下config.toml。下面这份骨架可以直接对照修改# /www/server/openclaw/config.toml [server] host 0.0.0.0 port 8080 [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model 你的模型名 timeout 120 [im.feishu] enabled true app_id cli_xxxxxxxx app_secret xxxxxxxx [im.wechat] enabled false改完保存回到面板点重启服务。方案 A 的优势就是快从装到能对话大概十几分钟代价是升级时面板可能覆盖你的自定义配置所以每次升级前先备份这个文件。4. 方案 B宝塔 手动部署 systemd 守护如果你想要完全的控制权走这条。先在宝塔里装好 Nginx 和 Python 环境OpenClaw 依赖 Python 运行时然后用面板的终端或 SSH 进服务器操作。第一步拉取代码到固定目录mkdir -p /opt/openclaw cd /opt/openclaw git clone https://github.com/openclaw/openclaw.git . python3 -m venv venv source venv/bin/activate pip install -r requirements.txt第二步写配置文件。这条路线下配置文件由你自己完全掌控推荐用settings.json管理运行时参数config.toml管理模型与 IM{ runtime: { log_level: info, data_dir: /opt/openclaw/data, max_workers: 4 }, model: { base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: 你的模型名, stream: true }, im: { feishu: { enabled: true }, wechat: { enabled: false } } }第三步注册 systemd 服务让它开机自启、崩溃自拉# /etc/systemd/system/openclaw.service [Unit] DescriptionOpenClaw AI Assistant Afternetwork.target [Service] Typesimple WorkingDirectory/opt/openclaw ExecStart/opt/openclaw/venv/bin/python main.py Restartalways RestartSec5 EnvironmentPYTHONUNBUFFERED1 [Install] WantedBymulti-user.target然后启用systemctl daemon-reload systemctl enable --now openclaw systemctl status openclaw方案 B 的好处是升级时git pull一下、重启服务就行配置不会被覆盖坏处是依赖冲突要自己处理比如 Python 版本不对导致 pip 装包失败。我踩过的坑是 venv 建在了系统 Python 上后来换成显式指定 python3.11 才稳定。5. 验证请求确认助手真的通了部署完别急着接 IM先用最直接的方式验证模型通道是否打通。在服务器上执行curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: 你的模型名, messages: [{role: user, content: 用一句话说明你已就绪}] }如果返回里能看到正常的choices结构和模型回复内容说明 Key、地址、模型名三者都对上了。这一步失败的话先别去折腾 OpenClaw问题一定在通道层。通道通了之后再看 OpenClaw 自身的健康状态curl http://127.0.0.1:8080/health journalctl -u openclaw -n 50 --no-pager健康检查返回 200日志里没有反复重连或鉴权失败就说明服务本身没问题。最后在飞书或微信里给助手发一条消息比如「帮我列一个本周待办模板」能收到结构化回复整条链路就算跑通了。验证项命令/动作期望结果模型通道curl 调 /v1/chat/completions返回 choices 内容服务存活curl /healthHTTP 200进程状态systemctl status openclawactive (running)IM 链路聊天窗口发消息收到助手回复6. 本篇常见报错排查报错一401 Unauthorized。九成是 Key 填错或带了多余空格。检查 config.toml 里api_key是否完整注意别把Bearer前缀也写进去代码里通常会自动加。报错二Connection refused 到 127.0.0.1:8080。服务没起来。先看systemctl status如果是方案 A去面板看进程是否被 OOM 杀掉——2G 内存机器上很常见加 swap 或升配。报错三模型名不存在。TaoToken 是统一通道模型名必须和它支持的名称一致。去模型对话页面确认可用模型列表别照抄别处的名字。报错四IM 收不到回复但日志显示已发送。多半是 Webhook 回调地址填的是内网 IP外部平台访问不到。宝塔里配好域名和反向代理把回调地址改成公网可访问的 HTTPS 地址。报错五pip 安装依赖时报版本冲突。方案 B 常见。确认 venv 用的是 Python 3.10 以上必要时删掉 venv 重建别在系统环境里硬装。排查顺序建议固定为先验通道curl再验服务health最后验 IM。这样能避免在多层之间来回猜。7. 接下来怎么走两种方案选哪个取决于你后面想不想频繁改配置。想省事、能接受升级时重新核对配置选方案 A想长期维护、方便接更多 IM 和自定义逻辑选方案 B。无论哪条TaoToken 那一段配置都是共用的换方案不用换 Key。部署完成后建议先把 API Keys 页面收藏好后续加模型、吊销旧 Key 都在那里操作接入过程中遇到字段对不上直接翻接入文档里面有各语言的完整示例。想先确认某个模型的实际表现再决定要不要长期用去模型对话页面直接试最省时间。如果你打算让这个助手长期跑编码和 Agent 类任务按量计费可能不如 Coding Plan 划算可以去了解下额度规则再决定。