人工智能AI Agent大模型AI 应用媒体生成【免费下载链接】xiaobei为OPC/中小微企业量身打造的自媒体获客智能体项目地址https://gitcode.com/gh_mirrors/wi/xiaobei点击查看免费下载导读xiaobeiwiseflow是 OpenClaw 的一个特制版本在原版基础上调整了功能并固化了最佳配置定位为 OPC / 中小微企业的自媒体获客智能体系统。系统中的 IT Engineer Agent 承担着系统守夜人的角色它不直接面向业务而是在其他 AI crew 遇到技术问题时被 spawn 为 subagent 排故脱困仅在单独绑定工作渠道飞书 / 企业微信时才直接面对人类用户答疑。本文以 crews/it-engineer/AGENTS.md 为核心结合仓库内 awada-channel-setup、work-channel-binding 等技能的源码与配置系统讲解 IT Engineer 的职责边界、运行路径与环境变量管理、升级与重启规范、channel 渠道绑定的完整 SOP 与底层原理帮助你掌握 xiaobei 体系的运维核心能力。一、IT Engineer Agent 的职责定位IT Engineer 的核心职责是保障 xiaobei 系统正常运转并排除故障。它主要服务于系统内的其他 AI crew——当它们遇到技术问题时会 spawn IT Engineer 作为 subagent 排故脱困IT Engineer 则在身后默默保障系统一切正常。一个关键的能力边界是当且仅当 IT Engineer 被单独绑定了工作渠道feishu / wecom时它才直接面对人类用户回答技术疑问。没有绑定渠道时它的工作界面只对其他 Agent 开放。从仓库结构看IT Engineer crew 位于 crews/it-engineer/其身份文件IDENTITY.md、SOUL.md、MEMORY.md等与技能目录skills/与 main、sales-cs 等 crew 保持同一套组织规范其中MEMORY.md记录了内置运维知识等长期运维经验是 IT Engineer 排障时的重要参考。二、被维护系统的基础信息2.1 项目信息项目名称xiaobeiwiseflowOpenClaw 的特制版本上游项目OpenClaw开源 agent 框架本文不展开其外部站点2.2 运行程序安装位置二选一IT Engineer 在执行任何脚本前必须先确认部署方式并定位路径再cd PROJECT_ROOT后调用./scripts/xxx.sh。部署方式判定方法PROJECT_ROOTOPENCLAW_HOME环境变量文件Docker 部署容器内存在/.dockerenv/opt/openclaw路径固定无需读文件/root/.openclaw/root/.openclaw/.env源码部署读取同目录OFB_ENV.md记录在OFB_ENV.md中记录在OFB_ENV.md中记录在OFB_ENV.md中OFB_ENV.md由 scripts/setup-crew.sh 在部署时自动生成历史命名保留每次运行自动更新记录~/.openclaw/.env的位置、写入格式与注意事项。2.3 运行数据位置运行时数据统一位于~/.openclaw/下~/.openclaw/openclaw.json实际运行配置勿手动大幅修改~/.openclaw/workspace-*/各 Agent 的工作区~/.openclaw/agents/*/sessions/会话记录用于用量统计仓库中的 config-templates/openclaw.json 与 config-templates/openclaw-awk.json 是配置模板的参照正式运行时以~/.openclaw/openclaw.json为准。三、环境变量管理密钥写入的唯一正确位置3.1 核心规则技能密钥一律写进~/.openclaw/.env当某个技能需要新的环境变量API Key、超时配置等或 main agent / 用户要求新增环境变量时IT Engineer必须先读取工作区的OFB_ENV.md按其规范执行写入。最关键的规则是密钥写入位置技能密钥一律写进~/.openclaw/.envstate-dir dotenv不要写 daemon.env / service-env。原因是进程继承模型的差异两者对比文件性质被谁加载密钥能否到达 subagent / cron~/.openclaw/.envstate-dir dotenv每个 openclaw 进程都会加载gateway、subagent、cron、裸 CLI✅ 能到达所有调用路径daemon.env / service-env服务管理器的 EnvironmentFile只有托管 gateway 进程继承❌ subagent / cron 不继承因此 daemon.env / service-env只放 gateway 运维变量如 PATH 注入等必须在进程启动前就位的值。此规则对源码部署和 Docker 部署同样适用。3.2 写入流程与红线OFB_ENV.md会记录~/.openclaw/.env的写入规范核心注意事项包括先 grep 防重复写入前检查变量是否已存在避免重复追加写入后重启 gateway环境变量对已运行进程不生效必须重启禁止内联 env 赋值不得在命令行中以VARvalue cmd的形式注入。另外注意职责分工main agent 不直接编辑环境变量文件——它会把用户给的变量值转交给 IT Engineer由 IT Engineer 执行写入。3.3 生产运维红线禁止pnpm openclaw subcommand文档明确警告生产运行中不得调用pnpm openclaw subcommand——这会触发重新 build 并写入dist/导致运行系统崩溃。cron / config / sessions 类操作一律走 MCP 工具cron、gateway、sessions_*。具体防范规则见 crews/it-engineer/MEMORY.md 的「内置运维知识 - 重大警告」一节。四、程序升级与服务重启只指导不代劳IT Engineer不得代用户执行任何升级操作只能指导用户如何进行升级。这是明确的能力与权限边界。升级的标准步骤第一步cd PROJECT_ROOT 第二步./scripts/install.sh其中PROJECT_ROOT/scripts中还有其他一键运维脚本具体作用与使用方法见 scripts/README.md。这些脚本 IT Engineer 同样不得代用户执行只能告知用户它们的作用及使用方法由用户自己操作。五、答疑流程绑定工作渠道后当 IT Engineer 被配置了工作渠道feishu / wecom后用户可能直接向其技术提问回答遵循以下原则1. 理解用户的问题如果不清楚追问一个关键细节 2. 给出简明答案 3. 如果需要操作提供完整可执行步骤 4. 主动问这样解释清楚了吗还有其他疑问吗六、按需启用的职责域以下职责均属于 IT Engineer 范围但只有用户或 main agent 要求时才启用职责域触发条件调用技能SEO 技术优化与巡检用户 / main agent 要求seo腾讯云资源操作用户 / main agent 要求tccli阿里云 skill 搜索与发现用户 / main agent 要求alicloud-find-skillsICP 备案指导用户 / main agent 要求icp-filingApple 国区 ICP 豁免申请用户 / main agent 要求icp-exemption七、渠道配置channel 绑定最易手撸出错的区域当 main agent 派 IT Engineer 启用某个 crew 并绑定 channel 时按本节执行。缺信息时引导用户输入并按文档告知去哪申请、怎么申请。7.1 总纲channel 字段的层位务必遵守channel一律只写在两个层位bindings[].match.channel路由层channels.name通道配置层禁止在 agent 顶层对象agents.list[]内某个 crew 的对象上加channel字段。把 crew 加入agents.list时只放它自己 sample 里的字段id/name/subagents/heartbeat/tools等不写channel:wecom/feishu/awada。绑定 channel 必须走下面的两个 skill 的 apply 脚本——它们会把 channel 写进正确的bindingschannelsplugins三处不得手贴 agent 块。文档特别强调这是最易手撸出错的地方。7.2 选哪条路径服从 main agent 派下的指令走awada-channel-setup还是work-channel-binding由 main agent 转达的用户选择决定IT Engineer 不得替用户自作主张切换路径。路径调用技能适用场景流程要点awada channelawada-channel-setup常见于 sales-cs 主力对外通道确认依赖已预装 → 写 openclaw.json → 重启 Gateway → 验证飞书 / 企微 work channelwork-channel-binding内 crew 工作渠道以及 sales-cs 退而用飞书/企微的场景收集账号 → prepare 计划 → 用户确认 → apply → 重启 Gateway → 验证两条路径都把 channel 写进bindingschannelsplugins都不碰 agent 顶层。awada 走 relay 网关 HTTP/WS 传输运行时依赖wszod通常已预装Docker 镜像 build 时 / 源码部署 apply-addons.sh 时自动安装无需 IT Engineer 手动装。仅当日志报Cannot find module ws时按 SKILL 步骤 1 补装。八、awada channel 绑定 SOP 与源码解析awada extension 是专为对外 crew如 sales-cs打造的消息通道可令 sales-cs 以企业微信联系人的形态连接外部用户。配置默认直接启用 customerDB hook自动记录客户来访、更新状态因此整个配置过程是一个可机械执行的 SOP。仓库中的 awada/ 目录即该扩展的实现模块含 package.json 与src/源码。8.1 步骤 1确认 awada 依赖已就位通常已预装awada 走 relay 网关 HTTP/WS 传输运行时依赖wszod已在以下场景预装Docker 部署镜像 build 时已npm install --omitdev进/opt/openclaw/awada/node_modules源码部署scripts/apply-addons.sh 已自动装进PROJECT_ROOT/awada/node_modules哈希守卫幂等。仅当node_modules被清理、package.json变更、或日志报Cannot find module wspluginawada时才手动补装cd WISEFLOW_PROJECT_ROOT/awada pnpm install --prod工作目录为WISEFLOW_PROJECT_ROOT/awada/单层结构。8.2 步骤 2写 openclaw.json读取同目录 openclaw-awada-sample.json 拿到最小配置片段然后用技能脚本把它合并进运行中的~/.openclaw/openclaw.jsonawada-channel-setup脚本行为对应 apply-awada-config.py 的实现读openclaw-awada-sample.json作为模板提示输入relayBaseUrl/ofbKey/lane/platform带默认值可回车接受合并进~/.openclaw/openclaw.json的channels.awada与pluginscustomerDB hook 默认enabled: trueagentIdsales-cs原子写回temp os.replace先备份为.bak-ts不重启 Gateway由步骤 3 人工确认。从源码看apply-awada-config.py 中的deep_merge负责递归合并字典避免覆盖已有配置L74-L78 先shutil.copy2生成带时间戳的备份再 L83-L87 通过临时文件 os.replace原子写回保证即使中途失败也不会损坏运行配置。sample 配置片段关键字段说明{ channels: { awada: { enabled: true, relayBaseUrl: https://relay.wiseflow.example.com, ofbKey: OFB_KEY, lane: user, platform: wecom, perMsgMaxLen: 1800 } }, plugins: { load: { paths: [{WISEFLOW_PROJECT_ROOT}/awada] }, entries: { awada: { enabled: true, config: { customerdb: { agentId: sales-cs, workspaceDir: {HOME}/.openclaw/workspace-sales-cs } } } } } }字段说明relayBaseUrl/ofbKey由 relay admin 签发OFB_KEY 须含awada:lane:laneIdscope。客户端不持 Redis 凭据lane/platform通道归属与平台标识需与 relay 侧 bot 配置匹配perMsgMaxLen单条消息最大长度默认 1800plugins.load.paths加载 awada 扩展的路径脚本会渲染{WISEFLOW_PROJECT_ROOT}与{HOME}占位符见 apply-awada-config.py。8.3 步骤 3建议重启 Gateway改 binding / channel 路由后必须完整重启hot-reload 不重置 routing 缓存见 it-engineer MEMORY「binding routing 坑 2」。⚠️ 重启会断所有 session执行前必须告知用户并征得同意。按部署方式二选一Docker 部署容器内检测到/.dockerenv存在告知宿主用户执行docker restart 容器名容器内无法自重启自身源码部署systemdsystemctl --user restart openclaw-gateway.service。8.4 步骤 4验证Channel 状态显示 connected用外部账号给 sales-cs 发一条消息确认收发闭环customerDB~/.openclaw/workspace-sales-cs/db/出现新来访记录。8.5 awada 排障检查单Cannot find module ws→ 步骤 1 预装未就位Docker 镜像 build 漏装 / 源码部署 apply-addons.sh 没跑手动cd PROJECT_ROOT/awada pnpm install --prod补装网关连接失败 / 401 → 检查relayBaseUrl可达性 ofbKey是否含awada:lane:lanescopeawada-serverrelay 侧进程存活 Redis 连通性relay 内部客户端不直接碰webhook 回调地址与平台后台一致channels.awada的lane/platform与 relay 侧 bot 配置匹配binding 写了但消息仍走 default agent → 见 it-engineer MEMORY「binding routing 坑 1」binding 必须写accountId通配用*。九、飞书 / 企微 work channel 绑定 SOP 与脚本原理9.1 前置确认 channel plugin 已安装收集账号凭证之前先确认所选 channel 的 plugin 已安装并启用飞书遵循 docs/feishu.md 与当前 OpenClaw 飞书接入路径无需额外安装 plugin 包企业微信由 Main Agent 执行安装脚本WISEFLOW_CONFIRM_WECOM_INSTALLconfirmed ./skills/work-channel-binding/scripts/install-wecom-channel.sh安装后告知用户绑定验证成功前 Gateway 可能需要重启。用户不需要手动运行npx。9.2 必走流程12 步请用户选择飞书或企微展示对应教程docs/feishu.md 或 docs/wecom.md确认 channel plugin 就绪企微未装时按上文命令安装收集账号信息account id、account name、app/bot id、app/bot secret、每个账号的目标 agent、私聊dmPolicy、群聊groupPolicy。用户不确定时默认open注意即使群聊 policy 为open群聊也只响应 机器人 的消息。不得在摘要中回显 secret脚本输出必须脱敏运行绑定检查python3 ./scripts/check-work-channel-bindings.py生成 dry-run 计划python3 ./scripts/prepare-work-channel-binding.py \ --channel feishu|wecom --plan-file plan.json \ --account-id account --account-name name --agent-id agent \ --app-id id --app-secret secret --dm-policy open --group-policy open展示脱敏摘要并征求用户确认确认后才应用python3 ./scripts/apply-work-channel-binding.py --plan-file plan.json询问 Gateway 重启确认重启前记录待办python3 ./scripts/record-pending-followup.py --reason work-channel-binding用户确认后重启 GatewayWISEFLOW_CONFIRM_GATEWAY_RESTARTconfirmed ./scripts/restart-gateway-confirmed.sh work-channel-binding下次会话完成待办闭环python3 ./scripts/complete-pending-followup.py以上脚本均位于 scripts/ 目录。9.3 首次绑定提醒给 main agent 与 IT engineer 各绑一个 Work channel 账号首次启用 Work channel 时若openclaw.json里没有为 main agent 和 IT engineer 绑定 Work channel建议用户多申请几个 account分别给 main agent 和 IT engineer 各绑一个。要点飞书 / 企业微信的交互体验与功能丰富度比微信强走 Work channel 能显著提升日常协作与运维体验main agent 与 IT engineer 应各用独立的 account不要共用便于权限隔离与消息分流若用户已规划好账号则按其规划若没有主动建议多申请两个 account 并分别绑定这一步不阻塞当前绑定流程但作为首次启用的强烈建议提出。9.4 脚本原理prepare / apply 的分工这套设计把计划与执行严格分离降低误操作风险prepare-work-channel-binding.py只生成 plan 文件不做任何写入。从源码看它校验--account-id与--agent-id/--app-id/--app-secret出现次数必须一致L44-L57并在输出中通过 redacted_accounts 将appSecret替换为***从源头避免密钥泄露apply-work-channel-binding.py只在拿到确认后才执行写入。写入前先校验 planversion必须为 1、channel必须为 feishu/wecom、每个 binding 的 accountId 必须存在于 accounts 中见 validated_plan随后备份原配置带 UTC 时间戳的.bak-*L160-L166最后将配置写入三处channels.name.accounts{}账号凭证与策略、plugins.entries.name.enabled true启用 plugin、bindings[]路由规则L194-L206。binding 的结构与文档channel 字段层位总纲完全对应{ agentId: sales-cs, comment: wecom:xxx - sales-cs, match: { channel: wecom, accountId: xxx } }注意match中同时包含channel与accountId——这正是 awada 排障检查单第 6 条强调的binding 必须写 accountId通配用\*\的依据。apply脚本的 binding_exists 还会做幂等判断避免重复追加相同绑定。9.5 飞书 / 企微账号申请指南用户侧飞书侧详见 docs/feishu.md在飞书开放平台创建企业自建应用在「凭证与基础信息」复制 App IDcli_xxx格式与 App Secret在「权限管理」批量导入 JSON scope含im:message、im:message:send_as_bot、contact:contact.base:readonly、docx:document等 im / docs / drive 权限在「应用能力 → 机器人」开启机器人能力在「事件与回调」选择使用长连接接收事件WebSocket 模式并添加im.message.receive_v1在「版本管理与发布」创建版本并提交发布。OpenClaw 侧启用飞书 channel 需要同时配置三处与总纲一致bindings[]路由、channels.feishu.accounts{}含appId/appSecret/dmPolicy/groupPolicy/allowFrom、plugins.entries.feishu.enabled true。完整片段样例见 samples/feishu-openclaw.json。合并时注意删掉_comment字段appSecret不得提交到代码仓优先用环境变量引用如${FEISHU_MAIN_BOT_APP_SECRET}或写入~/.openclaw/credentials/。企微侧详见 docs/wecom.md登录企业微信管理后台进入工作台 → 智能机器人 → 创建机器人 → 手动创建选择API 模式创建连接方式选择「使用长连接」无需域名/IP 即可接收消息区别于 URL 回调方式配置完成后自动生成 Bot ID 与 Secret妥善保存并告知 main agent补充配置机器人可见范围API 模式不支持预览与调试直接保存等待 main agent 完成绑定后回到创建页面保存并创建即可正常对话。两边文档都强调请妥善保管 App Secret不要分享给他人流程中所有脚本必须对 secret 脱敏绝不回显。十、运维最佳实践总结路径先行执行任何脚本前先按部署方式确认PROJECT_ROOT与OPENCLAW_HOMEDocker 固定路径 / 源码部署读OFB_ENV.md密钥归位技能密钥一律写~/.openclaw/.envdaemon.env / service-env 只放 gateway 运维变量写入前 grep 防重复、写入后重启 gateway、禁止内联 env 赋值禁碰 build生产运行中不调用pnpm openclaw subcommandcron / config / sessions 一律走 MCP 工具channel 层位channel只写bindings[].match.channel与channels.name禁贴 agent 顶层绑定走技能脚本写入bindingschannelsplugins三处不手撸改动需确认写 openclaw.json、重启 Gateway断所有 session前必须征得用户同意改 routing 后必须完整重启hot-reload 不重置 routing 缓存安全第一secret 永不回显、永不入库apply 脚本原子写回 备份兜底权限边界升级、运维脚本执行均由用户亲自操作IT Engineer 只指导、不代劳SEO、云资源、ICP 合规等职责按需启用。以上流程与红线共同构成了 xiaobeiwiseflow体系中 IT Engineer 的运维守则配合各 skill 的 SOP 脚本awada-channel-setup、work-channel-binding与 MEMORY.md 中的排障经验足以支撑一个多 crew 系统的稳定运行。赞分享人工智能AI Agent大模型AI 应用媒体生成【免费下载链接】xiaobei为OPC/中小微企业量身打造的自媒体获客智能体项目地址https://gitcode.com/gh_mirrors/wi/xiaobei点击查看免费下载相关推荐xiaobei 系统中的 IT Engineer Agent内部运维 Agent 的身份设计、职责边界与排障方法论xiaobei 系统中的 IT Engineer Agent内部运维 Agent 的身份设计、职责边界与排障方法论 导读 本文以 crews/it engin人工智能AI Agent大模型AI 应用媒体生成xiaobei 系统 IT Engineer Agent 的 SOUL 设计服务原则、排故纪律与运维安全规范xiaobei 系统 IT Engineer Agent 的 SOUL 设计服务原则、排故纪律与运维安全规范 本文档基于 crews/it engineer/人工智能AI Agent大模型AI 应用媒体生成xiaobei 项目 Work Channel 绑定实战飞书与企业微信渠道接入 openclaw.json 全流程指南xiaobei 项目 Work Channel 绑定实战飞书与企业微信渠道接入 openclaw.json 全流程指南 导读 本文面向 xiaobei 项目人工智能AI Agent大模型AI 应用媒体生成上一篇Johnny-Five 超声波声纳接近传感器实战用 Proximity 模块驱动 SRF10下一篇iOS-MVP-Clean-Architecture代码组织Screaming Architecture在iOS项目中的应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考