企业官网建设流程全解析

1. 迁移清单走到最后一步，卡在「测试 AI 对话是否正常」

把 OpenClaw 从旧电脑搬到新电脑，大多数时候并不难：程序本体用 npm 重装一遍，记忆仓库用 git clone 拉下来，真正让人头疼的是配置文件~/.openclaw/config.yaml里的 API Key。迁移清单最后一步是「测试 AI 对话是否正常」，这一步通常要复制旧电脑的 Key 才能跑通；如果旧 Key 没备份、已经过期，或者换电脑前忘了是哪把 Key 在生效，对话请求就直接被模型服务拒掉。这时候与其翻旧电脑翻聊天记录，不如直接换一把 TaoToken Key，到官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 创建之后填进配置，把最后一步走完。

1.1 OpenClaw 的数据三分法和 Key 的位置

OpenClaw 的数据大体分三块：程序本体是 npm 全局包，跟机器绑定，重装即可；配置在~/.openclaw/config.yaml，里面记录了 API Key、模型 provider、渠道信息；工作空间在~/.openclaw/workspace/，记忆、脚本、文档都在这里，通常是一个 Git 仓库。前两块搬起来都直接，真正容易出变量的是 config.yaml 中的 Key：它不长在 workspace 里，不在 git 历史内，也不会跟着记忆仓库一起同步。旧电脑的 Key 一旦丢失，新电脑的 config.yaml 里就是一把失效的凭证。

这也解释了为什么迁移清单最后一步会卡住。workspace 克隆下来，openclaw --version能正常输出，看起来一切都好；但真正向模型服务发请求时，鉴权失败，AI 对话就是不通。不是 OpenClaw 装错了，而是 config.yaml 里的 Key 没能通过服务商的校验。

1.2 旧 Key 失效时的快速判断方法

不用等到对话超时才去猜，启动服务后看一眼日志就能判断。执行openclaw gateway logs，如果输出里出现401、authentication、invalid x-api-key之类的内容，基本可以确定是 Key 的问题，而不是网络或安装问题。另一种情况是 Key 本身没失效，但旧电脑配置里填的是某个环境变量的引用，例如apiKey: ${ANTHROPIC_API_KEY}，换到新电脑后这个环境变量没有同步过去，OpenClaw 拿到的是空字符串。这两种情况处理方式一样：直接把 config.yaml 里的 Key 换成 TaoToken 新创建的 Key，让整条请求链路走 TaoToken 的兼容通道。

2. 新电脑先装好 Node.js 18+ 与 OpenClaw 本体

在动 config.yaml 之前，先把运行环境补齐。原文的前置要求是 Node.js 18+，实际操作建议直接装 Node.js 22 LTS，避免版本太老导致 OpenClaw 依赖安装失败。装好 Node.js 后，全局安装 OpenClaw 并验证版本号，这一步相当于把程序本体从旧电脑迁移到新电脑。

2.1 安装 Node.js 22 与 openclaw 全局命令

Ubuntu/Debian 系可以用 nvm 安装，避免和系统自带的 Node 冲突：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash source ~/.bashrc nvm install 22 nvm use 22 node -v

接着安装 OpenClaw：

npm install -g openclaw openclaw --version

如果openclaw命令找不到，检查 npm 全局 bin 目录是否在 PATH 里，常见路径是~/.nvm/versions/node/v22.x.x/bin。这一步通过后，程序本体迁移完成，接下来处理记忆仓库和配置文件。

2.2 克隆记忆仓库时，别把密钥带回 workspace

OpenClaw 的工作空间建议用 Git 管理，新电脑上执行：

mkdir -p ~/.openclaw cd ~/.openclaw git clone <你的 workspace 仓库地址> workspace

如果你的仓库是私有的，需要先配置 SSH 密钥并添加到 Git 平台。这里有一个容易踩的坑：有些人习惯把旧电脑的 config.yaml 直接复制到 workspace 里当备份，结果连同 API Key 一起提交进了 Git 仓库。Key 一旦进了 git 历史，即使后面删除，也在远程仓库里留底了。所以在 clone 完 workspace 之后，第一时间确认~/.openclaw/workspace/下没有 config.yaml 副本，配置文件只放在~/.openclaw/config.yaml这个固定位置，并且不要纳入版本控制。

3. 在 config.yaml 里用 TaoToken 换掉旧 API Key

程序装好、记忆仓库拉下来之后，重头戏落在配置文件。原文给了两个恢复配置的方式：手动复制旧文件，或者openclaw init从模板创建。手动复制旧文件的前提是旧电脑还能开机、旧文件还在；如果都满足，你确实可以把整个 config.yaml 带过来。但问题在于：带过来的 Key 很可能已经过期，或者绑定的服务额度已经用尽。与其复制一把随时可能失效的旧 Key，不如在迁移的最后一步直接换成 TaoToken 的 Key，一次性解决「旧 Key 没备份」「旧 Key 绑定在旧设备」「旧 Key 额度不够」三类问题。

3.1 到 TaoToken 官网创建 API Key

