一、配置大模型¶
本教程基于（codex）gpt大模型中转站
1、注册
注册地址：https://codexzh.com/
2、购买套餐
如果是试用，可以购买日卡套餐，这里建议购买月卡（标准）套餐
大家不仅可以使用codex工具做ai编程，还可以用在openclaw，一鱼两吃
3、配置大模型
复制api key ：控制台 --> API密钥管理
下载配置脚本：
wget https://docs.codexzh.com/scripts/openclaw/setup-openclaw-codex.sh
执行该脚本即可
sh setup-openclaw-codex.sh
重启gateway
openclaw gateway restart
测试有无生效
二、OpenClaw Gateway¶
2.1 什么是OpenClaw Gateway¶
OpenClaw Gateway是OpenClaw架构的中枢控制器:
- 是唯一长期运行的控制进程,负责所有通道与智能体交互。
- 提供统一协议与路由逻辑,使系统内部各模块协作一致。
- 支持安全、可配置、多平台部署。
2.2 Gateway主要职责¶
归纳成一句话:所有“进出系统"的消息和事件,都由Gateway统一"把门”。
1、渠道协议适配
对接Telegram/WhatsApp/Discord/Slack/iMessage/飞书/钉钉等不同协议。
- 屏蔽底层差异,对上层Agent提供统一的内部消息格式。
2、会话与上下文管理
- 为每个对话创建独立的会话,不同会话上下文隔离。
- 管理主会话“群组会话”,支持按用户/群组维度隔离记忆。
3、路由与权限控制
- 决定哪些消息走哪个Agent(多Agent路由)。
- 白名单、黑名单、群聊是否必须@机器人等策略配置。
4、控制平面与节点协调
- 暴露WebSocket控制面,供WebUI、CLI、移动节点等连接。
- 管理移动节点(ios/Android)的配对与Canvas能力。
5、作为CanvasHost
默认在18793端口提供/openclaw/canvas/文件服务,为移动节点WebView提供UI能力(Live Canvas / A2UI)。
2.3 Gateway特点¶
| 特性 | 说明 |
|---|---|
| 单进程统一管理 | 所有通道与会话在一个地方管理，更易控制与运维。 |
| 可热重载配置 | 支持配置变更时自动热更新。 |
| 安全访问机制 | 支持令牌/密码认证、SSH 隧道、Tailscale 等远程安全访问。 |
| 支持多通道与扩展 | 不只限某一平台，可连接多种消息渠道。 |
| 支持 CLI 与可编程接口 | 允许命令行或程序化互动。 |
2.4 Gateway命令行用法¶
服务管理
#启动
openclaw gateway start
#停止
openclaw gateway stop
#重启
openclaw gateway restart
#查看状态
openclaw gateway status
#监控检查
openclaw gateway health