一键部署 OpenClaw

通过一键脚本在 Linux 或 macOS 上部署 OpenClaw AI 网关，使用 QuickRouter 作为默认后端。安装器会写入可直接运行的 ~/.openclaw/openclaw.json、注册系统服务，并预配置一组适合聊天、编码和长上下文任务的模型。

概览

OpenClaw 适合把 QuickRouter 变成一个你自己可控的本地 AI 入口：

• 本地 WebUI / 网关，默认监听 18789
• 可直接复用 QuickRouter 的模型与额度
• 支持 Telegram，并预启用钉钉、企业微信、QQ Bot、Discord、Slack、飞书等插件入口
• 适合个人常驻机器人、团队内部助手、家庭服务器或轻量自托管场景

适合谁用

• 想用一条命令把 QuickRouter 接到本地 AI 网关的人
• 想把 Telegram Bot 跑在自己的服务器上的人
• 想统一管理聊天、WebUI、IM 入口的人
• 想给开发机或家用小主机部署常驻助手的人

使用协议

推荐协议：OpenAI-compatible API

• 安装器默认把 quickrouter provider 指向 https://api.quickrouter.ai/v1
• 同时会写入 quickrouter-claude、quickrouter-minimax provider，便于切换到 Anthropic Messages 兼容路径
• OpenClaw 自身对外暴露的是本地网关和 WebUI，认证依赖安装时生成的 gateway.auth.token

前置条件

5 分钟快速开始

安装器会引导你完成全部配置，包括 API Key、模型选择、Telegram Bot 等。

推荐模型配置

安装器默认主模型是 claude-sonnet-4-6。如果你想切换日常默认模型，直接修改 ~/.openclaw/openclaw.json 里的 agents.defaults.model.primary。

示例：把默认模型改成 gpt-5.4

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "quickrouter/gpt-5.4"
      }
    }
  }
}

如果你想显式走 Claude 兼容 provider，可以这样写：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "quickrouter-claude/claude-sonnet-4-6"
      }
    }
  }
}

Token 设置最佳实践

首次成功检查清单

• 浏览器能打开 http://<服务器IP>:18789?token=<gateway_token>
• OpenClaw WebUI 能正常进入，不会循环要求登录
• 默认模型可以成功返回第一条消息
• 修改模型后，重启服务仍能正常响应
• journalctl --user -u openclaw -f 或 tail -f ~/.openclaw/openclaw.log 能看到成功请求
• 如启用 Telegram，给机器人发消息后能够收到回复
• 已保存 ~/.openclaw/openclaw.json 备份

关键文件与配置项

文件位置

最常改的配置项

IM 接入

Telegram

这是安装器支持最完整的渠道，建议优先从 Telegram 开始：

1. 在 Telegram 搜索 @BotFather
2. 发送 /newbot 创建机器人，并拿到 Bot Token
3. 安装器询问 Set up Telegram Bot now? 时选择 Y
4. 粘贴 Bot Token，安装器会把它写入 ~/.openclaw/openclaw.json
5. 安装器自动重启网关后，给机器人发送任意一条消息
6. 第一位发送消息的人会被自动配对为 owner
7. 如果自动配对失败，执行：

openclaw pairing list
openclaw pairing approve <code>

手动补写 Telegram 配置时，可参考安装器写入的结构：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456789:ABCdef...",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist",
      "streaming": "off"
    }
  },
  "plugins": {
    "entries": {
      "telegram": { "enabled": true }
    }
  }
}

其他 IM 平台

安装器会预启用以下插件入口：

• dingtalk
• openclaw-wecom
• qqbot
• discord
• slack
• feishu

但这些渠道通常还需要你自己补充平台凭证和对应的 channels.<name> 配置。推荐流程是：

1. 先在对应平台创建机器人或应用
2. 把平台凭证写入 ~/.openclaw/openclaw.json
3. 确认对应 plugins.entries.<name>.enabled 为 true
4. 重启 OpenClaw 服务
5. 通过日志验证该渠道是否成功加载

服务管理与日志

Linux (systemd)

systemctl --user status openclaw
systemctl --user start openclaw
systemctl --user restart openclaw
systemctl --user stop openclaw
journalctl --user -u openclaw -f

说明：安装器会尝试执行 loginctl enable-linger $(whoami)，这样即使你退出 SSH，会话外的用户级服务也能继续运行。

macOS (launchd)

