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

本页常见问题

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