OpenClaw 无 GUI 场景下的 OAuth 认证
OpenClaw 支持通过 API Key 和 OAuth 两种方式调用大模型，通常推荐使用 OAuth 认证以获得更好的安全性和管理能力。
在无 GUI（无图形界面）的环境中（如服务器或远程主机），可以通过端口映射的方式完成 OAuth 认证流程。
认证原理说明
OpenClaw 在进行 OAuth 认证时，会在本地监听 1455 端口用于接收回调。
当用户在浏览器中完成授权后，OAuth 服务会将认证结果重定向至本地 http://127.0.0.1:1455，从而完成整个认证流程。
在无 GUI 的环境下，需要借助端口转发，将该回调流量转发到可访问浏览器的本地机器。
端口映射
在一台可以访问浏览器的本地机器上，通过 SSH 建立端口转发：
1 | ssh -N -L 1455:127.0.0.1:1455 root@<your_openclaw_machine_ip> |
说明：
- 本地机器的
1455端口会被转发到远端 OpenClaw 主机的1455端口 - 浏览器访问回调地址时，实际会命中远端 OpenClaw 服务
OpenAI Codex OAuth 认证
在 OpenClaw 所在主机上执行以下命令发起认证流程：
1 | openclaw models auth login --provider openai-codex |
执行后会输出一个认证 URL。
将该 URL 复制到浏览器中打开，完成 OAuth 授权流程即可。
认证完成后，浏览器会重定向到本地 1455 端口，并通过端口映射回传至 OpenClaw，从而完成认证。
OpenClaw 无 GUI 场景下的 OAuth 认证
https://warnerchen.github.io/2026/04/08/OpenClaw-无-GUI-场景下的-OAuth-认证/
You need to set
install_url to use ShareThis. Please set it in _config.yml.