这份说明书基于 OpenClaw 官方文档整理帮助你理解控制面板各个功能模块。版本2026.3.31 侧边栏工具概览工具对应功能用途代理Agents多代理管理多个独立 AI 代理技能Skills安装和管理自定义技能节点Nodes配对的设备管理设置Settings/Configuration系统配置、通道、工具等通信Channels各平台Telegram、Discord、微信等连接配置外观与设置UI/Theme界面外观、身份设置自动Cron/Hooks定时任务和自动化文档Documentation/Help查看帮助文档1. 代理(Agents)功能说明管理 OpenClaw 的多个代理实例。每个代理有独立的工作区、身份、模型配置、工具权限等。核心配置代理列表(agents.list)定义多个代理如main、work、homeid: 代理唯一标识workspace: 工作区路径默认~/.openclaw/workspacemodel: 使用的 LLM 模型identity: 名称、表情、头像等身份信息tools: 工具权限控制sandbox: 沙箱隔离级别多代理路由(bindings)将不同通道/账户路由到不同代理Copy{ agentId: work, match: { channel: telegram, accountId: biz } }使用场景工作/生活分离不同聊天平台用不同代理为家人创建受限代理只读工具、无文件系统访问为不同项目分配独立工作区2. ⚙️技能(Skills)功能说明技能是可插拔的功能模块扩展 OpenClaw 的能力如图像生成、语音、特定领域逻辑等。配置项skills.allowBundled: 允许加载的内置技能列表skills.load.extraDirs: 从额外目录加载自定义技能skills.entries: 启用/禁用特定技能设置 API Key 等示例技能技能用途典型配置sagElevenLabs 语音合成voiceId,apiKeyimage-lab图像生成/编辑Gemini/OpenAI API Keypeekaboo屏幕监控/快照相机配置geminiGoogle Gemini 集成apiKey操作启用技能在skills.entries中添加{ skill-name: { enabled: true } }自定义技能目录将技能文件夹放入~/Projects/agent-scripts/skills并在extraDirs中指定3. 节点(Nodes)功能说明节点指配对的 companion 设备Android、iOS、macOS。通过 OpenClaw 网关远程控制这些设备。相关功能设备配对显示二维码或配对码远程通知 (nodes.notify)远程快照/录屏 (nodes.camera_snap,nodes.screen_record)位置获取 (nodes.location_get)应用唤起 (nodes.invoke)配置在gateway.controlUi中启用在控制面板的设备管理界面。4. ⚙️设置(Settings)这是最复杂的部分提供对所有系统配置的细粒度控制。分为以下大类4.1 通道 (channels)配置 OpenClaw 连接的各种聊天平台Telegram/Discord/Slack/WhatsApp/微信/钉钉等每项包含enabled、认证信息botToken/apiKey、DM 策略dmPolicy、群组白名单、历史记录限制等。常用配置字段字段说明enabled是否启用该通道botToken/token机器人令牌或通过环境变量TELEGRAM_BOT_TOKENdmPolicyDM 接收策略pairing需配对码、allowlist仅白名单、open全部groupPolicy群组策略allowlist默认requireMention群组中是否需要 提及才回复historyLimit历史消息数量限制4.2 代理 (Agents)如上节所述配置多个 AI 代理实例。4.3 工具 (tools)控制代理可使用的工具集。预设配置文件(tools.profile)minimal: 仅session_statuscoding: 文件系统、运行时、会话、图像工具messaging: 消息相关工具full: 无限制精细控制tools.allow/tools.deny白名单/黑名单工具名称支持通配符*tools.elevated: 允许哪些渠道的用户执行需要sudo的命令tools.exec: 配置后台进程执行参数tools.loopDetection: 启用工具循环检测4.4 网关 (gateway)网关自身的运行配置gateway.port: 监听端口默认 18789gateway.bind: 绑定地址loopback/lan/tailnetgateway.auth: 认证方式token/passwordgateway.remote: 远程网关地址用于客户端连接gateway.controlUi: 控制面板启用配置gateway.tls: TLS 加密配置4.5 消息 (messages)消息处理行为responsePrefix: 回复前缀如[Bot]ackReaction: 收到消息后的自动反应如 queue.mode: 消息队列模式collect合并、interrupt中断等inbound.debounceMs: 去抖动时间合并快速连续消息4.6 会话 (session)会话生命周期管理session.scope: 会话分组策略per-sender默认session.reset: 自动重置条件daily每日、idle闲置session.maintenance: 会话存储清理策略保留多久、最大条目数4.7 定时任务 (cron)周期性后台任务cron.enabled: 启用定时器cron.maxConcurrentRuns: 最大并发运行数cron.retry: 失败重试配置cron.failureAlert: 失败告警设置5. 通信(Channels)通信 主要对应channels配置大类。这里集中管理所有消息通道的配置。每个通道都有类似结构Copy{ channels: { telegram: { enabled: true, botToken: ..., dmPolicy: pairing, groups: { *: { requireMention: true } }, historyLimit: 50 }, whatsapp: { ... }, discord: { ... } } }多账户支持现代渠道支持多账户如多个 Telegram 机器人Copy{ channels: { telegram: { accounts: { default: { botToken: token1 }, alerts: { botToken: token2 } } } } }6. 外观与设置(UI Appearance)6.1 UI 外观 (ui)Copy{ ui: { seamColor: #FF4500, // 主题色Talk 模式气泡颜色 assistant: { name: OpenClaw, // 控制面板显示名称 avatar: CB // 表情或图片 } } }6.2 Canvas 主机 (canvasHost)提供可编辑的 HTML/JS 托管环境供 A2UI 使用Copy{ canvasHost: { root: ~/.openclaw/workspace/canvas, liveReload: true } }6.3 发现 (discovery)mDNS/DNS-SD 网络发现配置Copy{ discovery: { mdns: { mode: minimal }, wideArea: { enabled: true } } }7. ⏰自动(Automation)7.1 定时任务 (cron)见上文 4.7 定时任务。7.2 钩子 (hooks)Webhook 接收外部事件如 Gmail 推送并触发代理回复Copy{ hooks: { enabled: true, token: shared-secret, path: /hooks, mappings: [ { match: { path: gmail }, action: agent, agentId: hooks, messageTemplate: From: {{messages[0].from}}... } ] } }7.3 Gmail 集成通过 Google Cloud Pub/Sub 接收新邮件推送Copy{ hooks: { gmail: { account: openclawgmail.com, hookUrl: http://127.0.0.1:18789/hooks/gmail, includeBody: true } } }8. 文档(Documentation)本地文档路径/usr/lib/node_modules/openclaw/docs在线文档https://docs.openclaw.ai控制面板通常提供快速链接到常见配置向导如onboard、doctor常用 CLI 命令Copy# 查看网关状态 openclaw gateway status # 检查配置问题 openclaw doctor # 配置向导第一次设置 openclaw onboard # 应用配置更改自动重启网关 openclaw config apply # 查看实时日志 openclaw logs -f 快速建议初次设置运行openclaw onboard按向导完成网关配置、OAuth/API Key 设置。授权渠道先在settings → channels中启用目标平台如 Telegram填入机器人令牌。多代理若需隔离工作/生活在agents中创建多个代理并用bindings路由。安全非本机访问需设gateway.auth.token/passwordtools.elevated限制 sudo 权限生产环境启用 TLS (gateway.tls)自动化用cron做定时检查如每30分钟检查邮件用hooks接收外部事件Gmail、GitHub webhook 等。 相关文档配置参考全文通道索引多代理指南技能开发定时任务需要更具体的帮助吗告诉我你目前的配置目标比如“想用 Telegram 控制服务器”或“设置每天9点自动检查日程”我可以给出详细步骤。找到了这些是 OpenClaw 控制面板和故障排除的相关文档。让我读取它们来给你准备一份清晰的侧边栏工具说明书。好的我找到了 OpenClaw 控制面板的完整说明书。以下是侧边栏各工具的详细说明 OpenClaw 控制面板侧边栏工具说明书控制面板访问地址 defaults本地http://127.0.0.1:18789/Tailscalehttps://your-magic-dns/自定义路径http://host:port/{basePath}如/openclaw首次连接需要设备配对批准Copyopenclaw devices list # 查看待批准设备 openclaw devices approve id # 批准设备1️⃣代理(Agents)管理多个独立的 AI 代理实例。核心功能代理列表创建多个代理main、work、home 等身份设置每个代理可设置独立名称、表情、头像模型配置指定不同代理使用不同的 LLM工具权限精细控制每个代理可使用哪些工具沙箱隔离可选 Docker/SSH 沙箱限制访问范围典型使用场景工作/生活分离 → 不同 Telegram 账户路由到不同代理家庭成员共享 → 创建只读代理给家人项目隔离 → 每个项目独立工作区和会话2️⃣技能(Skills)可插拔的功能模块扩展系统能力。| 技能 | 用途 | 配置项 ||------|--------||sag| ElevenLabs 语音合成 | voiceId、apiKey ||image-lab| 图像生成/处理 | Gemini/OpenAI Key ||pekaboo| 屏幕监控/快照 | 相机配置 ||gemini| Google Gemini | apiKey |管理操作查看状态列出已安装技能及其启用状态启用/禁用在skills.entries中切换enabled自定义技能目录skills.load.extraDirs添加路径安装新技能通过 npm 或本地路径3️⃣节点(Nodes)管理配对的 companion 设备Android/iOS/macOS。功能设备列表查看在线/离线状态、能力通知nodes.notify发送推送快照nodes.camera_snap获取摄像头画面录屏nodes.screen_record录制屏幕位置nodes.location_get唤起应用nodes.invoke配对流程在控制面板显示二维码手机 App 扫码确认配对请求或通过 CLI 批准4️⃣ ⚙️设置(Settings)最强大的配置中心分多个标签页4.1通道(Channels)配置所有聊天平台Telegram/Discord/Slack/WhatsApp/微信/钉钉每项需填机器人令牌、Webhook、白名单支持多账户如多个 Telegram Bot重要配置enabled启用/禁用通道dmPolicyDM 接收策略pairing需配对码 /allowlist仅白名单groups.*.requireMention群组是否需要提及才回复historyLimit保留多少历史消息4.2代理(Agents)同侧边栏代理页可创建/编辑多代理配置。4.3工具(Tools)控制代理可用的工具集。预设配置文件 (tools.profile)| 预设 | 包含工具 ||----------||minimal| 仅session_status||coding| 文件系统 运行时 会话 图像 ||messaging| 会话工具 消息发送 ||full| 无限制 |精细控制tools.allow/tools.deny白名单/黑名单支持通配符*tools.elevated允许哪些用户使用sudo运行命令tools.exec后台进程配置超时、清理时间tools.loopDetection启用工具循环检测防死循环4.4网关(Gateway)网关自身运行参数| 参数 | 说明 | 推荐值 ||------|--------||gateway.port| 监听端口 | 18789 ||gateway.bind| 绑定地址 |loopback本地或lan局域网 ||gateway.auth.mode| 认证方式 |token默认或password||gateway.auth.token| 共享令牌 | 随机生成 ||gateway.controlUi.enabled| 启用控制面板 |true|安全提醒非 localhost 访问必须设gateway.auth.token/password生产环境启用 TLSgateway.tls.enabled控制面板是管理员界面不要暴露到公网4.5消息(Messages)消息处理行为responsePrefix回复前缀如[Bot]ackReaction自动添加反应如 表示已读queue.mode消息队列模式collect合并连续消息inbound.debounceMs合并快速连续消息的时间窗口4.6会话(Session)会话生命周期管理session.scope会话分组策略默认per-sender每人独立会话session.reset自动重置daily每日 /idle闲置超时session.maintenance会话存储清理保留多久、最大条目数4.7定时任务(Cron)周期性后台任务界面化创建/编辑 cron 任务支持cron语法、随机延迟stagger、Agent/模型覆盖失败重试、告警配置查看运行历史5️⃣通信(Channels)等同于 设置 → 通道。集中管理所有聊天平台的连接状态、登录、配置。每个通道卡片显示连接状态✅ 在线 / ❌ 离线快速启用/禁用开关QR 登录WhatsApp/Telegram 等进入详细配置6️⃣外观与设置(UI Appearance)6.1 UI 主题Copy{ ui: { seamColor: #FF4500, // 主题色 assistant: { name: OpenClaw, // 显示名称 avatar: CB // 表情或图片 } } }6.2 Canvas 主机托管可编辑的 HTML/JS 页面供 A2UI 使用路径~/.openclaw/workspace/canvas6.3 网络发现discovery.mdnsBonjour 发现minimal/fulldiscovery.wideAreaDNS-SD 广域发现7️⃣自动(Automation)7.1 Cron 任务同 设置 → 定时任务。7.2 钩子 (Hooks)Webhook 接收外部事件并触发代理回复Gmail 集成接收新邮件推送自动摘要/回复自定义 webhookPOST /hooks/name→ 触发 agent turn消息模板{{messages[0].subject}}等变量8️⃣文档(Documentation)本地文档目录/usr/lib/node_modules/openclaw/docs在线文档https://docs.openclaw.ai控制面板内嵌快速链接到常用配置页面 快速入门建议首次运行执行openclaw onboard按向导完成初始配置授权渠道TelegramBotFather获取 tokenDiscordDeveloper Portal 创建 BotWhatsApp扫码登录多代理如需隔离在 代理 页创建新代理安全加固修改默认网关 tokenopenclaw configure --section gateway限制工具权限tools.deny: [browser, canvas]等自动化用 自动 页设置定时检查邮件、天气等 常用故障排除Copy# 查看网关状态 openclaw gateway status # 检查所有通道状态 openclaw channels status --probe # 查看实时日志 openclaw logs --follow # 自动修复配置问题 openclaw doctor # 重新打开控制面板 openclaw dashboard如果看到device identity required确保使用 HTTPSTailscale Serve或 localhost或在非安全上下文启用gateway.controlUi.allowInsecureAuth: true仅本地测试需要针对某个工具如 Telegram 配置、多代理路由、技能开发的详细指南吗我可以提供具体配置示例。完美我已经整合了所有相关文档给你一份完整的 OpenClaw 控制面板侧边栏工具说明书。 OpenClaw 控制面板完整说明书 访问控制面板场景地址说明本地http://127.0.0.1:18789/最简单无需额外配置Tailscalehttps://magic-dns/推荐远程访问自动 HTTPS带前缀http://host:port/openclaw配置gateway.controlUi.basePathSSH 隧道ssh -L 18789:127.0.0.1:18789 userhost安全远程访问首次连接需设备配对批准Copyopenclaw devices list # 查看待批准请求 openclaw devices approve id # 批准设备 侧边栏八大工具详解1️⃣代理(Agents) → 多 AI 实例管理作用创建多个独立 AI 代理各有自己的工作区、身份、模型、权限。核心配置代理列表(agents.list[])定义id、workspace、model、identity多代理路由(bindings[])将不同渠道/账户路由到特定代理工具权限tools.allow/tools.deny精细控制沙箱sandbox.mode设置隔离级别off/non-main/all典型场景工作/生活分离Telegram 工作号 →work代理个人号 →main代理家庭共享创建只读代理给家人项目隔离每个项目独立 workspace2️⃣技能(Skills) → 功能插件作用扩展系统能力语音、图像、特殊功能。技能管理技能用途配置sagElevenLabs 语音合成voiceId、apiKeyimage-lab图像生成/编辑Gemini/OpenAI API Keypeekaboo屏幕监控相机配置geminiGoogle Gemini 集成apiKey操作在控制面板查看技能状态、启用/禁用添加自定义技能目录skills.load.extraDirs: [~/skills]安装新技能通过 npm 或本地路径3️⃣节点(Nodes) → 移动设备管理作用管理配对的 Android/iOS/macOS companion 设备。功能设备列表在线状态、能力发送通知nodes.notify摄像头快照nodes.camera_snap屏幕录制nodes.screen_record位置获取nodes.location_get应用唤起nodes.invoke配对流程控制面板显示二维码手机 App 扫码确认配对请求或 CLI 批准4️⃣设置(Settings) → 系统配置中心4.1 通道 (Channels)配置所有聊天平台Telegram、Discord、Slack、WhatsApp、微信等。通用配置enabled: 启用/禁用botToken/token: 机器人令牌dmPolicy: DM 策略pairing需配对码 /allowlist仅白名单groupPolicy: 群组策略默认allowlisthistoryLimit: 保留历史消息数量多账户支持Copy{ channels: { telegram: { accounts: { default: { botToken: token1 }, alerts: { botToken: token2 } } } } }4.2 代理 (Agents)同侧边栏代理页可创建/编辑多代理配置。4.3 工具 (Tools)控制代理可使用的工具。预设配置(tools.profile)预设包含工具minimal仅session_statuscoding文件系统 运行时 会话 图像messaging消息相关工具full无限制精细控制tools.allow/tools.deny工具白名单/黑名单支持*通配符tools.elevated允许哪些用户执行sudo命令tools.exec后台进程参数超时、清理时间tools.loopDetection启用死循环检测默认关闭4.4 网关 (Gateway)网关自身运行参数参数说明推荐值gateway.port监听端口18789gateway.bind绑定地址loopback仅本机或lan局域网gateway.auth.mode认证方式token默认或passwordgateway.auth.token共享令牌随机生成 32 位gateway.controlUi.enabled启用控制面板true安全建议非 localhost 访问必须设gateway.auth.token/password生产环境启用 TLSgateway.tls.enabled控制面板是管理员界面不要暴露到公网4.5 消息 (Messages)消息处理行为responsePrefix: 回复前缀如[Bot]ackReaction: 自动添加反应如 表示已读queue.mode: 消息队列模式collect合并连续消息inbound.debounceMs: 合并快速连续消息的时间窗口4.6 会话 (Session)会话生命周期session.scope: 会话分组默认per-sender每人独立会话session.reset: 自动重置条件daily每日 /idle闲置session.maintenance: 存储清理策略4.7 定时任务 (Cron)周期性后台任务界面化创建/编辑 cron支持 cron 语法、随机延迟stagger、Agent/模型覆盖失败重试、告警配置查看运行历史5️⃣通信(Channels)等同于 设置 → 通道。集中查看所有渠道状态快速启用/禁用、QR 登录、进入详细配置。6️⃣外观与设置(UI Appearance)6.1 UI 主题Copy{ ui: { seamColor: #FF4500, // 主题色 assistant: { name: OpenClaw, // 显示名称 avatar: CB // 表情或图片 } } }6.2 Canvas 主机托管可编辑的 HTML/JS 页面A2UI 用路径~/.openclaw/workspace/canvas6.3 网络发现discovery.mdns: Bonjour 发现模式minimal/fulldiscovery.wideArea: DNS-SD 广域发现需 CoreDNS Tailscale7️⃣自动(Automation)7.1 Cron 任务同 设置 → 定时任务。7.2 钩子 (Hooks)Webhook 接收外部事件并触发代理Gmail 集成接收新邮件推送自动摘要/回复自定义 webhookPOST /hooks/name→ 触发 agent turn消息模板使用{{messages[0].subject}}等变量8️⃣文档(Documentation)本地文档目录/usr/lib/node_modules/openclaw/docs在线文档https://docs.openclaw.ai控制面板内嵌快速链接 快速入门步骤运行向导Copyopenclaw onboard按提示完成网关、认证、渠道配置。授权渠道TelegramBotFather 创建机器人获取 tokenDiscordDeveloper Portal 创建 Bot 获取 tokenWhatsApp扫码登录微信使用插件或自建方案多代理可选如需隔离在代理页创建新代理并配置路由安全加固修改默认网关 tokenopenclaw configure --section gateway限制工具权限tools.deny: [browser, canvas]限制 IP 访问防火墙自动化可选在自动页设置定时任务如每日邮件检查️ 常用 CLI 命令Copy# 查看网关状态 openclaw status openclaw gateway status # 检查所有通道 openclaw channels status --probe # 实时日志 openclaw logs --follow # 自动修复配置 openclaw doctor # 重新打开控制面板 openclaw dashboard # 查看配对请求 openclaw devices list # 批准设备 openclaw devices approve requestId # 应用配置更改 openclaw config apply # 查看/设置网关 token openclaw config get gateway.auth.token openclaw config set gateway.auth.token new-token❓ 常见问题控制面板无法连接确认网关运行openclaw gateway status本地访问http://127.0.0.1:18789/查看日志openclaw logs --follow看到 device identity required使用 HTTPSTailscale Serve或 localhost或设置gateway.controlUi.allowInsecureAuth: true仅本地测试不要在生产环境禁用设备认证消息不回复检查通道状态openclaw channels status --probe检查 DM 配对openclaw pairing list --channel channel检查群组提及设置requireMention是否为true想远程访问但不想用 Tailscale方案1SSH 隧道ssh -L 18789:127.0.0.1:18789 userhost方案2配置 Nginx 反向代理 TLS需gateway.tls或外部 TLS 终止