用途:在 Linux(推荐 Debian/Ubuntu)主机上部署 OpenClaw,启用钉钉、飞书、Discord 或官方文档中的其他渠道,并验证网关健康状态。
主要能力:提供按顺序执行的工作流——准备 Linux 运行时并安装 OpenClaw;从官方文档发现渠道(新渠道请求必需);安装并验证渠道集成;创建或合并 ~/.openclaw/openclaw.json;配置并启动网关服务;运行健康检查并收集日志。
前置条件:目标 Linux 主机的 SSH 访问;钉钉企业应用凭证(AppKey、AppSecret)或飞书应用凭证(App ID、App Secret)或 Discord 机器人 token;DashScope API key。
安装要点:安装 Node.js 20,执行 npm install -g openclaw@latest 与 openclaw --version。钉钉官方连接器可用 openclaw plugins install @dingtalk-real-ai/dingtalk-connector --pin;飞书渠道用 openclaw plugins install @openclaw/feishu;Discord 为内置渠道,无需额外插件。若从旧钉钉插件升级,需先卸载旧插件 ID,仅在 plugins.allow 中保留官方连接器。
配置要点:在 ~/.openclaw/openclaw.json 中配置 models.providers.bailian、agents.defaults.model.primary(默认 bailian/glm-5)、模型顺序(qwen3-plus、glm-5、minimax-m2.5、kimi-k2.5)、fallbacks、渠道凭证与策略、plugins.allow。注意 agents 级模型配置 ~/.openclaw/agents/main/agent/models.json 可覆盖主配置。协议与端点需匹配:openai-completions 对应 https://dashscope.aliyuncs.com/compatible-mode/v1,openai-responses 对应 https://dashscope.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1。
启动与验证:执行 openclaw gateway install、openclaw gateway start、openclaw gateway status;用户级 systemd 需重载并重启 openclaw-gateway。验证用 openclaw doctor、openclaw gateway status、openclaw gateway logs -f。
限制与注意:不要硬编码真实密钥,生产密钥放在服务器本地配置或密钥管理器中,分享日志前需脱敏。常见故障包括插件未加载、未知模型、API key 错误、配置改动但运行时模型未变、空载荷或意外回退、钉钉/飞书/Discord 无响应等。资料未提供价格、性能数据或平台兼容性范围之外的细节。