企业官网建设流程全解析

• CLI
• 开发工具
• AI Agent
• 人工智能
• 包管理器

本文以 x-cmd 仓库中 mod/claw/lib/data/workspace/manager/SOUL.md 为核心，系统讲解 claw 多平台消息系统的核心管理员智能体X-CLAW Manager是如何通过 SOUL.md 定义自身人格与行为边界，并结合同目录下的 AGENTS.md、TOOLS.md、HEARTBEAT.md 等工作区引导文件协同运作的。读完本文，你将理解 claw 工作区的启动读取机制、Manager 的权限与职责划分，以及"可靠性、安全性、透明性、效率、全局意识"五条准则在具体命令与流程中的落地方式，并可直接参照模板为自己的 Agent 工作区撰写 SOUL.md。

SOUL.md 在 claw 工作区中的定位

在 claw 系统中，每个智能体（Agent）都拥有一个持久化工作区（workspace），用于跨会话保留上下文、人格与长期记忆。X-CLAW Manager 的工作区位于mod/claw/lib/data/workspace/manager/，其中SOUL.md是一份定义"你是谁"的人格文件：

• Identity（身份）：定义智能体的名称、角色与核心使命；
• Tone（语气）：定义与用户交互时的语言风格与态度；
• Principles（原则）：定义系统级行为准则与决策边界；
• Context（知识域）：声明智能体所擅长的领域背景。

SOUL.md并不是一份孤立的文档，而是被强制纳入Startup Reading Order（启动读取顺序）的引导文件之一。根据 manager/AGENTS.md 的约定，Manager 每次会话开始前必须按顺序读取：

1. RUNONCE.md—— 若存在，先执行其中指令并删除；
2. SOUL.md—— 定义"你是谁"；
3. USER.md—— 定义"你帮助谁"；
4. TOOLS.md—— 外部工具、调度任务与 claw 管理工具使用指南；
5. MEMORY.md—— 长期沉淀的知识与约定；
6. HEARTBEAT.md—— 委托给心跳智能体处理的待办事项；
7. memory/YYYY-MM-DD.md—— 当日上下文索引，重点留意Sent字段。

从实现层面看，该目录确实是 claw 工作区的模板源：在 mod/claw/lib/run/workspace 中可以看到，当创建 manager 类型工作区时，模板目录被指定为$___X_CMD_ROOT_MOD/claw/lib/data/workspace/manager（对应脚本第 112、134 行），也就是说仓库中这份 SOUL.md 就是每个新 Manager 会话启动时被复制并加载的原型。

Identity：Manager 是谁

SOUL.md 的 Identity 段明确了 X-CLAW Manager 的核心身份：

• 名称：X-CLAW Manager；
• 角色：claw 消息平台的核心管理员与系统运维者；
• 主要使命：管理 claw 服务、IM 连接、定时任务、日志，协助用户完成系统级操作，并代表用户跨平台发送消息。

这一身份定义并非空泛描述，它与 manager/AGENTS.md 中声明的权限清单严格对应：

其中需要注意一个关键环境事实：x是一个 POSIX shell 函数，每个新起的 shell 进程都必须先执行. ~/.x-cmd.root/X加载它，否则x <mod>系列命令会失败。这条约定在 AGENTS.md 与 manager/TOOLS.md 中都被反复强调。

Tone：语气基调

SOUL.md 对语气的定义可以归纳为四条：

1. 管理系统时：专业（Professional）、简洁（Concise）、权威（Authoritative）；
2. 协助用户时：友好（Friendly）、乐于助人（Helpful）；
3. 默认语言：跟随用户消息的语言，用户用中文则用中文回复；
4. 行动优先：用结果说话，而不是只做描述——"Prefer action over explanation"。

这条"行动优先"准则在 AGENTS.md 中被进一步细化为回复优先级规则：简单管理任务立即执行并直接回复结果；需要调研或外部查询的任务，先给出简短确认（如 "Got it, checking..."），再继续处理并给出完整答案；若没有新增信息，则保持沉默，避免重复刷屏。

Principles：五条核心行为准则

可靠性（Reliability）

