AionClaw本地运行环境已就绪需完成客户端初始化并确认左下角显示绿色“安全保护中”标识，否则无法调用任何外部API；飞书对接须用管理员权限账号创建自建应用、开通三项权限、获取App ID/Secret及正确table_id与table_token；配置后通过“测试连接”验证，再设置字段映射与定时同步，首次导入成功后可在“本地数据源”查看Feishu_开头的数据集。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认AionClaw本地运行环境已就绪
确保你已安装并首次启动AionClaw桌面客户端，完成初始配置（含权限初始化、模型接口绑定），且左侧面板中「自动化 (RPA)」和「工具管理」模块可正常点击访问。若未完成初始化，后续所有数据联动操作将无法触发——【未完成初始化的客户端无法调用任何外部API】。
这一步操作起来很简单，直接打开App确认左下角显示绿色「安全保护中」标识即可，无需额外登录或输入密钥。
在飞书开放平台创建并配置自建应用
必须使用你拥有管理员权限的飞书账号（个人飞书或自建企业飞书），不能使用公司统一管理的办公飞书账号，否则后续无法获取有效access_token。
登录飞书开放平台→进入「开发者后台」→「企业自建应用」→点击「创建企业自建应用」→填写名称如“AionClaw-DataBridge”、描述后创建→进入该应用→「权限管理」→搜索并开通以下三项权限：
• 查看、评论和导出多维表格
• 获取用户基本信息（contact:user.id:readonly）
• 读取多维表格数据（base:app:read）
开通后点击顶部「创建版本」→填写版本号“1.0.0”→发布。回到「凭证与基础信息」页面，复制保存 App ID 和 App Secret ——这两个值将在AionClaw中用于生成临时访问令牌，【泄露App Secret会导致他人可任意读取你全部多维表格】。
获取目标多维表格的table_id与table_token
打开你要导入数据的飞书多维表格，注意必须是「已打开」状态（非仅链接分享页）。查看浏览器地址栏URL，格式为：https://base.feishu.cn/base/<strong>tblxxxxxxxxxxxxxxxxx</strong>?table=<strong>tblyyyyyyyyyyyyyyy</strong>
其中第一个“tbl”开头的长字符串是 base_id（即 table_token），第二个是 table_id。两者缺一不可，且顺序不能颠倒——填反会导致AionClaw返回404错误，但不会提示具体原因。
把这两个值用记事本临时存好，下一步将粘贴进AionClaw配置界面。
在AionClaw中新建飞书多维表格导入任务
点击左侧导航栏「自动化 (RPA)」→右上角「+ 新建任务」→选择模板「从飞书多维表格拉取数据」→进入配置页。
第一步：在「飞书App ID」框粘贴你刚复制的App ID；
第二步：在「飞书App Secret」框粘贴对应App Secret；
第三步：在「Base Token（table_token）」栏填入URL中第一个tbl开头的字符串；
第四步：在「Table ID」栏填入URL中第二个tbl开头的字符串；
第五步：勾选「自动刷新凭证」（启用后每次任务执行前会静默更新access_token，避免过期中断）。
全部填完后点击「测试连接」按钮，成功会弹出预览窗口显示前5条记录字段名和示例值；失败则根据错误码定位：401=凭证无效，403=权限未开通，404=table_id或table_token错误。
设置字段映射与数据清洗规则
点击「下一步：字段映射」后，AionClaw会自动解析多维表格字段类型（如单选、日期、人员、关联表等）并列出原始字段名。
方法一：保留原始字段名 → 直接点击「跳过映射」，全部字段将以原名载入本地数据库，适合后续在Power BI或Excel中手动处理；
方法二：重命名关键字段 → 例如将飞书字段“负责人”改为“owner_name”，“提交时间”改为“submit_at”，方便跨平台识别；
方法三：过滤敏感字段 → 点击字段右侧「×」可取消导入，特别建议关闭「附件」和「评论」类字段，它们会触发额外API调用且无法被AionClaw本地解析。
若多维表格中存在「双向关联」字段，AionClaw默认将其转为JSON字符串存储，不自动展开子表——这是当前版本限制，无法绕过。
启动定时同步并验证首次导入结果
完成映射后点击「保存并启用」→ 在任务列表中找到该任务→点击右侧「立即执行」。
等待约8–25秒（取决于表格行数和网络），状态由「运行中」变为「成功」，此时打开「工具管理」→「本地数据源」→找到以“Feishu_”开头的新数据集，双击打开即可查看完整表格内容。
首次导入完成后，AionClaw会在右下角弹出通知：“共同步XX条记录，字段XX个”，点击该通知可直接跳转至数据预览页。如果记录数为0，请检查飞书多维表格中是否设置了视图筛选条件——AionClaw只拉取当前默认视图可见的数据，不会绕过视图权限。