launchctl list | grep openclaw
launchctl start com.quickrouter.openclaw
launchctl stop com.quickrouter.openclaw
launchctl stop com.quickrouter.openclaw && launchctl start com.quickrouter.openclaw
tail -f ~/.openclaw/openclaw.log
cat ~/.openclaw/openclaw.err

说明：macOS 下 openclaw.log 通常看运行日志，openclaw.err 更适合排查启动失败。

性能与成本建议

• 默认先用 claude-sonnet-4-6，确认整体流程跑通后再做模型分工
• 高频日常问答或机器人通知场景，优先尝试 claude-sonnet-4-6 或 gemini-3-pro-preview
• 编码类工作流单独切到 gpt-5.4
• 团队场景把 Telegram / 企业 IM / WebUI 分成不同 token，便于成本核算和风险隔离
• 只保留必要插件和必要模型，减少误调用成本

升级指南

最稳妥的升级方式是重新运行安装器，因为它会一起处理 OpenClaw 包、补丁和服务脚本。

如果你明确知道自己只想升级 OpenClaw npm 包，也可以先执行 npm install -g openclaw@latest，再重启服务；但这种方式不会帮你重新应用安装器里的补丁与脚本更新。

卸载指南

Linux

systemctl --user disable --now openclaw
rm -f ~/.config/systemd/user/openclaw.service
systemctl --user daemon-reload
rm -rf ~/.openclaw
npm uninstall -g openclaw

macOS

launchctl stop com.quickrouter.openclaw
launchctl unload ~/Library/LaunchAgents/com.quickrouter.openclaw.plist
rm -f ~/Library/LaunchAgents/com.quickrouter.openclaw.plist
rm -rf ~/.openclaw
npm uninstall -g openclaw

如果你当初是专门为了 OpenClaw 安装 Node.js，也可以在确认没有其他项目依赖后再手动移除 Node.js。

常见错误与修复

FAQ

应该使用哪个地址作为 QuickRouter 后端？

默认保持安装器写入的值即可：OpenAI 兼容 provider 用 https://api.quickrouter.ai/v1，Claude / MiniMax 原生兼容 provider 用 https://api.quickrouter.ai。

应该保留哪个默认模型？

大多数情况下先保留 claude-sonnet-4-6。如果你主要把 OpenClaw 当代码助手，再切到 gpt-5.4。

为什么模型列表里看不到我想用的模型？

通常是你的 QuickRouter token 没放行该模型，或你改成了错误的 provider 前缀。

为什么 Telegram 私聊可以，群聊不行？

安装器默认把 Telegram 组策略设为 allowlist。你需要按自己的使用需求继续调整 Telegram channel 配置。

怎样最安全地对外开放 OpenClaw？

最少要做到三件事：限制来源访问、保护好 gateway.auth.token、为 OpenClaw 使用单独的 QuickRouter token。若直接暴露公网，建议再加反向代理和额外访问控制。

OpenClaw 最新版本 自定义 API 中转配置要点

如果你通过搜索“OpenClaw 最新版本 自定义 配置教程”“OpenClaw 最新版本 自定义 API 中转”“OpenClaw 最新版本 自定义 QuickRouter”进入本页，优先检查 API Key、Base URL 和模型 ID。多数调用失败都和这三个配置有关。

常见排查方向

• 401 Unauthorized：检查 API Key 是否复制完整、是否仍有额度。
• 404 或 model not found：检查模型 ID 是否来自 QuickRouter 价格页，确认当前分组支持该模型。
• 连接超时：确认工具里的 Base URL 没有多写路径或空格。
• Claude 相关工具异常：优先查看本页是否要求 Anthropic 原生地址，不要直接套用 OpenAI 兼容地址。

相关入口

• API 中转站说明
• OpenAI API 中转配置
• Claude API 国内使用
• Gemini API 国内使用
• 模型价格和分组

常见问题

OpenClaw 最新版本 自定义 可以通过 QuickRouter API 接入大模型吗？

可以。只要 OpenClaw 最新版本 自定义 支持自定义 API Key、Base URL 或兼容 OpenAI/Claude 的接口，就可以按本页方式接入 QuickRouter。

OpenClaw 最新版本 自定义 的 Base URL 应该怎么填？

按本页对应工具的要求填写。OpenAI 兼容工具通常使用 https://api.quickrouter.ai/v1，Claude/Anthropic 类工具可能使用 https://api.quickrouter.ai。

OpenClaw 最新版本 自定义 提示 model not found 怎么办？

到 模型价格和分组 页面复制完整模型 ID，并确认 API Key 所在分组支持该模型。