企业官网建设流程全解析

1. 为什么要在阿里云上跑 Hermes/OpenClaw，以及 token Plan 到底解决什么问题

Hermes 和 OpenClaw 是 2026 年开源社区里讨论度很高的本地优先 AI 助理框架，OpenClaw 的前身就是 Clawdbot/Moltbot。它能做的事和普通聊天机器人不太一样：除了自然语言对话，还能执行文件处理、日程管理、邮件整理、多平台自动化操作，兼容 Qwen、GPT、Claude 等多款模型，定位更接近一个能落地的“数字员工”。适合谁？个人办公、轻量团队协作、需要 7×24 小时在线响应的场景都合适。

但真正部署过的人会知道，框架本身跑起来不难，难的是模型通道怎么接、Key 怎么统一管理、多个模型供应商怎么切换。token Plan 就是在这个环节出现的：它把按 token 计费的零散调用，整理成一套可规划、可复用的接入方案，配合统一 Key 接入，你不需要在 config.toml 里为每个模型单独维护一套凭证。我试过在阿里云 ECS 上从零走一遍完整流程，下面把可复制的配置和验证命令都拆开讲，目标是在 30 分钟内完成部署并确认 API 通道可用。

阿里云 ECS 的优势在于公网访问稳定、安全组可控、系统镜像选择多，推荐 Alibaba Cloud Linux 3.2104 LTS 或 Ubuntu 22.04 LTS 64 位。内存硬性要求 ≥2GiB，低于这个数服务会直接启动失败；存储优先 ESSD，减少读写卡顿。下面所有操作都基于一台 2vCPU+4GiB 内存的 ECS 实例展开，你可以按需升配。

2. TaoToken 前置准备：统一 Key 与 token Plan 的关系

在写 config.toml 之前，先把凭证这条线理清楚。TaoToken 在这里扮演的是统一接入层：你拿到一个 Key，就能在 Hermes/OpenClaw 里调用多个模型，不用为每个供应商单独配置。token Plan 则是配套的用量规划方式，适合长期编码、Agent 常驻运行的场景，避免按 token 零散计费带来的成本不可控。

你需要提前准备两样东西：

第一，TaoToken 的 API Key。访问 API Keys 管理页面生成，格式通常是 sk- 开头的一长串字符，只显示一次，复制后存到安全的地方。生成入口：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite

第二，确认你要用的模型通道。如果你主要做长期编码或 Agent 任务，建议先了解 Coding Plan 的覆盖范围：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite

注意：API Key 不要直接写进会提交到 Git 的配置文件里，用环境变量注入，后面会给完整做法。

统一 Key 接入的核心思路是：Hermes/OpenClaw 的 config.toml 里只声明一个 provider，base_url 指向 TaoToken 的 API 地址，api_key 从环境变量读取。这样你换模型时只改 model 字段，不用动凭证。API 基础地址是 https://taotoken.net/api，注意这个地址不带任何查询参数。

3. 可复制的 config.toml 骨架与环境变量清单

先给环境变量清单，这是整个部署里最容易被忽略、也最容易出错的一环。在 ECS 上编辑~/.bashrc或/etc/profile.d/taotoken.sh，写入：

export TAOTOKEN_API_KEY="sk-你的实际Key" export TAOTOKEN_BASE_URL="https://taotoken.net/api" export OPENCLAW_HOME="$HOME/.openclaw" export OPENCLAW_LOG_LEVEL="info"

写完执行source ~/.bashrc让变量生效，然后用echo $TAOTOKEN_API_KEY确认能打印出来。这一步不做，后面 config.toml 里引用环境变量会拿到空值，服务启动时报“api key invalid”，排查起来很费时间。

接下来是 config.toml 骨架。Hermes 和 OpenClaw 的配置结构高度相似，下面这份可以直接复制，路径放在~/.openclaw/config.toml：

[gateway] host = "0.0.0.0" port = 18789 log_level = "info" [models] default_provider = "taotoken" default_model = "claude-sonnet" [models.providers.taotoken] base_url = "https://taotoken.net/api" api_key = "${TAOTOKEN_API_KEY}" timeout = 60 max_retries = 3 [models.providers.taotoken.models] claude-sonnet = "claude-sonnet-4" gpt-class = "gpt-4o" qwen-class = "qwen-max" [skills] auto_install = false registry = "clawhub" [security] require_token = true token_ttl = 86400

几个关键点解释一下。base_url用${TAOTOKEN_API_KEY}这种引用方式，OpenClaw 启动时会从环境变量读取，避免明文写 Key。default_model先设成 claude-sonnet，验证通了再换。require_token = true表示 Web 控制台需要访问 Token，生产环境别关。

如果你用的是 Hermes，配置文件名可能是hermes.toml，字段名基本一致，把[gateway]换成[server]即可，端口保持 18789 方便统一放行。