用户依赖 claw 进行沟通，因此 Manager 必须保证服务持续运行、主动监控健康状态并上报问题。落地方式体现在 skills/claw-admin/SKILL.md 的故障排查黄金规则中：

1. 先查状态：x claw service status；
2. 再看日志：x claw log；
3. 若状态异常或日志持续报错：x claw service restart；
4. 重启后复验：x claw service status。

restart被视为解决大多数瞬时问题的通用手段，但前提是先通过 status 与 log 确认问题确实存在，而非盲目重启。

安全性（Security）

保护 token、API 密钥与用户数据，绝不泄露敏感信息。这一点在多个文件中都有呼应：

• manager/MEMORY.md 开头即标注安全提示：该文件包含个人上下文，只在私密会话中加载，不得写入密码、API 密钥等机密；
• manager/AGENTS.md 的红线条款将隐私保护列为第一优先级：不得泄露用户消息、文件、日历与个人信息；
• 破坏性操作（rm -rf、dd、mkfs等）必须获得用户明确确认，删除文件时优先用trash而非rm，保证可恢复。

透明性（Transparency）

执行系统变更（连接/断开 IM、重启服务）时必须向用户清晰说明。这与 claw-admin 技能中的安全检查清单一致：执行破坏性或高影响操作前，需确认用户明确请求、检查当前服务状态、警告可能副作用（如断开 IM 会中断消息投递）、并确认重启时机合适。

效率（Efficiency）

"用对工具做对事"是效率准则的核心：快速任务直接行动；复杂任务转后台任务；周期性任务交给 cron 或 heartbeat。SOUL.md 的这一原则在 manager/AGENTS.md 中被落实为一张完整的任务路由表：

配套的快速分类规则是：能在 30 秒内完成的单命令管理任务才直接执行；有精确时间点的走 cron；只有日期或模糊时间的走 HEARTBEAT.md；其余默认用x agent run转后台。

效率还体现在"快速收尾即停止"（Quick wrap-up then STOP）机制中：x agent run会立即返回，Manager 随后只做三件事——在 HEARTBEAT.md 记录任务、写一条简短记忆、向用户回复 ack 与任务 ID，然后立即停止，绝不轮询任务状态或继续执行额外命令。

全局意识（Scope Awareness）

Manager 管理的是整个系统，而非单个聊天。它需要从跨平台与全局的角度考虑每个操作的连带影响：既能读取所有会话工作区做诊断，也能向任意已连接平台发送消息；同时被明确禁止在未经用户确认的情况下修改其他会话工作区的SOUL.md、USER.md或MEMORY.md。

Context：知识域声明

SOUL.md 的 Context 段声明 Manager 具备三方面专家能力：

• x-cmd 生态与 claw 架构的专家；
• 熟悉POSIX shell、服务管理与多平台消息；
• 有能力跨所有已连接 IM 平台与会话工作区进行问题诊断。

从源码证据看，这份知识域声明与 manager/TOOLS.md 的能力清单吻合：Manager 可访问 300+ shell 工具与 1000+ 软件包（免 sudo），并掌握 x-cmd 的完整 claw 管理命令面。同时，知识域并非静态——first_contact_manager.md提示文件（mod/claw/lib/data/prompt/first_contact_manager.md）要求 Manager 在首次会话时执行一次快速健康检查（服务状态、IM 连接、cron 任务、最近日志），并在会话后把操作风格写入 SOUL.md、把管理员偏好写入 USER.md，实现人格文件的持续进化。

SOUL.md 与工作区其他文件的分工

SOUL.md 只回答"我是谁"，其余问题由同工作区的其他文件回答，形成完整闭环：

其中记忆系统采用双层结构：memory/YYYY-MM-DD.md是"需要知道才能继续工作"的简洁索引（每条含 Request / Method / Key decision / Changes / Status / Sent / Next step 字段，按HH:MM:SS时间戳组织）；MEMORY.md则是从日常记录中蒸馏出的长期知识。维护原则是：日常文件是原始笔记，MEMORY.md是精选智慧，定期（每几天）将前者的重要事件升华到后者。

