代理系统

OpenClaw 使用独特的架构，其中代理是通过集中式网关控制平面运行的自主 AI 助手。本指南解释了 OpenClaw 中代理的工作原理。

什么是 OpenClaw 代理？

OpenClaw 代理是一个 AI 助手，它：

通过网关运行（WebSocket 控制平面，地址为 ws://127.0.0.1:18789）
可以通过多个渠道通信（WhatsApp、Telegram、Slack、Discord 等）
使用技能执行任务（定义为 SKILL.md 文件）
跨会话维护对话上下文
可以配置不同的思考级别和行为

架构概览

通信渠道 (WhatsApp/Telegram/Slack...)
    ↓
┌─────────────────────────┐
│   网关（控制平面）       │
│  ws://127.0.0.1:18789   │
└───────────┬─────────────┘
            │
    ├─ Pi 代理 (RPC)
    ├─ CLI (openclaw)
    ├─ WebChat UI
    ├─ macOS 应用
    └─ iOS/Android 节点

网关管理：

会话 - 对话状态和上下文
渠道 - 通信平台连接
工具 - 技能和能力
事件 - 系统事件和通知
路由 - 多代理路由到隔离实��

启动代理

启动网关

首先，启动网关控制平面：

openclaw gateway --port 18789 --verbose

通过 CLI 交互

向您的代理发送消息：

# 单条消息
openclaw agent --message "今天天气怎么样？" --thinking high

# 交互式聊天
openclaw chat

通过渠道交互

连接渠道（WhatsApp、Telegram 等）后，通过这些平台发送消息，您的代理将会响应。

代理配置

通过编辑 OpenClaw 配置文件来配置您的代理：

openclaw config edit

关键配置选项：

{
  "agent": {
    "model": "claude-sonnet-4-6",
    "temperature": 0.7,
    "maxTokens": 4096,
    "systemPrompt": "你是一个乐于助人的 AI 助手...",
    "thinkingLevel": "medium"
  },
  "dmPolicy": "pairing",
  "whitelist": []
}

配置选项

model: 使用的 Claude 模型（例如 "claude-sonnet-4-6"、"claude-opus-4-6"）
temperature: 响应创造性（0.0-1.0）
maxTokens: 最大响应长度
systemPrompt: 代理的指令
thinkingLevel: 默认思考级别（off|minimal|low|medium|high|xhigh）
dmPolicy: 私信策略（"pairing" 或 "open"）
whitelist: 允许的联系人（使用 "*" 表示开放访问）

思考级别

OpenClaw 代理支持不同的思考级别，控制它们推理的深度：

# 为消息设置思考级别
openclaw agent --message "解决这个问题" --thinking high

# 在聊天中，使用 /think 命令
/think xhigh
解释量子计算

思考级别：

off - 无扩展思考
minimal - 非常简短的思考
low - 轻度推理
medium - 平衡思考（默认）
high - 深度推理
xhigh - 最大推理深度

多代理路由

OpenClaw 支持将不同渠道或账户路由到隔离的代理实例：

{
  "routing": {
    "whatsapp:+1234567890": "agent-personal",
    "slack:#work": "agent-work",
    "telegram:@username": "agent-research"
  }
}

每个代理实例可以有自己的：

配置
系统提示
技能
记忆/上下文

代理命令

通过渠道聊天时，使用这些命令：

/status - 查看会话状态
/new 或 /reset - 开始新对话
/think <级别> - 设置思考级别
/verbose on|off - 切换详细模式

示例：

/think high
/verbose on
帮我调试这段代码

安全：配对模式

默认情况下，代理使用配对模式以确保安全。未知发送者会收到配对码：

# 批准配对
openclaw pairing approve whatsapp ABC123

# 列出待处理的请求
openclaw pairing list

# 拒绝配对
openclaw pairing reject whatsapp XYZ789

对于开放访问（不推荐用于生产环境）：

{
  "dmPolicy": "open",
  "whitelist": ["*"]
}

语音交互

OpenClaw 在支持的平台上支持语音交互：

macOS/iOS

语音唤醒词支持
Siri 集成

Android

连续语音模式
语音命令

配置语音设置：

{
  "voice": {
    "enabled": true,
    "wakeWord": "嘿 Claw",
    "language": "zh-CN"
  }
}

Canvas 模式

Canvas 是一个代理驱动的可视化工作区，用于复杂任务：

openclaw canvas open

Canvas 功能：

可视化任务分解
A2UI（代理到 UI）交互
实时协作
多步骤工作流

浏览器控制

代理可以通过 CDP（Chrome DevTools Protocol）控制 Chrome/Chromium 浏览器：

# 启用浏览器控制
openclaw config set browser.enabled true

# 代理现在可以控制浏览器
openclaw agent --message "打开 GitHub 并搜索 OpenClaw"

最佳实践

使用适当的思考级别：复杂任务使用更高级别，简单查询使用较低级别
配置系统提示：根据您的需求定制代理行为
启用配对模式：防止未经授权的访问
使用多代理路由：分离工作、个人和研究上下文
监控网关日志：使用 --verbose 标志进行调试

下一步

了解技能系统以及如何扩展代理能力
配置通信渠道
探索高级配置
设置语音交互