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 指令配置openclaw agentsaddwork openclaw agentsaddcoding openclaw agentsaddalerts openclaw agentsaddwriter2.2 以writer为例1.通过配置指令添加智能体agents OpenClaw2026.3.24(cff6dc9)— Built by lobsters,forhumans. Dont 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) gpu3090DESKTOP-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:5308: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:5408:00 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes 11:22:5408:00 [plugins] feishu_chat: Registered feishu_chat tool 11:22:5408:00 [plugins] feishu_wiki: Registered feishu_wiki tool 11:22:5408:00 [plugins] feishu_drive: Registered feishu_drive tool 11:22:5408: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:5508:00 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes 11:22:5508:00 [plugins] feishu_chat: Registered feishu_chat tool 11:22:5508:00 [plugins] feishu_wiki: Registered feishu_wiki tool 11:22:5508:00 [plugins] feishu_drive: Registered feishu_drive tool 11:22:5508:00 [plugins] feishu_bitable: Registered bitable tools 11:22:5508:00 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes 11:22:5508:00 [plugins] feishu_chat: Registered feishu_chat tool 11:22:5508:00 [plugins] feishu_wiki: Registered feishu_wiki tool 11:22:5508:00 [plugins] feishu_drive: Registered feishu_drive tool 11:22:5508: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:5508:00 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes 11:22:5508:00 [plugins] feishu_chat: Registered feishu_chat tool 11:22:5508:00 [plugins] feishu_wiki: Registered feishu_wiki tool 11:22:5508:00 [plugins] feishu_drive: Registered feishu_drive tool 11:22:5508: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 pluginiddetected;global plugin │ │ will be overridden by bundled plugin │ │(/home/gpu3090/.openclaw/extensions/feishu/index.ts)│ │ │ ├────────────────────────────────────────────────────────────────────────────────────────╯ Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate pluginiddetected;global plugin will be overridden by bundled plugin(/home/gpu3090/.openclaw/extensions/feishu/index.ts)11:22:5508: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:5508:00[plugins]feishu_doc: Registered feishu_doc, feishu_app_scopes11:22:5508:00[plugins]feishu_chat: Registered feishu_chat tool11:22:5508:00[plugins]feishu_wiki: Registered feishu_wiki tool11:22:5508:00[plugins]feishu_drive: Registered feishu_drive tool11:22:5508:00[plugins]feishu_bitable: Registered bitable tools ┌ Add OpenClaw agent │ ◇ Workspace directory │ /home/gpu3090/.openclaw/workspace-writer │ ◇ Copy auth profiles frommain? │ Yes │ ◇ Auth profiles ─────────────────────╮ │ │ │ Copied auth profiles frommain.│ │ │ ├─────────────────────────────────────╯ │ ◇ Configure model/authforthis agent now? │ Yes Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate pluginiddetected;global plugin will be overridden by bundled plugin(/home/gpu3090/.openclaw/extensions/feishu/index.ts)11:24:1408: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:1408:00[plugins]feishu_doc: Registered feishu_doc, feishu_app_scopes11:24:1408:00[plugins]feishu_chat: Registered feishu_chat tool11:24:1408:00[plugins]feishu_wiki: Registered feishu_wiki tool11:24:1408:00[plugins]feishu_drive: Registered feishu_drive tool11:24:1408:00[plugins]feishu_bitable: Registered bitable tools │ ◇ Model/auth provider │ Ollama Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate pluginiddetected;global plugin will be overridden by bundled plugin(/home/gpu3090/.openclaw/extensions/feishu/index.ts)11:24:2308: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:2308:00[plugins]feishu_doc: Registered feishu_doc, feishu_app_scopes11:24:2308:00[plugins]feishu_chat: Registered feishu_chat tool11:24:2308:00[plugins]feishu_wiki: Registered feishu_wiki tool11:24:2308:00[plugins]feishu_drive: Registered feishu_drive tool11:24:2308: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 pluginiddetected;global plugin will be overridden by bundled plugin(/home/gpu3090/.openclaw/extensions/feishu/index.ts)11:24:2708:00[plugins]feishu_doc: Registered feishu_doc, feishu_app_scopes11:24:2708:00[plugins]feishu_chat: Registered feishu_chat tool11:24:2708:00[plugins]feishu_wiki: Registered feishu_wiki tool11:24:2708:00[plugins]feishu_drive: Registered feishu_drive tool11:24:2708:00[plugins]feishu_bitable: Registered bitable tools11:24:2808:00[plugins]feishu_doc: Registered feishu_doc, feishu_app_scopes11:24:2808:00[plugins]feishu_chat: Registered feishu_chat tool11:24:2808:00[plugins]feishu_wiki: Registered feishu_wiki tool11:24:2808:00[plugins]feishu_drive: Registered feishu_drive tool11:24:2808:00[plugins]feishu_bitable: Registered bitable tools Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate pluginiddetected;global plugin will be overridden by bundled plugin(/home/gpu3090/.openclaw/extensions/feishu/index.ts)11:24:2808:00[plugins]feishu_doc: Registered feishu_doc, feishu_app_scopes11:24:2808:00[plugins]feishu_chat: Registered feishu_chat tool11:24:2808:00[plugins]feishu_wiki: Registered feishu_wiki tool11:24:2808:00[plugins]feishu_drive: Registered feishu_drive tool11:24:2808:00[plugins]feishu_bitable: Registered bitable tools11:24:2808:00[plugins]feishu_doc: Registered feishu_doc, feishu_app_scopes11:24:2808:00[plugins]feishu_chat: Registered feishu_chat tool11:24:2808:00[plugins]feishu_wiki: Registered feishu_wiki tool11:24:2808:00[plugins]feishu_drive: Registered feishu_drive tool11:24:2808: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 approvechannelcode│ │ Public DMs requiredmPolicyopenallowFrom[*]. │ │ Multi-user DMs: run: openclaw configsetsession.dmScopeper-channel-peer(or │ │per-account-channel-peerformulti-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;moresetup(David Reagans:Hop on Discord.). │ │ iMessage: this is still a workinprogress. │ │ 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;installthe plugin to enable. │ │ Nextcloud Talk: Self-hosted chat via Nextcloud Talk webhook bots. │ │ Matrix:openprotocol;installthe 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;installthe plugin to enable. │ │ Twitch: Twitch chat integration │ │ │ ├───────────────────────────────────────────────────────────────────────────────────────────╯ │ ◇ Select a channel │ Feishu/Lark(飞书)│ ◇ Feishu already configured. Whatdoyou want to do? │ Skip(leave as-is)│ ◇ Select a channel │ Finished Config warnings: - plugins.entries.feishu: plugin feishu: duplicate pluginiddetected;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 │ └ Agentwriterready.2.确认配置写入openclaw.json{ id: writer, name: writer, workspace: /home/gpu3090/.openclaw/workspace-writer, agentDir: /home/gpu3090/.openclaw/agents/writer/agent, }, 已经写入agents配置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配置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配置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. 整体配置参考{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,},},},}