七、实战案例

7.1 个人助手设置

目标

配置一个 24/7 在线的个人 AI 助手，通过 WhatsApp 和 Telegram 随时访问。

配置步骤

1. 安装和初始化

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

2. 配置模型提供商

编辑 ~/.openclaw/openclaw.json：

{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-sonnet-4-20250514",
      "workspace": "~/openclaw-workspace"
    }
  }
}

3. 配置 WhatsApp

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+86你的号码"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

4. 配置 Telegram

{
  "channels": {
    "telegram": {
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

5. 启动并验证

openclaw gateway restart
openclaw channels status --probe

7.2 多智能体路由

目标

按发送者或工作区隔离会话，不同场景使用不同智能体。

配置

{
  "agents": {
    "list": [
      {
        "id": "coding-assistant",
        "model": "anthropic/claude-sonnet-4-20250514",
        "workspace": "~/coding-workspace",
        "tools": {
          "profile": "coding"
        }
      },
      {
        "id": "general-assistant",
        "model": "openai/gpt-4o",
        "workspace": "~/general-workspace",
        "tools": {
          "profile": "full"
        }
      }
    ]
  }
}

会话隔离

私聊：会合并到共享的 main 会话
群组：彼此隔离
按智能体：完全隔离

7.3 远程部署到 VPS

目标

在云服务器上部署 OpenClaw，通过 Tailscale 安全访问。

步骤

1. 服务器安装

# SSH 到服务器
ssh user@your-vps
 
# 安装
curl -fsSL https://openclaw.ai/install.sh | bash

2. 配置 Tailscale

# 安装 Tailscale
curl -fsSL https://tailscale.com/install.sh | sh
 
# 连接
tailscale up

3. 配置 Gateway

{
  "gateway": {
    "bind": "loopback",
    "tailscale": { "mode": "serve" },
    "auth": { "mode": "token", "token": "your-secure-token" }
  }
}

4. 安装服务

openclaw gateway install
openclaw gateway status

5. 访问

通过 Tailscale MagicDNS 访问：

https://your-hostname.tailnet/

7.4 工具安全配置

目标

收紧权限，限制智能体可以执行的操作。

最小权限配置

{
  "tools": {
    "profile": "coding",
    "allow": ["group:fs", "web_search", "browser"],
    "deny": ["exec"],
    "exec": {
      "host": "node",
      "security": "allowlist"
    }
  }
}

群组安全配置

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+86你的号码"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  },
  "messages": {
    "groupChat": {
      "mentionPatterns": ["@openclaw"]
    }
  }
}

7.5 节点主机设置

目标

配置一台 Mac 作为节点主机，提供 Canvas 和摄像头能力。

步骤

1. 在 Mac 上启动节点

openclaw node run --host <gateway-host> --port 18789 --display-name "Mac Node"

2. 在 Gateway 上批准

openclaw devices list
openclaw devices approve <requestId>

3. 配置 exec 指向节点

openclaw config set tools.exec.host node
openclaw config set tools.exec.node "Mac Node"

4. 测试

# 截图
openclaw nodes canvas snapshot --node "Mac Node" --format png
 
# 拍照
openclaw nodes camera snap --node "Mac Node"

7.6 Web 搜索集成

目标

配置多个搜索引擎供智能体使用。

配置

{
  "tools": {
    "web_search": {
      "provider": "brave",
      "apiKey": "YOUR_BRAVE_API_KEY"
    }
  }
}

支持的搜索提供商：

Brave Search
DuckDuckGo
Exa
Firecrawl
Gemini
Grok
Kimi
MiniMax Search
Ollama Web 搜索
Perplexity
SearXNG
Tavily

7.7 计划任务（Cron）

目标

设置定时任务，如每日摘要、定时提醒。

使用 Cron 工具

智能体可以通过 cron 工具管理计划任务：

# 查看计划任务
openclaw cron list
 
# 添加任务（通过智能体）
# 智能体会使用 cron 工具来创建任务

心跳调度

Gateway 内置心跳调度，可以定期检查状态。

7.8 Docker 部署

目标

在 Docker 容器中运行 OpenClaw。

Docker Compose

version: '3.8'
services:
  openclaw:
    image: openclaw/openclaw:latest
    ports:
      - "18789:18789"
    volumes:
      - ./config:/root/.openclaw
      - ./workspace:/root/workspace
    environment:
      - OPENCLAW_GATEWAY_TOKEN=your-token
    restart: unless-stopped

启动

docker-compose up -d

高级功能（节点与媒体）常见问题与故障排除