环境变量和配置文件都就位后，执行一次语法检查：

openclaw config validate --file ~/.openclaw/config.toml

输出config is valid说明结构没问题。如果报字段未知，检查你的版本是否支持max_retries，老版本可以删掉这一行。

4. 启动服务与连通性验证：确认 API 通道真的可用

配置写完不等于通道通了。先启动服务：

openclaw gateway --config ~/.openclaw/config.toml

前台启动能看到实时日志，正常会输出gateway listening on 0.0.0.0:18789和provider taotoken initialized。如果卡在 provider 初始化，多半是 Key 或 base_url 有问题。

新开一个终端做连通性验证。第一步，确认本地端口在听：

curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:18789/health

返回 200 说明网关活着。第二步，直接验证 TaoToken 通道：

curl -s https://taotoken.net/api/v1/models \ -H "Authorization: Bearer $TAOTOKEN_API_KEY" \ | head -c 500

能返回模型列表 JSON，说明 Key 和网络都通。第三步，走 OpenClaw 自己的模型调用链路：

openclaw model test --provider taotoken --model claude-sonnet \ --prompt "回复：通道正常"

预期输出类似response: 通道正常，并附带 latency 和 token 用量。这三步都过，基本可以确认 API 通道可用。

如果你更想先在图形界面里确认模型行为，可以打开模型对话页面直接发一条消息对比：https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite

阿里云 ECS 上还需要放行 18789 端口。进入实例安全组，添加入方向规则，协议 TCP，端口 18789，源地址按需填你的办公 IP 或 0.0.0.0/0（测试用，生产建议收紧）。放行后用公网 IP 访问http://你的公网IP:18789，输入 Token 即可进入控制台。

5. 本篇常见错排查：从报错反推配置问题

部署过程中最容易撞上的几类错误，我按现象、原因、解决顺序列出来。

报错一：api key invalid或401 unauthorized。先确认环境变量在当前 shell 里真的存在，echo $TAOTOKEN_API_KEY打印为空就是没 source。再确认 config.toml 里写的是${TAOTOKEN_API_KEY}而不是字面量。最后检查 Key 是否复制完整，前后有没有多余空格。

报错二：connection refused或timeout。分两种。访问本地 18789 被拒，说明服务没起来或端口没放行；访问 taotoken.net/api 超时，检查 ECS 出方向安全组是否限制了 443，以及 DNS 是否正常，curl -v https://taotoken.net/api/v1/models能看到握手细节。

报错三：model not found。config.toml 里default_model写的名字必须在[models.providers.taotoken.models]段里定义过。名字对不上就会报这个。改完记得重启 gateway。

报错四：config parse error at line X。TOML 对缩进和引号敏感。常见是字符串没加引号、或者用了中文引号。用openclaw config validate定位行号，逐行核对。

报错五：服务启动后立刻退出，日志只有一行。多半是内存不足。free -h看一下，低于 2GiB 可用内存就升配。另一个可能是 18789 被占用，ss -tlnp | grep 18789找到进程处理掉。

报错六：Web 控制台提示 Token 无效。Token 有 TTL，默认 86400 秒。重新生成：openclaw token generate，把新 Token 填进登录框。如果还是不行，确认require_token和实际登录方式一致。

排障时如果怀疑是 Key 或通道本身的问题，可以直接在 API Keys 页面重新生成一个做对照测试：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite

接入层面的细节，比如 base_url 拼接规则、鉴权头格式，文档里有完整说明：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite

6. 长期运行与 Coding Plan 的衔接

服务跑起来只是开始。如果你打算让 Hermes/OpenClaw 常驻做编码辅助或 Agent 任务，建议把开机自启配上：

sudo systemctl enable openclaw-gateway sudo systemctl is-enabled openclaw-gateway

输出enabled即成功。日志用openclaw logs --follow跟，排查问题时比翻 journalctl 直观。

长期编码场景下，token Plan 和 Coding Plan 的搭配能明显降低单位成本。Coding Plan 的入口在这里，可以先看覆盖的模型和额度规则：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite

如果你更习惯在编辑器里直接接 Claude Code 这类工具，Anthropic 兼容通道的配置方式也有单独说明：https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claude_code_anthropic&utm_campaign=rewrite

控制台里可以随时查看用量和 Key 状态：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite

最后给一个实用习惯：把 config.toml 和环境变量脚本分开管理，config.toml 可以进版本库，环境变量脚本只放服务器本地并设 600 权限。这样既方便回滚配置，又不会泄露 Key。部署完成后先跑一遍第 4 节的三条验证命令，确认通道可用再接入实际任务，能省掉大量“以为是框架问题、其实是 Key 没生效”的排查时间。