人工智能AI Agent即时通讯后端本地部署语音【免费下载链接】openclaw-cn中文社区版OpenClaw同原版保持定期更新已内置钉钉、企业微信、飞书、QQ、微信以及国内网络环境优化。你的专属个人AI助手。支持所有操作系统和平台。项目地址https://gitcode.com/gh_mirrors/op/openclaw-cn点击查看免费下载本文是 OpenClaw 中文社区版 CLI 中agents命令族list/add/delete/set-identity的完整技术指南。它解决的是一台设备上运行多个相互隔离的 AI 智能体这一核心场景每个智能体拥有独立的工作区Workspace、独立的模型认证与独立的路由绑定。读完本文你将掌握如何用命令行创建、查看、删除隔离智能体以及如何通过IDENTITY.md或直接传参为智能体设置名称、主题、表情与头像并了解这些操作在配置文件中落地的完整原理。agents是 OpenClaw 中文社区版 CLI 中专门管理隔离智能体的命令组。与单智能体的 agent 命令 不同agents面向的是多智能体部署场景每个智能体是工作区workspace 认证auth 路由routing三位一体的隔离单元。底层实现可参考 CLI 注册代码 与命令实现目录 src/commands/agents.ts。命令总览agents命令族由四个子命令组成全部注册于 register.agent.ts子命令作用关键选项agents list列出已配置的智能体及其工作区、路由、模型--json、--bindingsagents add [name]添加新的隔离智能体--workspace、--model、--agent-dir、--bind、--non-interactive、--jsonagents set-identity更新智能体身份名称/主题/表情/头像--agent、--workspace、--identity-file、--from-identity、--name、--theme、--emoji、--avataragents delete id删除智能体并清理工作区/状态--force、--json说明中文社区版的可执行名称为openclaw-cn以下示例统一使用该命令名与上游clawdbot命令等价。快速示例openclaw-cn agents list openclaw-cn agents add work --workspace ~/clawd-work openclaw-cn agents set-identity --workspace ~/clawd --from-identity openclaw-cn agents set-identity --agent main --avatar avatars/clawd.png openclaw-cn agents delete work不带任何子命令直接执行openclaw-cn agents时默认等价于openclaw-cn agents list见 register.agent.ts。agents list查看已配置的智能体agents list输出每个智能体的 ID、身份来源标注为IDENTITY.md或config、工作区、状态目录、模型以及路由规则openclaw-cn agents list openclaw-cn agents list --bindings # 展开完整的路由绑定明细 openclaw-cn agents list --json # 输出 JSON 摘要便于脚本解析从 agents.commands.list.ts 的实现可以看到默认视图会按智能体逐个输出id (name)、Identity 行表情 名称 来源、Workspace、Agent dir、Model、Routing 摘要、Providers 列表--bindings会把cfg.bindings中归属于该智能体的每一条路由绑定逐条展开describeBinding路由摘要有显式绑定则列出具体路由默认智能体若无显式规则会标记为default (no explicit rules)输出末尾会提示渠道状态反映的是本地配置/凭据如需实时健康检查请运行openclaw-cn channels status --probe。agents add创建隔离智能体agents add是创建智能体的入口同时支持交互式向导与非交互式两种模式。交互式模式默认直接运行openclaw-cn agents add会进入 Clack 交互向导底层由 clack-prompter 驱动核心流程见 agents.commands.add.ts依次引导你完成Agent 名称输入名称并自动规范化 IDnormalizeAgentId若 ID 已存在会询问是否更新工作区目录默认建议~/.openclaw/workspace/agent-id可改为任意路径认证配置询问是否立即为智能体配置模型/认证若选择是则进入认证选择可复制默认智能体的 auth profiles渠道绑定可交互选择渠道并为该智能体创建路由绑定绑定冲突时给出跳过提示。交互向导在写配置前会校验模型配置是否异常warnIfModelConfigLooksOff并在结束后自动执行ensureWorkspaceAndSessions初始化工作区与会话目录。非交互式模式适合脚本化创建必须显式提供--workspaceopenclaw-cn agents add work \ --workspace ~/clawd-work \ --model claude-sonnet-4-5 \ --agent-dir ~/.openclaw/agents/work \ --bind telegram \ --non-interactive --json参数说明定义见 register.agent.ts--workspace dir新智能体的工作区目录非交互模式下为必填项--model id为该智能体指定的模型 ID--agent-dir dir状态目录auth profiles、会话等不指定时默认为resolveAgentDir(cfg, agentId)推导的路径--bind channel[:accountId]路由渠道绑定可重复传入多次实现多绑定如--bind telegram --bind slack:workspace2--non-interactive跳过所有提示此时必须提供--workspace与名称--json输出 JSON 摘要含bindings.added/skipped/conflicts。从源码可以确认以下边界行为agents.commands.add.ts名称main被保留DEFAULT_AGENT_ID不可用于新智能体非交互模式下缺少--workspace或名称时会直接报错退出绑定的渠道若已被其他智能体占用会进入conflicts列表并跳过不会静默覆盖。工作区自动初始化无论哪种模式命令最终都会调用ensureWorkspaceAndSessions。工作区是一系列 Markdown 文件的集合各文件常量定义于 src/agents/workspace.ts文件用途AGENTS.md智能体能力与行为约定SOUL.md核心人格/灵魂设定IDENTITY.md身份记录见下文TOOLS.md/USER.md/MEMORY.md/BOOTSTRAP.md等工具、用户信息、记忆与引导数据模板文件位于 docs/reference/templates例如 IDENTITY.md 模板 与 IDENTITY.dev.md。agents set-identity设置智能体身份set-identity是身份管理的核心命令将字段写入配置的agents.list[].identityname身份名称theme主题如 space lobsteremoji签名表情avatar头像支持工作区相对路径、http(s) URL或data URI三种形式从 IDENTITY.md 加载openclaw-cn agents set-identity --workspace ~/clawd --from-identity--from-identity会从工作区根目录读取IDENTITY.md也可用--identity-file显式指定文件路径。IDENTITY.md位于每个智能体工作区的根目录例如~/clawwork/IDENTITY.md头像路径相对于工作区根目录解析。显式传参覆盖openclaw-cn agents set-identity --agent main --name Clawd --emoji --avatar avatars/clawd.png参数解析细节set-identity的完整选项与行为agents.commands.identity.ts智能体定位可用--agent id直接指定也可只给--workspace dir命令会在配置中查找工作区匹配的智能体——若多个智能体共享同一工作区则会报错要求你用--agent明确指定此场景有专门测试覆盖见 agents.identity.test.ts--from-identity/ 无显式字段只要没有提供任何--name/--emoji/--theme/--avatar命令会自动尝试从工作区或--identity-file读取ID 规范化所有输入 ID 都会经过normalizeAgentId规范化--identity-file与--workspace路径支持~展开resolveUserPath字段合并语义新身份是原 identity 本次变更的浅合并{...base.identity, ...incomingIdentity}未传入的字段保持不变新增场景若目标智能体 ID 尚不存在于配置命令会直接追加一个新条目空列表且非默认 ID 时还会先补入默认智能体条目。IDENTITY.md 的解析规则IDENTITY.md是一份极简的键: 值 Markdown 文件解析逻辑位于 src/agents/identity-file.ts- Name: Clawd - Creature: helpful sloth - Vibe: sharp but warm - Emoji: - Avatar: avatars/clawd.png解析器支持- label: value列表形式标签为name、emoji、creature、vibe、theme、avatarcreature/vibe会归并到theme。同时它内置了占位符过滤模板中*(pick something you like)*、*(AI? robot? ...)*等占位说明会被识别并忽略避免把提示文本误当身份写入见 identity-file.ts。文件为空或全占位时视为无身份数据命令会报错退出。官方模板 IDENTITY.md 的注释还提醒这不是元数据而是智能体自我认知的起点建议在首次对话时填写头像优先使用工作区相对路径如avatars/clawd.png。agents delete删除智能体openclaw-cn agents delete work # 交互式确认后删除 openclaw-cn agents delete work --force # 跳过确认 openclaw-cn agents delete work --json # JSON 摘要delete的语义agents.commands.delete.ts比移除配置条目更彻底保留 ID 检查main默认智能体不可删除确认机制非--force且 stdin 非 TTY 时会要求显式加--forceTTY 下弹出确认框配置清理pruneAgentConfig移除智能体条目及其相关绑定removedBindings与允许规则removedAllow文件清理将工作区、状态目录、会话转录目录一并移入系统废纸篓moveToTrash而非直接rm为误删保留了恢复余地。配置落点agents.list[].identityset-identity、add、delete最终都会改写同一个配置文件writeConfigFile。身份字段写入后的配置结构JSON5 风格如下{ agents: { list: [ { id: main, identity: { name: Clawd, theme: space lobster, emoji: , avatar: avatars/clawd.png } }, { id: work, workspace: ~/clawd-work, model: claude-sonnet-4-5, identity: { name: WorkBot, emoji: } } ] } }要点agents.list[]是智能体的权威清单identity只是其中的一个子对象add还会写入workspace、agentDir、model等字段并可能扩展bindings路由表list命令读取同一份配置生成摘要身份来源会标注为IDENTITY.md文件存在时或config关联阅读多智能体路由绑定如何把渠道/账号/会话映射到具体智能体、智能体工作区工作区内各 Markdown 文件的职责。总结一条命令打通创建—塑形—观察—回收OpenClaw 中文社区版的agents命令族把多智能体管理收敛为四个子命令形成完整生命周期创建agents add交互向导或--non-interactive脚本化自动初始化工作区塑形agents set-identity--from-identity读IDENTITY.md或--name/--emoji/--theme/--avatar直接覆盖写入agents.list[].identity观察agents list --bindings --json查看工作区、路由、模型与身份的一站式快照回收agents delete默认移入废纸篓--force跳过确认。所有操作都围绕工作区 认证 路由三要素展开最终统一落到agents.list[]配置结构中配合 IDENTITY.md 模板 和 multi-agent 路由文档即可在一台设备上稳定运行多个各司其职、互不干扰的专属 AI 智能体。赞分享人工智能AI Agent即时通讯后端本地部署语音【免费下载链接】openclaw-cn中文社区版OpenClaw同原版保持定期更新已内置钉钉、企业微信、飞书、QQ、微信以及国内网络环境优化。你的专属个人AI助手。支持所有操作系统和平台。项目地址https://gitcode.com/gh_mirrors/op/openclaw-cn点击查看免费下载相关推荐OpenClaw 多智能体管理实战openclaw agents 命令全解roles、teams、workspaces、routing 与身份OpenClaw 多智能体管理实战 openclaw agents 命令全解roles、teams、workspaces、routing 与身份 本指南系AI 应用AI Agent交互助手后端即时通讯网关Gas Town Reference 全解多智能体工作区管理器的配置、路由与环境体系Gas Town Reference 全解多智能体工作区管理器的配置、路由与环境体系 Gas Town gt 是一个多智能体multi agent工作人工智能AI AgentAgent 编排代码智能体CLIOpenClaw 会话管理详解消息路由、DM 隔离与完整会话生命周期OpenClaw 会话管理详解消息路由、DM 隔离与完整会话生命周期 OpenClaw 将每一条入站消息按来源私聊、群聊、定时任务、Webhook 等路由AI 应用AI Agent交互助手后端即时通讯网关上一篇突破TypeORM性能瓶颈原生SQL查询优化实战指南下一篇零成本进阶AI职场2025生成式AI免费认证实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考