一键部署 OpenClaw

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

概览

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

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

适合谁用

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

使用协议

推荐协议：OpenAI-compatible API

• 安装后请将 quickrouter provider 的地址手动改为 https://api.julanjing.com/v1；provider 名称是安装器的配置标识
• 如果安装器创建了其他 provider，也请检查它们的接口地址和模型权限
• OpenClaw 自身对外暴露的是本地网关和 WebUI，认证依赖安装时生成的 gateway.auth.token

前置条件

5 分钟快速开始

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

推荐模型配置

建议将主模型设为 deepseek-v4.1-flash。如果你想切换日常默认模型，直接修改 ~/.openclaw/openclaw.json 里的 agents.defaults.model.primary。

示例：把默认模型改成 glm-5.3

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "quickrouter/glm-5.3"
      }
    }
  }
}

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

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "quickrouter-claude/deepseek-v4.1-flash"
      }
    }
  }
}

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 更适合排查启动失败。

性能与成本建议

• 默认先用 deepseek-v4.1-flash，确认整体流程跑通后再做模型分工
• 高频日常问答或机器人通知场景，优先尝试 deepseek-v4.1-flash 或 glm-5.3
• 编码类工作流单独切到 glm-5.3
• 团队场景把 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

应该使用哪个地址作为 巨蓝鲸AI 后端？

不要直接沿用安装器写入的接口地址。请手动检查：OpenAI 兼容 provider 用 https://api.julanjing.com/v1；其他兼容 provider 需根据其实际协议单独核对。

应该保留哪个默认模型？

大多数情况下先保留 deepseek-v4.1-flash。如果你主要把 OpenClaw 当代码助手，再切到 glm-5.3。

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

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

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

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

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

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