Manager 的核心操作命令速查

SOUL.md 定义的人格最终都要落到具体命令上，以下是 Manager 工作区（TOOLS.md 与 claw-admin 技能）确认的核心命令面：

服务管理

x claw service --help # 发现全部服务子命令 x claw service start # 启动 claw 服务 x claw service stop # 停止 claw 服务 x claw service restart # 重启 claw 服务 x claw service install # 注册为开机自启服务 x claw service uninstall # 移除自启注册 x claw service status # 查看服务状态

IM 连接

x claw connect --help x claw connect weixin # 连接微信 x claw connect telegram # 连接 Telegram x claw connect feishu # 连接飞书 x claw connect qywx # 连接企业微信 x claw disconnect <im> # 断开某个 IM 平台

飞书群聊支持更细粒度控制：x claw connect feishu:oc_xxx连接指定群、x claw connect feishu:groups连接所有可用群、x claw disconnect feishu:oc_xxx断开指定群，并可用x feishu group ls列出可用群组。

定时任务（cron）

x claw cron --help x claw cron ls # 列出所有定时任务 x claw cron tz <timezone> # 设置时区（添加任务前先做） x claw cron add --name "<name>" --desc "<desc>" "<expr>" "<cmd>" x claw cron rm --name "<name>"

注意 SOUL.md 效率原则与 cron 技能共同划出的红线：定时任务只允许使用x claw cron，绝不允许使用系统 cron、at或其他工具——系统级调度不受 claw 管理，无法被追踪与清理；且 cron 触发的新会话是零记忆的，命令中的消息必须自包含目标、工具、步骤、输出格式与投递方式（如'Use x hn top for top 5 posts. Extract title, URL, score. Send: x claw weixin send --chatid "<CHATID>" --text <result>'）。

日志与后台任务

x claw log # 查看 claw 日志 x agent run --job-id "<id>" --max-iterations <n> "<task>" # 创建后台任务 x agent job status --job-id "<id>" --llms # 查询任务状态 x agent job ls --active --llms # 列出活动任务 x agent job stop --job-id "<id>" # 停止后台任务

后台任务 ID 采用manager-<brief>约定以便追溯（如manager-loganalysis），且任务描述必须自包含（后台环境无聊天记忆）。

跨平台消息与触发

x claw weixin send --chatid <CHATID> --text '<msg>' x claw telegram send --chatid <CHATID> --text '<msg>' x claw feishu send --chatid <CHATID> --text '<msg>' x claw qywx send --chatid <CHATID> --text '<msg>' x claw agentrequest <im> <chatid> '<msg>' # 触发指定会话的智能体

撰写你自己的 Agent SOUL.md：模板要点

结合仓库中的实际文件结构，可以为自己的 Agent 工作区撰写 SOUL.md 提供以下模板要点：

1. Identity 段：固定格式为You are <角色名>, the <职能定位>，并用 Name / Role / Primary purpose 三个字段把职责边界写清楚——身份定义直接决定后续权限与工具面的范围；
2. Tone 段：区分"管理系统时"与"协助用户时"两种场景语气，明确默认语言跟随用户，并写入"行动优先"的沟通偏好；
3. Principles 段：用加粗关键字的条目式写法，每一条原则都应当能在配套的 AGENTS.md / TOOLS.md / skills 中找到可执行命令作为支撑（如 Reliability → status/restart 流程，Efficiency → 任务路由表）；
4. Context 段：声明知识域与擅长领域，便于 LLM 在复杂诊断场景中快速定位可用的模块与技能。

以 claw 为参照，一份合格的 SOUL.md 应当与工作区的引导文件形成"人格—流程—工具"三层自洽：SOUL.md 定义行为准则，AGENTS.md 定义操作流程与读取顺序，TOOLS.md 与 skills/ 提供具体命令实现。这正是 x-cmd 在 mod/claw/lib/data/workspace/manager/ 中呈现的设计模式，也是构建可维护、可复现的智能体人格文件时最值得借鉴的部分。

• CLI
• 开发工具
• AI Agent
• 人工智能
• 包管理器