TOPIC / RESOURCE

OpenClaw 术语表:先把 Agent、Skill、Workspace 这些词读顺

很多上手困难不是因为不会操作,而是因为 Agent、Skill、Workspace、Binding 这些核心术语没对齐。这页把最常出现的关键词逐个讲清楚并配合实际场景说明,方便你在阅读配置文档和案例教程时不迷路,也减少因术语误解导致的配置错误和沟通成本。

适合谁

  • 看配置、案例和路由时总觉得术语没对齐
  • 想先把 Agent、Skill、Workspace、Binding 这些词读顺
  • 准备继续看模型、方案或案例页

核心概念

Agent

一个独立工作单元。
它通常有自己的工作区、会话和行为规则。

Skill

让 Agent 拥有某类具体执行能力的单元。
没有 Skill,很多时候它只能"理解",但很难真正"动手"。
通过 openclaw skills install @clawhub/xxx 从 ClawHub 安装。

Workspace

长期规则和工作文件所在的位置。
很多初始化、长期记忆和工作标准都会沉淀在这里。

Binding

把某个入站消息或渠道入口路由到某个 Agent 的规则。
它回答的是"这条消息该归谁处理"。

Fallback

当主模型失败、不可用或不合适时,用来兜底的次选模型策略。

Router

主动决定不同任务该去哪个模型的策略。
它不是简单兜底,而是有意识地分配。

Gateway

消息和请求进入 OpenClaw 的入口层。
很多认证、接入和重启相关动作都和它有关。
通过 openclaw gateway status 检查状态,openclaw gateway restart 重启。

Pairing

把 OpenClaw 和某个聊天渠道、平台或机器人绑定起来的过程。
常见于飞书、钉钉、Telegram 等场景。

平台与架构术语

Channel

消息进入和发出的渠道端。
OpenClaw 支持 12 个渠道:WhatsApp、Telegram、Discord、Slack、飞书、钉钉、Signal、iMessage、Microsoft Teams、Google Chat、Matrix、WebChat。
通过 openclaw channels add 向导接入。

Plugin

为特定渠道或平台提供深度集成能力的官方扩展包。
比如 @openclaw/feishu 就是飞书官方插件,支持消息、文档、多维表格、日历和任务。
通过 openclaw plugins install 安装。

ClawHub

OpenClaw 的官方技能市场,目前有 5,700+ 社区技能。
带 verified badge 的技能经过官方审核。
通过 openclaw skills install @clawhub/xxx 安装,openclaw skills list 查看已安装技能。

Sandbox

OpenClaw 三层安全模型的第二层:工具沙盒过滤器。
限制 Agent 可以调用的系统资源,支持设置 CPU/内存上限、只读挂载、敏感目录屏蔽。
第一层是 Docker 网络隔离,第三层是 Agent 工具权限。

Control UI / Dashboard

OpenClaw 的本地管理面板,默认地址 http://127.0.0.1:18789/
通过 openclaw dashboard 打开。
生产环境建议关闭或限制访问。

DM Pairing

通过私聊消息完成渠道绑定的方式。
适合不想暴露公网 Webhook 的场景,配合 Gateway 认证使用更安全。

配置与文件术语

AGENTS.md

放在 Workspace 根目录的行为规则文件。
定义 Agent 的身份、角色和工作标准,类似系统提示的持久化版本。

SOUL.md

定义 Agent 长期人格和回复风格的文件。
AGENTS.md 搭配使用,侧重"你是谁"而不是"你做什么"。

Gateway Auth

Gateway 层的认证方式。
通过 openclaw config set gateway.auth.mode token 设置为 token 模式,防止未授权请求进入。

Security Audit

OpenClaw 内置的安全审计工具。
openclaw security audit --deep 执行深度扫描,--fix 自动修复已知问题。

最常见的误解

  • 把 Agent 当成 Skill
  • 把 Workspace 当成普通文件夹
  • 把 Fallback 当成 Router
  • 把 Pairing 当成"已经完全配置好了"
  • 把 Channel 当成 Plugin(Channel 是渠道端,Plugin 是深度集成包)
  • 把 Sandbox 当成 Docker(Sandbox 是工具过滤层,Docker 是网络隔离层)

下一步建议

如果你已经把词对齐了,再去看:

相关链接

FAQ

本页常见问题

因为很多配置和案例看起来难,不是因为概念太深,而是因为关键词没有先对齐。