打开 TaoToken 注册登录，进入控制台创建 API Key。创建时把 Key 复制下来，只显示一次，后续在控制台看不到完整明文。这个 Key 就是我们用来替换旧 config.yaml 里apiKey字段的凭证。

注意区分两个地址：官网落地页 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 用于注册、创建 Key、看模型广场、看用量；而真正要填进 OpenClaw 配置的接口地址是 https://taotoken.net/api ，末尾不要加/v1。前者是给人操作的网页，后者是程序发请求的接口通道，两者不要混用。

3.2 models 段与 providers 段的填写方式

打开~/.openclaw/config.yaml，把模型 provider 的相关字段改成下面这样：

# ~/.openclaw/config.yaml version: "1" models: default: "anthropic/YOUR_MODEL_ID" # 以 TaoToken 模型广场上的 ID 为准 providers: anthropic: apiKey: "YOUR_API_KEY"

YOUR_API_KEY替换成刚刚从官网创建的 TaoToken Key。anthropic/YOUR_MODEL_ID这一项不要照抄，去 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 的模型广场看当前可用的模型 ID，选一个以anthropic/开头的模型填进去。不同时间模型列表会调整，以你打开模型广场时看到的实际列表为准。

provider 名字保持anthropic不变，因为 OpenClaw 内部用 provider 名决定走哪套 SDK 协议。default字段填的是「provider 名 + 模型 ID」的组合格式，如果你选的模型 ID 是某个非 anthropic 系列的模型，需要同步修改 provider 名和 default 前缀，具体以模型广场上给出的完整标识为准。

3.3 环境变量兜底：ANTHROPIC_BASE_URL 指向 TaoToken

config.yaml 只解决了「用什么 Key」的问题，还差「把请求发到哪里」。OpenClaw 底层走的是 Anthropic 兼容协议，默认请求地址是 Anthropic 官方服务器。要让它把请求发到 TaoToken 的通道，需要在启动 Gateway 前设置环境变量：

export ANTHROPIC_BASE_URL=https://taotoken.net/api export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY

把这两行追加到~/.bashrc（或你使用的 shell 配置文件）末尾，然后source ~/.bashrc。ANTHROPIC_BASE_URL填 https://taotoken.net/api ，不要带/v1后缀，OpenClaw 会在请求时自动拼接对应的 API 路径；如果这里多写了/v1，部分版本会把路径拼成/v1/v1/...，直接导致 404。

这里解释一下为什么需要环境变量：config.yaml 里的apiKey由 OpenClaw 读取并传给底层 SDK；ANTHROPIC_BASE_URL让底层 SDK 知道请求目标地址指向 TaoToken。两个配置合在一起，鉴权和转发就都走 TaoToken 了。如果你的 OpenClaw 版本较新、在 provider 配置里直接支持baseURL字段，也可以直接在 config.yaml 中填写，但环境变量方式兼容性更好，新老版本都能生效。

4. 启动 gateway，做一次真实对话验证

配置改完之后，进入最后一步：启动 OpenClaw Gateway，并验证 AI 对话是否正常。原文的迁移清单在这里是「启动服务：openclaw gateway start」，然后「测试 AI 对话是否正常」。这两步合并起来，就是本轮迁移的验收动作。

4.1 openclaw gateway start 与日志确认

在修改后的环境变量生效前提下，启动服务：

openclaw gateway start openclaw gateway status openclaw gateway logs

gateway status能看到进程是否在运行；gateway logs用来观察请求时的实时日志。启动过程如果报错，先看是否缺少环境变量或 Node 版本不满足。新电脑上常见的启动失败原因有两类：一是~/.openclaw/workspace没有正常 clone 导致工作空间缺失；二是 config.yaml 的 YAML 格式写错，比如 Key 或模型 ID 没有加引号，导致解析异常。YAML 对缩进敏感，providers和apiKey的缩进层级必须和示例一致。

4.2 发一条测试消息，确认记忆链还在

Gateway 起来后，向你的 OpenClaw 发一条测试消息。如果你的 OpenClaw 接入了钉钉、Telegram 等渠道，直接在客户端发一句「我换电脑了，你还记得我之前让你记过什么吗」；如果没有接渠道，可以通过 OpenClaw 自带的交互方式触发一次对话，或者从 workspace 里挑一个带行为规范的任务，比如让 AI 根据memory/下的每日记忆总结最近动向。

这一步的关键是看模型是否正常返回，而不是只看消息有没有送达。如果模型返回内容正常，说明三个环节全部走通：config.yaml 里的 Key 有效、models.default里的模型 ID 在 TaoToken 模型广场真实存在、ANTHROPIC_BASE_URL指向的地址能正确转发请求。如果返回内容为空或直接报错，优先回头检查模型 ID 是否多写了空格、模型名是否复制完整。建议先在 TaoToken 模型对话 里用同一把 Key 发一条消息，因为页面上的对话功能能直接暴露模型 ID 和 Key 是否匹配，方便和 OpenClaw 的报错做对照。

4.3 回到 TaoToken 控制台看这次请求是否记账

