AionClaw要求Windows 10/11 64位或全系列macOS（≥12.0），禁用杀软实时防护；需Chrome≥120，配置TaoToken API Key及Base URL，并放行目标域名或本地文件权限，最后通过“访问指定网址”技能验证自动化链路。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认本地运行环境与基础依赖
确保操作系统为 Windows 10/11 64 位 或 macOS 全系列（M 芯片与 Intel 均已适配），不支持 32 位系统或老旧 macOS 版本（如低于 12.0）。【必须关闭杀毒软件实时防护与 Windows Defender 的“基于声誉的保护”】，否则 AionClaw 启动浏览器驱动时会被拦截，表现为 Chrome 窗口闪退、控制台报错“access denied”或 Gateway 进程异常终止。
检查本地是否已安装 Chrome 浏览器（版本 ≥ 120），AionClaw 默认调用系统已安装的 Chrome，不自带浏览器内核。若仅装了 Edge 或 Firefox，需手动在设置→自动化行为→浏览器配置中切换为对应驱动，否则技能执行时直接失败。
完成模型接入通道配置
打开 AionClaw → 左侧【工具管理】→ 点击【模型通道】→ 选择 TaoToken 作为接入方式。
进入 https://taotoken.net/console/api-keys 页面创建新 API Key，命名建议含环境标识（如 aionclaw-test-chrome），复制后粘贴至 AionClaw 模型通道页的「API Key」栏；Base URL 填写 https://taotoken.net/api（注意结尾无斜杠、不带 UTM 参数）。
这一步不可跳过：没有有效模型通道，AionClaw 无法理解“点击登录按钮”“等待加载完成”等自然语言指令，所有浏览器自动化任务会在解析阶段卡住，界面显示“正在规划步骤…”但永不执行。
准备目标测试页面与权限白名单
将待测试的网页地址（如 http://localhost:3000/login 或 https://staging.example.com/form）提前打开一次，确保能正常访问、无证书错误、无跨域拦截。
若测试页面为本地 HTML 文件（如 file:///Users/name/test.html），需在 AionClaw 设置→安全保护→本地文件权限中，勾选「允许访问本地文件协议（file://）」。不开启则浏览器会拒绝加载，控制台报错 net::ERR_FILE_NOT_FOUND 或空白页。
方法一：对开发环境域名放行
在设置→安全保护→网站权限白名单中，添加 localhost、127.0.0.1、staging.* 等通配域名，每行一个。
方法二：临时禁用沙箱（仅限可信本地页面）
编辑 AionClaw 安装目录下的 .env 文件，在末尾新增一行 CHROME_ARGS=--disable-web-security --user-data-dir=/tmp/aionclaw-test，保存后重启客户端。此操作绕过 CORS 限制，但【禁止在公网可访问页面或生产环境使用】，否则存在 XSS 风险。
验证浏览器自动化链路是否就绪
第一步：打开 AionClaw 主界面 → 左侧【自动化 (RPA)】→ 搜索“打开网页” → 运行【访问指定网址】技能 → 输入 https://example.com → 点击执行。
第二步：观察 Chrome 是否成功启动并跳转，页面右上角是否出现 AionClaw 注入的浮动控制栏（含暂停、重试、日志按钮）。
第三步：在浮动栏点击「日志」→ 查看最后三行是否含 “Browser session active” 和 “Page loaded successfully” 字样。若出现 “Failed to attach to browser” 或长时间无响应，说明 Chrome 驱动未正确注入，需返回第一步检查杀软拦截或 Chrome 版本兼容性。
