一键部署 OpenClaw

​

概览

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

​

适合谁用

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

​

使用协议

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

​

前置条件

​

5 分钟快速开始

curl -fsSL https://raw.githubusercontent.com/xujfcn/crazyrouter-openclaw/main/install.sh | bash

CRAZYROUTER_API_KEY=sk-xxx INSTALLER_LANG=zh \
  curl -fsSL https://raw.githubusercontent.com/xujfcn/crazyrouter-openclaw/main/install.sh | bash

​

推荐模型配置

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

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "crazyrouter-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

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>

{
  "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

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

​

服务管理与日志

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

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

​

性能与成本建议

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

​

升级指南

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

curl -fsSL https://raw.githubusercontent.com/xujfcn/crazyrouter-openclaw/main/install.sh | bash

​

卸载指南

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

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

​

常见错误与修复

​

FAQ

​

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

​

应该保留哪个默认模型？

​

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

​

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

​

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