OpenClaw Web 管理面板配置与大模型接入实践

Gateway 状态可能显示异常关闭，需通过 SSH 转发访问。

开启局域网访问

默认 gateway.bind 为 loopback，仅本地回环地址可访问。如需局域网访问：

openclaw config set gateway.bind lan

也可使用 SSH 映射解决远程访问问题。

启动服务

openclaw gateway --port 18789 --verbose

Web 登录地址：http://127.0.0.1:18789

配对和批准

如果登录报错 pairing required，需进行配对操作。

列出配对值：

openclaw devices list

批准配对：

openclaw devices approve

最终 Web 控制面板可以打开。

配置大模型

尝试了多个免费大模型，但因 Token 长度限制无法使用。测试千帆大模型 ERNIE-Lite-Pro-128K，效果如下：

总结

推荐方案

直接安装 openclaw-cn 国产软件，初始化配置自动生成国内适配文件：

pnpm install -g openclaw-cn --registry=https://registry.npmmirror.com
openclaw-cn onboard --install-daemon

然后再搭载国产收费大模型即可。

成本分析

OpenClaw 运行消耗较大。使用千帆最便宜的模型 Ernie lite pro，一次对话（如问天气、系统情况）约花费 0.02 元，多问几个问题约 0.1 元。完成复杂任务建议包月。

替代方案

可考虑 WinClaw，目前每天有一定免费 token 额度，适合完成小任务。

调试常见问题

npm 版本更新提醒

npm install -g [email protected]

Git 权限错误

若遇到 Permission denied (publickey)，可能是 github 网络波动。升级 npm 后重试通常可解决。

构建报错

若遇到 A2UI bundling failed 或 Cannot resolve entry module，尝试清理缓存并重新安装：

pnpm store prune rm -rf node_modules
pnpm install
pnpm build

若仍不行，尝试使用 sudo 安装：

sudo npm i -g openclaw

浏览器登录报错 origin not allowed

修改 .openclaw/openclaw.json 文件，在 controlUi.allowedOrigins 中添加对应 IP 地址：

"gateway": {
  "port": 18789,
  "mode": "local",
  "bind": "lan",
  "controlUi": {
    "allowedOrigins": [
      "http://localhost:18789",
      "http://127.0.0.1:18789",
      "http://192.168.1.12:18789"
    ]
  }
}

若出现 control ui requires device identity，建议使用 SSH 转发到 127.0.0.1 的方式。

Chat 报错 403 status code

星河社区的模型可能出现此错误，可能是模型未启动或 API 不可用。

空间不足

若安装报错 Updating repository failed，检查磁盘空间。示例中 / 分区已满，需扩容后再继续安装。

pnpm git 依赖准备失败

若遇到 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED，需在 pnpm-workspace.yaml 中添加相关包到 onlyBuiltDependencies 列表。

RPC 失败

若遇到 curl 16 Error in the HTTP2 framing layer，通常是网络问题，可重试或更换网络环境。

端口监听问题

若 curl localhost:18789 返回 Not Found 或 Connection refused，检查网关是否启动及绑定配置。安装 openclaw-cn 版本通常能解决此类兼容性问题。

Pairing Required

若 Chat 会话显示 Disconnected from gateway 且 pairing required，需先列出设备并批准配对。

openclaw devices list
openclaw devices approve <device_id>

Inference Serverless API 未找到

部分推理模型可能存在兼容性问题，建议更换稳定模型进行测试。