OpenClaw
在 OpenClaw 中配置 OminiApi，并接入 Telegram 机器人
OpenClaw 是开源的常驻 AI Agent，可以跑在服务器上，通过 Telegram 等社交软件和网页控制台跟它对话。
本教程适合 Linux 云服务器和 macOS 用户。Windows 用户可以在 WSL 里操作。
安装与初始化
SSH 登录服务器（或在 macOS 打开终端），运行安装脚本，耐心等待。出现确认提示时选择 yes 回车。
curl -fsSL https://openclaw.ai/install.sh | bash按向导依次选择：
- 安装模式：
QuickStart； - 选择供应商：先选
Skip for now跳过，下面再配置 OminiApi； - 适配器：
anthropic； - 模型：随便选一个，后面会改成 OminiApi 的模型；
- 社交软件适配器：按需选择，本文以
Telegram为例，输入 Bot Token 后回车； - Skill：先跳过，之后可以在网页里安装；
- Hook：空格全选后回车，之后会安装 Gateway，耐心等待；
- 打开方式：先跳过；
- Shell 补全脚本：选
yes。
配置 OminiApi
编辑 openclaw.json
编辑 ~/.openclaw/openclaw.json，在已有内容里加上 models 和 agents.defaults.model。按要用的模型选一种：
{
agents: {
defaults: { model: { primary: "omini/claude-opus-5-5" } },
},
models: {
mode: "merge",
providers: {
omini: {
baseUrl: "https://omini.ominiapi.top",
apiKey: "${OMINI_API_KEY}",
api: "anthropic-messages",
models: [
{ id: "claude-opus-5-5", name: "Claude Opus 5.5" },
{ id: "claude-sonnet-5", name: "Claude Sonnet 5" },
],
},
},
},
}Claude 走 Anthropic 接口，baseUrl 不带 /v1。
两个提供商可以同时写在 providers 里。primary 的格式是 提供商名/模型 ID。
设置 API Key
把 Key 写进环境变量（bash 用户改为 ~/.bashrc）：
echo 'export OMINI_API_KEY="你的 API Key"' >> ~/.zshrc
source ~/.zshrc重启 Gateway 并测试
openclaw gateway restart
openclaw tui在 TUI 里发一句话，能正常回复就说明配置成功，输入 /quit 退出。也可以用 openclaw models list 查看已配置的模型。
浏览器访问
运行下面的命令，会在浏览器打开（或复制）一个一次性的控制台登录链接：
openclaw dashboard在服务器上没有浏览器时，用 openclaw dashboard --json 拿到返回的 browserUrl，在本地浏览器打开。
在服务器上运行
请用 Nginx 等反向代理对外提供服务，并配置 SSL 证书。如果需要通过 HTTP 访问，在 ~/.openclaw/openclaw.json 的 gateway 字段下加上：
"controlUi": {
"allowInsecureAuth": true
}改完运行 openclaw gateway restart。
配置 Telegram 机器人权限
回到 @BotFather 的对话，点击你的机器人链接，给机器人发一条消息。首次对话会返回一个 Pairing code。
在终端批准配对：
openclaw pairing approve telegram 你的Pairing code之后就可以直接在 Telegram 里和机器人对话了。
常见问题
- Claude 模型报
No eligible upstream supports the requested interface or model：Claude 只支持 Anthropic 接口，api要填anthropic-messages，baseUrl不带/v1。 - 401：检查
OMINI_API_KEY是否在运行 Gateway 的那个 shell 环境里生效。 - 其他报错到 使用日志 查看原因；OpenClaw 配置字段以 OpenClaw 官方文档 为准。