OpenClaw

OpenClaw 是一款支持 Linux 服务器和 macOS 的 AI 网关工具，支持多模型接入、浏览器 Dashboard 访问和 Telegram Bot 集成。

---

安装与初始化

第 1 步：执行安装命令

curl -fsSL https://openclaw.ai/install.sh | bash

提示时输入 yes 确认。

第 2 步：选择 QuickStart

第 3 步：跳过供应商选择

出现供应商选择时，选择"Skip for now"。

第 4 步：选择 Anthropic 适配器

第 5 步：选择模型

选择 opus-4.5（或其他可用模型）。

第 6 步：选择社交软件适配器

以 Telegram 为例选择 Telegram。

第 7 步：输入 Bot Token

第 8 步：跳过 Skill 安装

（可通过 Web 界面后续安装）

第 9 步：选择 Hook 选项

用空格全选所有 Hook，确认。

第 10 步：确认安装 Shell 补全脚本

输入 yes。

---

配置预制小龙虾渠道

推荐直接在 OpenClaw 的 Provider 配置页中手动添加预制小龙虾渠道。这样更稳定，也便于后续切换令牌或分组。

手动配置流程：

1. 打开 OpenClaw 的 Provider 管理页，选择"添加供应商"
2. Provider 名称填写：预制小龙虾
3. 接口类型按模型家族选择：
   • Claude 系列：Anthropic
   • Codex / GPT 系列：OpenAI Compatible
   • Gemini 系列：Google Gemini Compatible
4. Base URL 填写：
   • Claude / Gemini：https://www.yuzhixiaolongxia.com
   • Codex / GPT：https://www.yuzhixiaolongxia.com/v1
5. API Key 填写在控制台创建的令牌
6. Model ID 填写你准备调用的模型别名，例如：
   • Claude：claude-sonnet-4
   • Codex：codex-mini-latest
   • Gemini：gemini-2.5-pro
7. 保存配置后重启 Gateway：

openclaw gateway restart

推荐令牌分组

模型类型	推荐分组
Claude 系列	AWS-Q、AWS、claude-officially 分组
Codex/GPT 系列	Codex、GPT-officially 分组
Gemini 系列	Gemini-slb 分组

验证配置

使用 TUI 或 Dashboard 测试：

openclaw tui

输入一条简单指令，例如"输出当前 Provider 名称和模型"，确认返回成功后再继续接入 Telegram 或浏览器端。

---

开启浏览器 Dashboard 访问

1. 修改 ~/.openclaw/openclaw.json，在 gateway 下添加：

   "controlUi": {
     "allowInsecureAuth": true
   }

2. 重启 Gateway：

   openclaw gateway restart

3. 使用 Dashboard URL 和 Token 访问

服务器部署时，建议通过 Nginx 反向代理并配置 SSL 证书。

---

Telegram Bot 配置

1. 联系 @BotFather，访问你的 Bot，发起对话获取 Pairing code
2. 批准访问：

   openclaw pairing approve telegram [your-pairing-code]

---

排查思路

问题	检查点
无法调用模型	令牌是否属于正确分组、Gateway 是否已重启
Dashboard 无法访问	allowInsecureAuth 是否已配置、端口是否开放
Telegram Bot 无响应	Pairing 是否已完成、Bot Token 是否正确