企业官网建设流程全解析

18789 端口不通？OpenClaw 的 Base URL 该填 TaoToken 的哪个接口地址

很多人在云服务器上按教程部署 OpenClaw，防火墙里 22、18789、8080 三个端口都放行了，npx openclaw init也跑完了，Web 控制台里模型凭证也填了，结果核心通信还是不通，或者直接甩一个 401 出来。折腾半天以为是端口没开对，其实问题往往出在两个地方：一个是服务本身的bind_ip没配对，另一个是模型通道的 Base URL 填错了。

这篇文章就专门解决这个排障场景。如果你正在用 OpenClaw 做 AI Agent 部署，卡在 18789 核心通信或者模型请求 401 上，可以顺着下面的顺序一步步排查。模型通道和 Key 的来源，建议直接从 TaoToken 拿，官网地址是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end ，注册后在控制台创建 Key 即可，Base URL 统一填https://taotoken.net/api，不要带/v1，也不要把官网首页地址当成接口地址填进去。

一、先搞清楚 18789 和 8080 各自管什么

OpenClaw 的架构是“核心引擎 + 技能插件”，它启动之后并不是只开一个端口。默认情况下：

• 8080：Web 控制台端口，你浏览器访问http://公网IP:8080看到图形界面的那个。
• 18789：核心通信端口，核心引擎和技能插件之间、以及部分内部调度走的通道。

很多人只记得放行 8080，忘了 18789，结果 Web 控制台能打开，但一执行任务就卡住或者报通信失败。所以第一步永远是先确认这两个端口在云服务器安全组和系统防火墙里都放行了。

在 Linux 上可以用ss -tlnp | grep -E '18789|8080'看服务到底有没有监听这两个端口。如果 18789 压根没出现，那说明服务没起来或者绑定地址不对，跟防火墙无关。

二、bind_ip 配错，端口放行也没用

OpenClaw 的配置文件一般是config.yaml。里面有一个bind_ip字段，决定了服务监听在哪个地址上。

• 本地测试：bind_ip: 127.0.0.1，只有本机能访问。
• 云服务器：如果你要从公网访问 Web 控制台，bind_ip需要是0.0.0.0，或者至少绑定到内网/公网对应网卡地址。

常见坑是：教程里写的是本地部署的127.0.0.1，你直接复制到云服务器上，结果安全组放行了 18789，但服务只监听在回环地址上，外部怎么连都不通。这时候ss -tlnp会显示127.0.0.1:18789而不是0.0.0.0:18789，一眼就能看出来。

改完bind_ip之后记得重启服务：npx openclaw restart，然后再确认监听地址变了没有。

三、模型通道的 Base URL 到底填哪个

端口和绑定都排查完，如果 Web 控制台里配完模型凭证还是 401，那基本就是模型通道的地址填错了。

OpenClaw 在初始化或者 Web 控制台的模型配置里，会让你填 API Key 和 Base URL。这里有两个高频错误：

1. 把官网地址当 Base URL：比如填了https://taotoken.net这种首页地址。首页是给人看的，不是给程序发请求的，程序请求会打到错误的路径上，自然 401 或者 404。
2. 多带了/v1：有些平台的接口习惯是https://xxx.com/v1，但 TaoToken 的接口地址就是https://taotoken.net/api，不需要再拼/v1。多写一段路径，请求就落到不存在的路由上。

正确的填法是：

• Base URL：https://taotoken.net/api
• API Key：在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册后，进入控制台创建，形如YOUR_API_KEY的那串。

拿到 Key 之后，OpenClaw 的核心引擎在调用模型时就会走这个通道。你可以先在模型对话页面验证一下 Key 是否可用，确认通道没问题，再回到 OpenClaw 里配。

四、可复制的配置与验证步骤

下面按顺序走一遍，适合直接照着做。

第一步：确认端口监听

ss -tlnp | grep -E '18789|8080'

期望看到0.0.0.0:18789和0.0.0.0:8080（云服务器场景）。如果看到127.0.0.1，去改config.yaml的bind_ip。

第二步：确认防火墙和云安全组

系统层面：

# Ubuntu 示例 sudo ufw status sudo ufw allow 18789/tcp sudo ufw allow 8080/tcp

云服务器控制台的安全组里，同样要放行 22、18789、8080 三个端口的入方向。

第三步：配置模型通道

在 OpenClaw 的模型配置里填：

Base URL: https://taotoken.net/api API Key: YOUR_API_KEY

注意 Base URL 结尾不要带/v1，也不要填官网首页。

第四步：验证模型请求

配好之后，在 Web 控制台里发一条最简单的测试指令，比如让它读取当前目录下的一个文件。如果模型能正常返回，说明通道通了。如果还是 401，回到 TaoToken 控制台确认 Key 是否启用、是否有余额或权限。

第五步：重启并观察日志

npx openclaw restart

然后看日志里模型请求的返回状态码。200 就是通了，401 是 Key 或地址问题，连接超时则回到端口和网络层面继续查。

五、本篇常见错排查清单

把上面几类问题整理成一张排查表，遇到报错可以对照：

• 18789 不通，8080 正常：先看ss -tlnp里 18789 有没有监听；没监听就是服务或bind_ip问题，监听了但外部连不上就是安全组/防火墙问题。
• Web 控制台能开，任务执行报通信失败：大概率是 18789 没放行，或者bind_ip绑在了127.0.0.1。
• 模型请求 401：先确认 Base URL 是不是https://taotoken.net/api，有没有误填官网首页或多加/v1；再确认 Key 是否从 TaoToken 控制台正确创建并复制完整。
• 模型请求 404：通常是 Base URL 路径拼错，检查有没有多余的斜杠或路径段。
• 初始化时填了 Key 但没生效：部分版本需要重启服务后配置才加载，npx openclaw restart一下再试。
• 云服务器本地 curl 通、外部不通：安全组没放行，或者服务只绑了内网地址。

排查顺序建议固定为：先端口监听，再防火墙/安全组，最后模型通道。这样能避免一上来就怀疑 Key，结果绕一大圈发现是端口没开。

六、把 Key 和通道固定下来，后续少踩坑

OpenClaw 的部署本身不复杂，复杂的是各种地址和端口的组合。把模型通道固定成 TaoToken 之后，Base URL 永远是https://taotoken.net/api，Key 从 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 创建，就不用每次换平台都重新记一套地址规则。

如果你只是临时验证模型通不通，可以直接用模型对话页面发一条请求，确认 Key 和通道没问题。如果你打算长期跑编码类任务或者 Agent 工作流，建议用 Coding Plan，把额度和通道稳定下来，避免频繁换 Key 导致 OpenClaw 里的配置反复改。接入过程中如果遇到 settings 或凭证管理相关的问题，去 API Keys 页面和接入文档里对照一下字段说明，基本都能定位到具体是哪一项填错了。

端口放行、bind_ip、Base URL 这三件事确认完，18789 和 401 这两个高频报错基本就都能解决了。