需启用权限、配置解释器路径、注册脚本、在工作流中调用或通过cli触发；具体包括将脚本执行策略设为“允许绝对路径执行”、绑定本地python解释器、注册脚本id与参数模板、拖入工作流节点并填入id及参数、或使用qclaw run命令行调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在QClaw中执行本地编写好的Python脚本，需通过QClaw提供的脚本调用机制与本地开发环境建立通信。以下是实现QClaw调用本地Python脚本的具体操作步骤：
一、启用QClaw本地脚本执行权限
QClaw默认限制外部脚本执行以保障运行安全，必须手动开启本地脚本调用功能，否则将触发拒绝访问错误。
1、启动QClaw客户端并登录主界面。
2、点击右上角设置图标，选择“高级配置”选项卡。
3、在“脚本执行策略”区域，将下拉菜单由“禁止本地路径”更改为“允许绝对路径执行”。
4、勾选“启用本地Python解释器绑定”复选框。
5、点击“保存配置”按钮，重启QClaw服务使设置生效。
二、配置本地Python解释器路径
QClaw需明确识别系统中可用的Python可执行文件位置，才能正确加载和运行脚本，路径错误会导致“Interpreter not found”异常。
1、进入QClaw主界面，依次点击“工具”→“环境管理”→“Python解释器设置”。
2、在“解释器路径”输入框中，粘贴本地Python安装路径，例如Windows下为C:\Python39\python.exe，macOS下为/usr/local/bin/python3。
3、点击“测试连接”按钮，确认返回状态为“Success”。若失败，请检查Python是否已加入系统PATH或路径拼写是否准确。
4、勾选“自动同步site-packages路径”以支持调用本地已安装的第三方库。
三、注册本地脚本为QClaw可调用资源
QClaw不支持直接读取任意磁盘路径脚本，需通过资源注册机制将其纳入受信脚本列表，确保调用时能被索引和验证。
1、在QClaw左侧导航栏点击“脚本中心”，再点击右上角“+新增本地脚本”按钮。
2、在弹出窗口中，点击“浏览”选择目标.py文件，如D:\qclaw_scripts\process_data.py。
3、为该脚本填写唯一标识符（ID），例如data_processor_v2，此ID将在后续API调用中作为引用键使用。
4、在“参数模板”字段中定义JSON格式的默认参数结构，例如：{"input_file": "sample.csv", "output_dir": "./results"}。
5、点击“提交注册”，脚本即出现在“已注册脚本”列表中且状态显示为“已就绪”。
四、在QClaw工作流中调用已注册脚本
完成注册后，脚本可作为独立节点嵌入QClaw可视化流程图或通过命令行接口触发，调用过程将自动加载本地解释器并传入指定参数。
1、新建一个工作流画布，从左侧节点库拖入“Python脚本执行”模块。
2、双击该模块，在“脚本ID”字段中输入此前注册的标识符，例如data_processor_v2。
3、在“运行参数”区域，以键值对形式覆盖默认参数，例如将“input_file”设为"2024_q3_report.xlsx"。
4、勾选“同步等待执行完成”以确保后续节点仅在脚本输出生成后启动。
5、点击画布上方“运行工作流”按钮，QClaw将启动本地Python进程并实时输出日志至控制台面板。
五、通过QClaw CLI命令行直接触发脚本
对于自动化集成场景，QClaw提供内置CLI指令，绕过图形界面直接调用已注册脚本，适用于定时任务或CI/CD流水线。
1、打开系统终端（Windows PowerShell / macOS Terminal / Linux Bash）。
2、执行命令：qclaw run --script-id data_processor_v2 --params '{"input_file":"raw.json","debug":true}'。
3、确认终端输出包含“[INFO] Launching local Python interpreter…”及后续脚本打印内容。
4、检查本地脚本所在目录是否生成预期输出文件，例如./results/processed_20241025.json。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
