aionclaw是基于openclaw深度重构的国产化运行时，选择性兼容原生工作流：需满足soul.md/user.md存在、技能含acp声明、mcp端口合规，否则须按clawhub包导出或配置替换方式迁移。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认AionClaw与OpenClaw工作流的兼容边界
AionClaw不是OpenClaw的简单UI壳，而是基于其底层协议深度重构的国产化运行时，它默认启用HermesAgent双引擎架构，对原生OpenClaw工作流存在选择性兼容——不兼容硬编码Skill路径、不兼容未声明的MCP服务端口、不兼容gateway.yaml中使用非标准YAML语法定义的routes规则。你手头已有的OpenClaw工作流能否直接复用，取决于它是否遵循ACP协议规范和SOUL.md/USER.md语义锚点约定。
三步验证现有工作流是否可迁入AionClaw
第一步：检查workspace目录下是否存在SOUL.md与USER.md文件。若缺失任一文件，AionClaw将无法识别该工作区的角色约束与业务上下文，必须补全后才能加载。
第二步：打开skills目录，确认所有.py或.js技能脚本首行是否包含# ACP: v1.2或//! acp-version=1.2声明。没有该声明的脚本在AionClaw中会被静默跳过，不会报错也不会执行。
第三步：运行aionclaw validate --workspace ./my-workspace。该命令会扫描整个工作区，输出兼容性报告。若报告中出现⚠️ MCP endpoint unreachable at port 8081，说明你原工作流依赖的MCP服务未在AionClaw中启动，需手动执行aionclaw mcp start --port 8081。
两种迁移路径：平滑接入 or 重构适配
方法一：保留原结构，仅替换入口配置
进入AionClaw安装目录→打开config/app.yaml→找到default_workspace:字段→将其值改为你的OpenClaw workspace绝对路径→保存后执行aionclaw reload workspace。这一步操作起来很简单，但【仅当原workspace通过openclaw onboard初始化且未手动修改过gateway.yaml结构时才生效】。
方法二：导出为ClawHub包再重装
在原OpenClaw环境中执行openclaw export --workspace ./legacy --format clawhub生成.clawhub包→将包拖入AionClaw主界面右下角“从Hub安装”区域→等待自动解压、校验、权限初始化完成。此方式会强制标准化路径与权限模型，但会丢弃本地临时缓存文件。
微信渠道工作流的特殊处理
如果你的OpenClaw工作流绑定了微信公众号或企业微信机器人，不能直接复用token和AppID。AionClaw要求所有IM通道必须通过aionclaw channel bind wecom --qr重新扫码授权，旧凭证会被系统拒绝。这是因为AionClaw内置了独立的OAuth2.0代理层，用于拦截并审计所有外发消息内容，防止敏感信息泄露。
执行扫码绑定后，AionClaw会在config/channels/wecom.yaml中生成新配置块，其中proxy_enabled: true字段不可手动关闭——这是合规性强制要求，关闭会导致整个微信通道失效。
