1.理论知识
1. 1 Agent（智能体）
一个 Agent 是一个完全独立作用域的"大脑"，拥有自己的三大核心要素：
从学术界和工程界的共识来看，一个生产级的通用 Agent 由以下 几大核心要素构成：
1.2 模型
LLM 是 Agent 的认知引擎，负责语言理解、推理规划和生成输出。它决定了 Agent 的 "智力天花板"。
1.3 记忆
记忆系统让 Agent 从 "无状态的函数" 变成 "可连续工作的助手"。记忆通常分为短期记忆（会话上下文）和长期记忆（跨会话知识持久化）。
1.4 人设
定义 Agent 的角色、边界、行为准则和沟通风格，回答同一个问题，一个被设定为「严谨的技术顾问」的 Agent 和一个被设定为「友善的助手」的 Agent，给你的体验完全不同。
1.5 工具
Agent 可以调用的外部能力，如代码执行、API 调用、浏览器操控、文件读写。
1.6 规划和执行
规划能力使 Agent 能够将复杂任务拆解为可执行的步骤序列，在一些确定的任务场景下，也可以为 Agent 设定固定的工作流程。
1.7 运行环境
Agent 需要一个安全、隔离的执行环境。
1.8 agentId（智能体唯一标识）
每个 Agent 都有一个唯一的 agentId，它是标识一个 "大脑" 的关键。在单 Agent 模式下，agentId 默认为 main。在多 Agent 模式下，你可以自定义 agentId，如 home、work、writer、coder 等。
1.9 accountId（渠道账号实例）
accountId 是渠道层面的账号标识，用于区分同一渠道的不同登录账户。例如在飞书中，你可能有一个 personal-bot 和一个 work-bot，分别对应不同的 Bot 账号。每个 accountId 可以路由到不同的 Agent，让一台服务器托管多个渠道账号而不混淆会话。
1.10 Binding（路由绑定）
Binding 是连接入站消息和目标 Agent 的桥梁。它通过匹配 channel（渠道）、accountId（账号）、peer（对等方，即具体的联系人或群组）将消息精准路由到指定的 agentId。这是多 Agent 架构中最核心的分发机制。
1.11 核心概念关系
2. 配置实践
2.1 指令配置
bash
openclaw agents add work
openclaw agents add coding
openclaw agents add alerts
openclaw agents add writer2.2 以writer为例
1.通过配置指令添加智能体agents
bash
🦞 OpenClaw 2026.3.24 (cff6dc9) --- Built by lobsters, for humans. Don't question the hierarchy.
│
◇ Config warnings ──────────────────────────────────────────────────────────────────────╮
│ │
│ - plugins.entries.feishu: plugin feishu: duplicate plugin id detected; global plugin │
│ will be overridden by bundled plugin │
│ (/home/gpu3090/.openclaw/extensions/feishu/index.ts) │
│ │
├────────────────────────────────────────────────────────────────────────────────────────╯
Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; global plugin will be overridden by bundled plugin (/home/gpu3090/.openclaw/extensions/feishu/index.ts)
Restarted systemd service: openclaw-gateway.service
(base) gpu3090@DESKTOP-8IU6393:~/.openclaw$ openclaw agents add writer
Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; global plugin will be overridden by bundled plugin (/home/gpu3090/.openclaw/extensions/feishu/index.ts)
11:22:53+08:00 [plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: feishu (/home/gpu3090/.openclaw/extensions/feishu/index.ts). Set plugins.allow to explicit trusted ids.
Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; global plugin will be overridden by bundled plugin (/home/gpu3090/.openclaw/extensions/feishu/index.ts)
11:22:54+08:00 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
11:22:54+08:00 [plugins] feishu_chat: Registered feishu_chat tool
11:22:54+08:00 [plugins] feishu_wiki: Registered feishu_wiki tool
11:22:54+08:00 [plugins] feishu_drive: Registered feishu_drive tool
11:22:54+08:00 [plugins] feishu_bitable: Registered bitable tools
Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; global plugin will be overridden by bundled plugin (/home/gpu3090/.openclaw/extensions/feishu/index.ts)
11:22:55+08:00 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
11:22:55+08:00 [plugins] feishu_chat: Registered feishu_chat tool
11:22:55+08:00 [plugins] feishu_wiki: Registered feishu_wiki tool
11:22:55+08:00 [plugins] feishu_drive: Registered feishu_drive tool
11:22:55+08:00 [plugins] feishu_bitable: Registered bitable tools
11:22:55+08:00 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
11:22:55+08:00 [plugins] feishu_chat: Registered feishu_chat tool
11:22:55+08:00 [plugins] feishu_wiki: Registered feishu_wiki tool
11:22:55+08:00 [plugins] feishu_drive: Registered feishu_drive tool
11:22:55+08:00 [plugins] feishu_bitable: Registered bitable tools
Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; global plugin will be overridden by bundled plugin (/home/gpu3090/.openclaw/extensions/feishu/index.ts)
11:22:55+08:00 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
11:22:55+08:00 [plugins] feishu_chat: Registered feishu_chat tool
11:22:55+08:00 [plugins] feishu_wiki: Registered feishu_wiki tool
11:22:55+08:00 [plugins] feishu_drive: Registered feishu_drive tool
11:22:55+08:00 [plugins] feishu_bitable: Registered bitable tools
Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; global plugin will be overridden by bundled plugin (/home/gpu3090/.openclaw/extensions/feishu/index.ts)
🦞 OpenClaw 2026.3.24 (cff6dc9) --- Somewhere between 'hello world' and 'oh god what have I built.'
│
◇ Config warnings ──────────────────────────────────────────────────────────────────────╮
│ │
│ - plugins.entries.feishu: plugin feishu: duplicate plugin id detected; global plugin │
│ will be overridden by bundled plugin │
│ (/home/gpu3090/.openclaw/extensions/feishu/index.ts) │
│ │
├────────────────────────────────────────────────────────────────────────────────────────╯
Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; global plugin will be overridden by bundled plugin (/home/gpu3090/.openclaw/extensions/feishu/index.ts)
11:22:55+08:00 [plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: feishu (/home/gpu3090/.openclaw/extensions/feishu/index.ts). Set plugins.allow to explicit trusted ids.
11:22:55+08:00 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
11:22:55+08:00 [plugins] feishu_chat: Registered feishu_chat tool
11:22:55+08:00 [plugins] feishu_wiki: Registered feishu_wiki tool
11:22:55+08:00 [plugins] feishu_drive: Registered feishu_drive tool
11:22:55+08:00 [plugins] feishu_bitable: Registered bitable tools
┌ Add OpenClaw agent
│
◇ Workspace directory
│ /home/gpu3090/.openclaw/workspace-writer
│
◇ Copy auth profiles from "main"?
│ Yes
│
◇ Auth profiles ─────────────────────╮
│ │
│ Copied auth profiles from "main". │
│ │
├─────────────────────────────────────╯
│
◇ Configure model/auth for this agent now?
│ Yes
Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; global plugin will be overridden by bundled plugin (/home/gpu3090/.openclaw/extensions/feishu/index.ts)
11:24:14+08:00 [plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: feishu (/home/gpu3090/.openclaw/extensions/feishu/index.ts). Set plugins.allow to explicit trusted ids.
11:24:14+08:00 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
11:24:14+08:00 [plugins] feishu_chat: Registered feishu_chat tool
11:24:14+08:00 [plugins] feishu_wiki: Registered feishu_wiki tool
11:24:14+08:00 [plugins] feishu_drive: Registered feishu_drive tool
11:24:14+08:00 [plugins] feishu_bitable: Registered bitable tools
│
◇ Model/auth provider
│ Ollama
Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; global plugin will be overridden by bundled plugin (/home/gpu3090/.openclaw/extensions/feishu/index.ts)
11:24:23+08:00 [plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: feishu (/home/gpu3090/.openclaw/extensions/feishu/index.ts). Set plugins.allow to explicit trusted ids.
11:24:23+08:00 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
11:24:23+08:00 [plugins] feishu_chat: Registered feishu_chat tool
11:24:23+08:00 [plugins] feishu_wiki: Registered feishu_wiki tool
11:24:23+08:00 [plugins] feishu_drive: Registered feishu_drive tool
11:24:23+08:00 [plugins] feishu_bitable: Registered bitable tools
│
◇ Ollama base URL
│ http://127.0.0.1:11434
│
◇ Ollama mode
│ Local
Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; global plugin will be overridden by bundled plugin (/home/gpu3090/.openclaw/extensions/feishu/index.ts)
11:24:27+08:00 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
11:24:27+08:00 [plugins] feishu_chat: Registered feishu_chat tool
11:24:27+08:00 [plugins] feishu_wiki: Registered feishu_wiki tool
11:24:27+08:00 [plugins] feishu_drive: Registered feishu_drive tool
11:24:27+08:00 [plugins] feishu_bitable: Registered bitable tools
11:24:28+08:00 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
11:24:28+08:00 [plugins] feishu_chat: Registered feishu_chat tool
11:24:28+08:00 [plugins] feishu_wiki: Registered feishu_wiki tool
11:24:28+08:00 [plugins] feishu_drive: Registered feishu_drive tool
11:24:28+08:00 [plugins] feishu_bitable: Registered bitable tools
Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; global plugin will be overridden by bundled plugin (/home/gpu3090/.openclaw/extensions/feishu/index.ts)
11:24:28+08:00 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
11:24:28+08:00 [plugins] feishu_chat: Registered feishu_chat tool
11:24:28+08:00 [plugins] feishu_wiki: Registered feishu_wiki tool
11:24:28+08:00 [plugins] feishu_drive: Registered feishu_drive tool
11:24:28+08:00 [plugins] feishu_bitable: Registered bitable tools
11:24:28+08:00 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
11:24:28+08:00 [plugins] feishu_chat: Registered feishu_chat tool
11:24:28+08:00 [plugins] feishu_wiki: Registered feishu_wiki tool
11:24:28+08:00 [plugins] feishu_drive: Registered feishu_drive tool
11:24:28+08:00 [plugins] feishu_bitable: Registered bitable tools
│
◇ Channel status ───────────────────────────────╮
│ │
│ Feishu: configured (connection not verified) │
│ Telegram: not configured │
│ WhatsApp: not configured │
│ Discord: not configured │
│ IRC: not configured │
│ Google Chat: not configured │
│ Slack: not configured │
│ Signal: not configured │
│ iMessage: not configured │
│ LINE: not configured │
│ Google Chat: installed │
│ Nostr: installed │
│ Microsoft Teams: installed │
│ Mattermost: installed │
│ Nextcloud Talk: installed │
│ Matrix: installed │
│ BlueBubbles: installed │
│ LINE: installed │
│ Zalo: installed │
│ Zalo Personal: installed │
│ Synology Chat: installed │
│ Tlon: installed │
│ Discord: installed │
│ iMessage: installed │
│ IRC: installed │
│ Signal: installed │
│ Slack: installed │
│ Telegram: installed │
│ Twitch: installed │
│ WhatsApp: installed │
│ │
├────────────────────────────────────────────────╯
│
◇ Configure chat channels now?
│ Yes
│
◇ How channels work ───────────────────────────────────────────────────────────────────────╮
│ │
│ DM security: default is pairing; unknown DMs get a pairing code. │
│ Approve with: openclaw pairing approve <channel> <code> │
│ Public DMs require dmPolicy="open" + allowFrom=["*"]. │
│ Multi-user DMs: run: openclaw config set session.dmScope "per-channel-peer" (or │
│ "per-account-channel-peer" for multi-account channels) to isolate sessions. │
│ Docs: channels/pairing │
│ │
│ Telegram: simplest way to get started --- register a bot with @BotFather and get going. │
│ WhatsApp: works with your own number; recommend a separate phone + eSIM. │
│ Discord: very well supported right now. │
│ IRC: classic IRC networks with DM/channel routing and pairing controls. │
│ Google Chat: Google Workspace Chat app with HTTP webhook. │
│ Slack: supported (Socket Mode). │
│ Signal: signal-cli linked device; more setup (David Reagans: "Hop on Discord."). │
│ iMessage: this is still a work in progress. │
│ LINE: LINE Messaging API webhook bot. │
│ Feishu: 飞书/Lark enterprise messaging. │
│ Nostr: Decentralized protocol; encrypted DMs via NIP-04. │
│ Microsoft Teams: Teams SDK; enterprise support. │
│ Mattermost: self-hosted Slack-style chat; install the plugin to enable. │
│ Nextcloud Talk: Self-hosted chat via Nextcloud Talk webhook bots. │
│ Matrix: open protocol; install the plugin to enable. │
│ BlueBubbles: iMessage via the BlueBubbles mac app + REST API. │
│ Zalo: Vietnam-focused messaging platform with Bot API. │
│ Zalo Personal: Zalo personal account via QR code login. │
│ Synology Chat: Connect your Synology NAS Chat to OpenClaw with full agent capabilities. │
│ Tlon: decentralized messaging on Urbit; install the plugin to enable. │
│ Twitch: Twitch chat integration │
│ │
├───────────────────────────────────────────────────────────────────────────────────────────╯
│
◇ Select a channel
│ Feishu/Lark (飞书)
│
◇ Feishu already configured. What do you want to do?
│ Skip (leave as-is)
│
◇ Select a channel
│ Finished
Config warnings:
- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; global plugin will be overridden by bundled plugin (/home/gpu3090/.openclaw/extensions/feishu/index.ts)
Config overwrite: /home/gpu3090/.openclaw/openclaw.json (sha256 fd11a578bb7c86cd8566df4cb3cdb2c492f54477aa1a262b578ab08ba81cf1b8 -> ef56a2c080f7d427789907c4f1f4e8379b954c3aa993a9b2b55143e195446852, backup=/home/gpu3090/.openclaw/openclaw.json.bak)
Updated ~/.openclaw/openclaw.json
Workspace OK: ~/.openclaw/workspace-writer
Sessions OK: ~/.openclaw/agents/writer/sessions
│
└ Agent "writer" ready.2.确认配置写入openclaw.json
{
id: 'writer',
name: 'writer',
workspace: '/home/gpu3090/.openclaw/workspace-writer',
agentDir: '/home/gpu3090/.openclaw/agents/writer/agent',
},
已经写入agents配置
bash
agents: {
defaults: {
model: {
primary: 'ollama/gpt-oss:20b',
},
models: {
'ollama/gpt-oss:20b': {},
},
workspace: '/home/gpu3090/.openclaw/workspace',
},
list: [
{
id: 'main',
},
{
id: 'dev',
name: 'dev',
workspace: '/home/gpu3090/.openclaw/workspace-dev',
agentDir: '/home/gpu3090/.openclaw/agents/img/agent',
identity: {
name: '开发助手',
},
},
{
id: 'coding',
name: 'coding',
workspace: '/home/gpu3090/.openclaw/workspace-coding',
agentDir: '/home/gpu3090/.openclaw/agents/coding/agent',
},
{
id: 'alerts',
name: 'alerts',
workspace: '/home/gpu3090/.openclaw/workspace-alerts',
agentDir: '/home/gpu3090/.openclaw/agents/alerts/agent',
},
{
id: 'work',
name: 'work',
workspace: '/home/gpu3090/.openclaw/workspace-work',
agentDir: '/home/gpu3090/.openclaw/agents/work/agent',
},
{
id: 'writer',
name: 'writer',
workspace: '/home/gpu3090/.openclaw/workspace-writer',
agentDir: '/home/gpu3090/.openclaw/agents/writer/agent',
},
],
},3.添加bindings配置
{
agentId: 'writer',
match: {
channel: 'feishu',
accountId: 'feishu-writer',
},
},
写入bindings配置
bash
bindings: [
{
agentId: 'main',
match: {
channel: 'feishu',
accountId: 'main',
},
},
{
agentId: 'work',
match: {
channel: 'feishu',
accountId: 'feishu-work',
},
},
{
agentId: 'writer',
match: {
channel: 'feishu',
accountId: 'feishu-writer',
},
},
],4.添加channels的飞书数据
注意 appSecret: 'OPENCLAW_REDACTED',这里__OPENCLAW_REDACTED__要填写实际的字符串
'feishu-work': {
appId: 'cli_a9303e54a678dbc2',
appSecret: '__OPENCLAW_REDACTED__',
botName: '工作助手',
groupAllowFrom: [
'ou_620d372bdc5b000b98b5f6213670d976',
],
},
写入channels配置
bash
channels: {
feishu: {
enabled: true,
domain: 'feishu',
accounts: {
main: {
appId: 'cli_a9172c074e619cd3',
appSecret: '__OPENCLAW_REDACTED__',
botName: '主助手',
groupAllowFrom: [
'ou_620d372bdc5b000b98b5f6213670d976',
],
},
'feishu-work': {
appId: 'cli_a9303e54a678dbc2',
appSecret: '__OPENCLAW_REDACTED__',
botName: '工作助手',
groupAllowFrom: [
'ou_620d372bdc5b000b98b5f6213670d976',
],
},
default: {
groupPolicy: 'allowlist',
dmPolicy: 'pairing',
},
'feishu-writer': {
appId: 'cli_a93157510938dcc4',
appSecret: '__OPENCLAW_REDACTED__',
botName: '写作助手',
groupAllowFrom: [
'ou_620d372bdc5b000b98b5f6213670d976',
],
},
},
},
},5.飞书测试通过
你好
你好！很高兴和你聊天。有什么我可以帮忙的，或者你想聊聊什么？
你的工作目录
当前工作目录是
/home/gpu3090/.openclaw/workspace-writer
（所有文件操作都在这里进行）。如果需要查看或编辑文件，随时告诉我！3. 整体配置参考
bash
{
meta: {
lastTouchedVersion: '2026.3.24',
lastTouchedAt: '2026-03-27T04:08:54.049Z',
},
wizard: {
lastRunAt: '2026-03-26T14:41:54.220Z',
lastRunVersion: '2026.3.24',
lastRunCommand: 'configure',
lastRunMode: 'local',
},
auth: {
profiles: {
'ollama:default': {
provider: 'ollama',
mode: 'api_key',
},
},
},
models: {
mode: 'merge',
providers: {
ollama: {
baseUrl: 'http://127.0.0.1:11434',
apiKey: '__OPENCLAW_REDACTED__',
api: 'ollama',
models: [
{
id: 'glm-4.7-flash',
name: 'glm-4.7-flash',
reasoning: false,
input: [
'text',
],
cost: {
input: 0,
output: 0,
cacheRead: 0,
cacheWrite: 0,
},
contextWindow: 128000,
maxTokens: 8192,
},
{
id: 'gpt-oss:20b',
name: 'gpt-oss:20b',
reasoning: false,
input: [
'text',
],
cost: {
input: 0,
output: 0,
cacheRead: 0,
cacheWrite: 0,
},
contextWindow: 131072,
maxTokens: 8192,
},
],
},
},
},
agents: {
defaults: {
model: {
primary: 'ollama/gpt-oss:20b',
},
models: {
'ollama/gpt-oss:20b': {},
},
workspace: '/home/gpu3090/.openclaw/workspace',
},
list: [
{
id: 'main',
},
{
id: 'dev',
name: 'dev',
workspace: '/home/gpu3090/.openclaw/workspace-dev',
agentDir: '/home/gpu3090/.openclaw/agents/img/agent',
identity: {
name: '开发助手',
},
},
{
id: 'coding',
name: 'coding',
workspace: '/home/gpu3090/.openclaw/workspace-coding',
agentDir: '/home/gpu3090/.openclaw/agents/coding/agent',
},
{
id: 'alerts',
name: 'alerts',
workspace: '/home/gpu3090/.openclaw/workspace-alerts',
agentDir: '/home/gpu3090/.openclaw/agents/alerts/agent',
},
{
id: 'work',
name: 'work',
workspace: '/home/gpu3090/.openclaw/workspace-work',
agentDir: '/home/gpu3090/.openclaw/agents/work/agent',
},
{
id: 'writer',
name: 'writer',
workspace: '/home/gpu3090/.openclaw/workspace-writer',
agentDir: '/home/gpu3090/.openclaw/agents/writer/agent',
},
],
},
tools: {
profile: 'coding',
web: {
search: {
enabled: true,
provider: 'duckduckgo',
},
},
},
bindings: [
{
agentId: 'main',
match: {
channel: 'feishu',
accountId: 'main',
},
},
{
agentId: 'work',
match: {
channel: 'feishu',
accountId: 'feishu-work',
},
},
{
agentId: 'writer',
match: {
channel: 'feishu',
accountId: 'feishu-writer',
},
},
],
commands: {
native: 'auto',
nativeSkills: 'auto',
restart: true,
ownerDisplay: 'raw',
},
session: {
dmScope: 'per-channel-peer',
},
channels: {
feishu: {
enabled: true,
domain: 'feishu',
accounts: {
main: {
appId: 'cli_a9172c074e619cd3',
appSecret: '__OPENCLAW_REDACTED__',
botName: '主助手',
groupAllowFrom: [
'ou_620d372bdc5b000b98b5f6213670d976',
],
},
'feishu-work': {
appId: 'cli_a9303e54a678dbc2',
appSecret: '__OPENCLAW_REDACTED__',
botName: '工作助手',
groupAllowFrom: [
'ou_620d372bdc5b000b98b5f6213670d976',
],
},
default: {
groupPolicy: 'allowlist',
dmPolicy: 'pairing',
},
'feishu-writer': {
appId: 'cli_a93157510938dcc4',
appSecret: '__OPENCLAW_REDACTED__',
botName: '写作助手',
groupAllowFrom: [
'ou_620d372bdc5b000b98b5f6213670d976',
],
},
},
},
},
gateway: {
port: 18789,
mode: 'local',
bind: 'loopback',
auth: {
mode: 'token',
token: '__OPENCLAW_REDACTED__',
},
tailscale: {
mode: 'off',
resetOnExit: false,
},
nodes: {
denyCommands: [
'camera.snap',
'camera.clip',
'screen.record',
'contacts.add',
'calendar.add',
'reminders.add',
'sms.send',
],
},
},
skills: {
entries: {
'feishu-doc': {
enabled: true,
},
},
},
plugins: {
entries: {
duckduckgo: {
enabled: true,
},
feishu: {
enabled: true,
},
},
},
}