OpenClaw 部署全流程：本地安装、云端托管与进阶配置

Onboarding mode
● QuickStart (configure details later via openclaw configure.)
○ Manual

选 QuickStart，后面随时可以 openclaw configure 改。

模型供应商

Model/auth provider
○ OpenAI
○ Anthropic
○ MiniMax
● Moonshot AI (Kimi K2 + Kimi Coding)
○ Google
○ OpenRouter
○ Qwen
○ Z.AI (GLM 4.7)
○ Copilot
○ Vercel AI Gateway
○ OpenCode Zen
○ Xiaomi
○ Symbiotic
○ Venice AI
○ Skip for now

国内用户推荐 Moonshot AI 或 Qwen，不用翻墙，延迟低。选完要填 API Key，去对应平台生成一个就行。

聊天工具接入

支持的主流 IM：

• WhatsApp：扫码登录
• Telegram：配 Bot Token
• 微信、钉钉、飞书、企业微信：用机器人 Token
• QQ：通过插件

向导里可以跳过，后面再用 openclaw configure 添加。

网关端口

默认 18789，访问地址 http://127.0.0.1:18789/chat。如果有冲突，配置文件里改。

Skills

一些预置技能包，比如 web 搜索、代码编辑、文件操作、邮件处理。向导里可以全跳过，等用的时候 openclaw skills install <name> 再装。

完成向导后，OpenClaw 就会以后台服务形式运行。常用命令：

openclaw status              # 看状态
openclaw health              # 健康检查
openclaw gateway start/stop/restart  # 启停
openclaw message send --target +15555550123 --message "Hello"

配对与安全

默认情况下，未知私信会收到一个配对码，必须批准后才能对话。

openclaw pairing list whatsapp          # 查看待批准
openclaw pairing approve whatsapp <code> # 批准

云端部署

如果希望 7×24 小时在线，或者多终端访问，云端托管比本地电脑靠谱。

轻量云服务器

很多云服务商（阿里云、腾讯云、天翼云）都提供了 OpenClaw 应用镜像，选 2C2G 的套餐就行。部署步骤：

1. 购买时选 OpenClaw 镜像
2. 在控制台放行 18789 端口
3. 配置模型 API Key（Moonshot 或阿里云百炼等）
4. 生成访问 Token
5. 接入 IM 工具

云服务器手动部署

如果没用镜像，就在云服务器上跑一键脚本，和本地一样，注意用内网 API 端点可以降延迟。

经济型实例 2C2G 就够，但跑复杂任务时 CPU 会飙升，建议最少 2C4G。

AI 云电脑

天翼云提供开箱即用的云电脑方案，内置 OpenClaw，适合企业用户。我没试过，看文档是免配置。

进阶设置

配置文件

全部配置在 ~/.openclaw/config.json。关键部分：

{
  "routing": {
    "agents": {
      "main": {
        "workspace": "~/clawd",
        "sandbox": {
          "mode": "off"
        }
      }
    }
  },
  "gateway": {
    "port": 18789,
    "auth": {
      "token": "your-gateway-token"
    }
  },
  "models": {
    "default": "claude-3-5-sonnet",
    "providers": {
      "anthropic": {
        "apiKey": "sk-ant-xxxx"
      },
      "aliyun": {
        "apiKey": "sk-xxxx"
      }
    }
  }
}

沙盒模式

如果想让群聊里的 Agent 隔离运行，可以启用沙盒：

{
  "routing": {
    "agents": {
      "defaults": {
        "sandbox": {
          "mode": "non-main"
        }
      }
    }
  }
}

mode: "off" 关闭沙盒，mode: "non-main" 只对非主 Agent 启用。

Skills 管理

openclaw skills list          # 可用的 Skills
openclaw skills install web-search  # 安装
openclaw skills installed     # 已安装的

常用 Skills：web-search（需要 Brave Search API Key）、code-editor、file-operations、system-commands、email-handler。

踩坑与技巧

Windows 上尽量用 WSL2

原生 Windows 我没成功过，依赖工具兼容性差，WSL2 里一路顺畅。

'no auth configured' 错误

重新跑 openclaw onboard，选个模型供应商配 API Key。

IM 连不上

确保用 Node 跑网关（别用 Bun），网络没问题的话，重新扫码或配 Token。如果首次私信没反应，检查配对审批。

降低延迟

• 选就近的云区域
• 用国内模型
• 开启会话保持（配置文件里有 keepAlive 选项）

稳定运行

• 用 systemd（Linux）或 launchd（macOS）做成守护进程，安装时 --install-daemon 已经做了
• 云端部署默认不装 daemon，需要手动配置
• 设置自动重启策略

安全

• API Key 别硬编码，用环境变量或配置文件
• 启动配对验证，别把 Gateway Token 暴露在公网
• 敏感操作可以跑在沙盒里
• 定期轮换 Key

社区与资源

• 官网：https://openclaw.ai/
• GitHub：https://github.com/openclaw/openclaw
• 中文文档：https://clawd.org.cn/
• 社区 Skills：https://github.com/VoltAgent/awesome-openclaw-skills

有问题去 GitHub Issues 或 Discord/Telegram 群组，国内云厂商的交流群也活跃。

最后，这个项目更新很快，部署过程中如果遇到奇怪问题，先看看文档和 issue，一般都有解。整体来说，它是目前个人 AI 助手里比较务实的选择——轻量、开源、能干活，尤其适合想自己折腾一下的开发者。