土木人 OpenClaw 完全安装指南——从零到通过 WhatsApp 运行你的第一个 AI Agent

# 检查 Node.js 版本
$ node --version
v22.x.x   # 需要 ≥ 22
# macOS 安装 Node.js:
$ brew install node@22
# Linux (Ubuntu/Debian):
$ curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
$ sudo apt install -y nodejs

$ curl -fsSL https://openclaw.ai/install.sh | bash

# 全局安装
$ npm install -g openclaw@latest
# 或用 pnpm:
$ pnpm add -g openclaw@latest

$ docker pull openclaw/openclaw:latest
$ docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

$ openclaw onboard --install-daemon
# 向导会引导你完成:
# 1. 确认安全风险 → 选择 "Yes"
# 2. 安装模式 → 选择 "QuickStart"（新手推荐）
# 3. 选择 AI 模型提供商 → Anthropic / OpenAI / DeepSeek / 本地 Ollama
# 4. 输入 API Key
# 5. 选择消息平台 → WhatsApp / Telegram / Discord 等
# 6. 平台配对（扫码或输入 Bot Token）
# 7. 安装 Gateway 守护进程（launchd/systemd）
# --install-daemon 会自动安装后台服务，开机自启

{
  "models": {
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "sk-你的DeepSeek密钥",
        "api": "openai-completions",
        "models": [{
          "id": "deepseek-chat",
          "name": "DeepSeek-V3",
          "reasoning": true,
          "input": ["text"],
          "contextWindow": 131072,
          "maxTokens": 8192
        }]
      },
      "qwen": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "sk-你的通义千问密钥",
        "api": "openai-completions",
        "models": [{
          "id": "qwen-max",
          "name": "Qwen-Max",
          "reasoning": true,
          "input": ["text"],
          "contextWindow": 131072,
          "maxTokens": 8192
        }]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat"
      }
    }
  }
}

# 启动 Gateway（如果 onboard 时已安装 daemon 则自动运行）
$ openclaw gateway --port 18789 --verbose
# 检查状态
$ openclaw status
# 通过 CLI 直接发消息测试
$ openclaw agent --message "你好，请简单介绍一下你自己"
# 或向指定联系人发送
$ openclaw message send --to +8613800138000 --message "Hello from OpenClaw"

你: 帮我查一下今天的天气
Agent: 正在查询...（调用浏览器工具获取天气信息）
你: 帮我创建一个文件 report.md，内容是今天的工作总结模板
Agent: ✅ 已创建 report.md
你: /status
Agent: 📊 Model: deepseek-chat | Tokens: 1,204 | Session: active

# 搜索 Skill
$ npx clawhub@latest search email
# 安装 Skill
$ npx clawhub@latest install summarize
# 查看已安装 Skill
$ ls ~/.openclaw/skills/

# 1. 一键诊断（最有用，输出可直接发到社区求助）
$ openclaw status --all
# 2. 自动修复常见问题（权限、缺失目录、配置错误）
$ openclaw doctor --fix
# 3. 实时查看日志（复现问题时开着）
$ openclaw logs --follow
# 4. 检查 Gateway 状态
$ openclaw gateway status
# 5. 检查模型认证状态
$ openclaw models status
# 6. 检查消息平台连接
$ openclaw channels status --probe
# 7. 检查定时任务
$ openclaw cron status
# 8. 开启 debug 级别日志（详细排查用）
$ OPENCLAW_LOG_LEVEL=debug openclaw gateway run
# 9. 聊天中使用 /debug 命令（需先在配置中设置 commands.debug: true）
# /debug show    ← 查看运行时配置
# /debug set key=value  ← 临时修改配置
# 10. 清除缓存（万能重置）
$ openclaw cache clear --all