对话测试通过后，回到 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 的控制台查看用量记录。如果刚才的测试请求被正确记录，说明整条链路已经真实跑通，而不是 OpenClaw 走了某个本地缓存或离线降级。这一步也是对「旧 Key 失效」问题的最终确认：新 Key 在控制台能看到请求明细，旧 Key 看不到，一次对比就能判断迁移是否真正完成。

有些开发者会把ANTHROPIC_BASE_URL配好后不重启 shell，直接在当前终端运行openclaw gateway start，结果环境变量没生效。记得先source ~/.bashrc或重开终端，再启动 Gateway。日志里如果出现connect ECONNREFUSED，多半是网络层问题，检查新电脑的防火墙或代理设置；如果出现401，检查 Key 是否复制完整，YAML 里的引号是否把 Key 截断了；如果出现404，检查 Base URL 是不是多写了/v1，参考 3.3 节。

5. 连带检查：本地模型与钉钉入口要不要一起迁

原文还包含了两个可选迁移项：本地模型（llama.cpp）和钉钉机器人渠道。这两项不影响「用 TaoToken Key 验证 AI 对话」这个核心目标，但换新电脑后值得顺带确认一下，避免下次用到时才发现没迁全。

5.1 本地 llama-server 只影响离线模型

如果你的 config.yaml 里models.default用的是 TaoToken 上的云端模型，本地 llama-server 完全可以先不迁，对话测试不依赖它。只有当你想在断网环境或数据敏感场景下切到本地模型时，才需要在新电脑上重新编译 llama.cpp、下载 GGUF 模型文件，并把 workspace 里的llama-server.sh软链接重建一遍。迁移时工作量最大的是模型文件本身，建议直接用移动硬盘复制，比重新下载快得多。

5.2 钉钉渠道配置属于消息入口，不影响对话连通

钉钉机器人配置写在 config.yaml 的channels段，迁移到新电脑后需要重新确认appKey和appSecret，并且如果使用了企业内部应用回调，还要保证新机器的公网地址能被钉钉开放平台访问到。但注意，钉钉渠道只是消息入口，它决定你能不能通过钉钉群触发 OpenClaw；即使钉钉入口暂时没配好，只要模型 provider 走的是 TaoToken，AI 对话本身依然是通的。排障时可以分开看：消息发不进去查渠道配置，消息发出去了但 AI 不回复查模型配置。两边互不干扰，不要混在一起来回试。

6. 迁移测试后的常见问题与排查

完成一次真实对话验证后，把几个高频问题列出来。这些问题不是配置文档里的通用套话，而是换新电脑、换新 Key 时最容易撞上的实际情况。

6.1 旧 Key 没备份，也不记得绑过哪个账号

不用费劲找回旧 Key。旧 Key 如果已经过期，找回来也没用；如果只是不记得存在哪台机器上，直接登录 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 创建一把新 Key，替换 config.yaml 里的apiKey和环境变量里的ANTHROPIC_AUTH_TOKEN即可。TaoToken 的 Key 创建后立即生效，不需要等待审核或绑定 IP，新电脑上配完就能用。建议把同一个 Key 同时用于 config.yaml 和环境变量，避免两处 KEY 不一致导致「config 里是 A Key、环境变量里是 B Key」的鉴权错乱。

6.2 测试时 401 Unauthorized 或 404 Not Found

这两个报错指向不同问题，不要混着排查。401 Unauthorized表示请求到达了服务端但在鉴权环节被拦下，通常是 Key 复制不完整、Key 带上了 YAML 引号、或环境变量里的ANTHROPIC_AUTH_TOKEN和 config.yaml 里的apiKey不一致。404 Not Found表示请求地址或模型路径不对，大概率是 Base URL 写成了https://taotoken.net/api/v1，导致 SDK 在拼接时得到重复的/v1路径；把 Base URL 改回 https://taotoken.net/api 后重启 Gateway 再试。

6.3 多台电脑同时跑 OpenClaw 的注意点

原文提到只能有一台电脑运行 OpenClaw Gateway，避免消息重复。换到新电脑并测试通过后，记得把旧电脑上的 Gateway 进程停掉，或者至少别让两台机器共享同一个 workspace 同时跑任务。workspace 通过 Git 同步时，如果两台机器同时写入memory/目录，会产生冲突；建议新电脑跑日常任务，旧电脑只作为备份或临时查询使用，不要两边同时响应消息。Key 本身可以在多台机器上重复使用，额度在看用量的控制台统一管理，不用每台机器单独申请。

迁移验证到这里就完整了：从新电脑安装 OpenClaw，到 clone 记忆仓库，再到用 TaoToken Key 替换旧 Key、把 Base URL 指到 https://taotoken.net/api，最后启动 Gateway 发一条真实对话并确认控制台有对应记录。配置过程中如果还需要临时在网页里确认模型返回，直接打开 TaoToken 模型对话；想给日常编码任务规划额度，可以看 Coding Plan；后续要管理多把 Key 或轮换密钥，在 控制台 API Keys 里操作；如果你同时也在用 Claude Code 这类命令行工具，可以对照 Claude Code 接入文档 把环境变量同步过去，省得切换工具时再踩一遍配置坑。