---

一、 基础环境准备

OpenClaw 对 Node.js 版本有严格要求，必须使用 v22 或更高版本。

1. 安装 Node.js 22：
   bash curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs
2. 安装 OpenClaw CLI：
   bash sudo npm install -g openclaw@latest

---

二、 核心配置：API 代理与模型

这是让 AI “开口说话”的关键。由于使用中转 API，必须手动修正 openclaw.json。

1. 配置文件位置：/root/.openclaw/openclaw.json
2. 标准配置结构 (models.providers 模式)：
   json { "models": { "providers": { "openai": { "baseUrl": "https://cli.itdong.me/v1", "apiKey": "你的sk-xxxx密钥", "api": "openai-responses", "models": [ { "id": "gpt-5.3-codex", "name": "GPT-5.3 Codex" }, { "id": "gpt-4o", "name": "GPT-4o" } ] } } }, "agents": { "defaults": { "model": { "primary": "openai/gpt-4o" } } } }
3. 生效命令：
   每次手动改完 JSON 都要执行：
   bash rm -rf /root/.openclaw/agents/main # 清理旧缓存（非常重要） systemctl --user restart openclaw-gateway # 重启服务

---

三、 远程管理：可视化控制面板 (Dashboard)

OpenClaw 默认只允许本地访问，需通过 SSH 隧道映射到你自己的电脑。

1. 建立隧道 (在你的本地电脑执行)：
   bash ssh -L 18789:127.0.0.1:18789 root@你的服务器IP
2. 获取 Access Token：
   bash openclaw config get gateway.auth.token
3. 浏览器访问：
   http://localhost:18789/#token=你的Token

---

四、 接入消息频道 (Channels)

1. 个人微信 (企业微信插件方案 – 最推荐)

• 原理：自建企业微信应用 -> 开启微信插件 -> 在普通微信聊天。
• 配置项：corpId, agentId, secret。
• 安全验证：第一次发消息会收到 Pairing Code，需在服务器输入：
  openclaw pairing approve wecom 验证码。

2. 飞书 (Feishu/Lark)

• 原理：飞书开放平台创建自建应用 -> 配置事件订阅。
• 关键点：在 OpenClaw Dashboard 的 Channels 页面复制 Webhook URL，填入飞书后台的“请求地址”并验证通过。

3. 微信小程序 (ClawChat 方案 – 最简单)

• 配置项：botId, secret。
• 优点：扫码即用，无需配置公网回调地址。

---

五、 运维与常用命令

• 重启服务：systemctl --user restart openclaw-gateway
• 查看实时日志：openclaw logs --follow
• 医生检查 (一键修复问题)：openclaw doctor --fix
• 添加/更新智能体：openclaw agents add main --profile openai:default
• 强制启动网关：openclaw gateway --allow-unconfigured

---

六、 避坑指南 (Pro Tips)

1. 502 Unknown Provider：通常是因为模型名称没带前缀（应为 openai/gpt-4o）或 providers 层级写错。
2. 格式错乱：确保配置里 "api" 是 "openai-responses"，而不是旧版的 completions。
3. 配置不生效：修改 openclaw.json 后，必须删除 /root/.openclaw/agents/main 文件夹，否则 AI 会一直读旧的缓存。
4. 网页无法登录：检查 SSH 隧道是否断开，检查 Token 是否包含多余的空格。

---