OpenClaw网关配置让我真正实现了自托管AI服务
OpenClaw网关配置,让我真正实现了自托管AI服务
5分钟部署自己的AI服务,随时随地可用。
写在前面
用OpenClaw也有一段时间了,从小白到熟练,我总结了一套完整的网关配置经验。
今天分享出来,帮助大家快速上手。
Gateway是什么
Gateway = 网关 = AI服务的中枢
所有聊天通道、AI模型、工具调用都要经过Gateway。
它运行在你的电脑上,24小时在线,随时响应。
快速启动
方式一:前台运行(测试用)
openclaw gateway --port 18789
方式二:安装为服务(生产用)
# macOS
openclaw gateway install
# Linux
sudo systemctl enable --now openclaw-gateway.service
常用命令
| 命令 | 作用 |
|---|---|
| openclaw gateway start | 启动网关 |
| openclaw gateway stop | 停止网关 |
| openclaw gateway restart | 重启网关 |
| openclaw gateway status | 查看状态 |
| openclaw logs --follow | 查看日志 |
配置热加载
OpenClaw支持配置热加载,修改配置不用重启:
| 模式 | 说明 |
|---|---|
| off | 不加载新配置 |
| hot | 只加载安全的配置 |
| restart | 需要重启才能生效 |
| hybrid | 自动选择最佳方式 |
默认是hybrid,修改配置后会自动应用。
远程访问
方法一:Tailscale(推荐)
自己搭建VPN,安全的远程访问。
方法二:SSH隧道
ssh -N -L 18789:127.0.0.1:18789 user@你的服务器
然后本地访问 ws://127.0.0.1:18789
端口配置
默认端口是18789,可以用多种方式修改:
# 命令行指定
openclaw gateway --port 20000
# 环境变量
export OPENCLAW_GATEWAY_PORT=20000
# 配置文件
{
"gateway": {
"port": 20000
}
}
优先级:命令行 > 环境变量 > 配置文件
认证配置
Gateway默认需要认证,保护你的AI服务:
{
"gateway": {
"auth": {
"token": "你的token",
"password": "你的密码"
}
}
}
或者用环境变量:
export OPENCLAW_GATEWAY_TOKEN=你的token
export OPENCLAW_GATEWAY_PASSWORD=你的密码
监控与运维
查看状态
openclaw gateway status
健康状态会显示:
- Runtime: running
- RPC probe: ok
- 通道状态
诊断问题
openclaw doctor
自动检测并修复常见问题。
多平台服务管理
macOS
openclaw gateway install
# 开机自启
launchctl load ~/Library/LaunchAgents/ai.openclaw.gateway.plist
Linux systemd
sudo systemctl enable --now openclaw-gateway
保持后台运行
退出终端后还想运行?用nohup或screen:
nohup openclaw gateway --port 18789 > /var/log/openclaw.log 2>&1 &
常见问题
Q: 网关启动失败?
# 强制杀死占用端口的进程
openclaw gateway --force
# 查看详细日志
openclaw gateway --verbose
Q: 想修改配置?
直接编辑 ~/.openclaw/openclaw.json,会自动热加载。
Q: 想看实时日志?
openclaw logs --follow
我的配置分享
这是我的生产配置:
{
"gateway": {
"port": 18789,
"bind": "loopback",
"reload": {
"mode": "hybrid"
},
"auth": {
"token": "env:OPENCLAW_TOKEN"
}
},
"browser": {
"enabled": true,
"defaultProfile": "openclaw"
}
}
总结
OpenClaw网关配置的核心要点:
- 快速启动 - 5分钟搞定
- 热加载 - 修改配置不用重启
- 远程访问 - Tailscale或SSH隧道
- 认证保护 - 安全第一
- 多平台支持 - macOS/Linux/Windows
自己托管AI服务,数据自己掌控,这才是真正的自由!
作者:棒棒金
浙公网安备 33010602011771号