应依次执行五步:一、安装并注册openclaw内核;二、配置模型服务baseurl;三、安装clawlab插件并启用openclaw模式;四、加载sandbox扩展启用沙箱执行;五、统一绑定数据源挂载路径。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在Jupyter Lab中尝试调用OpenClaw执行数据分析任务,但自然语言指令未触发自动化代码生成或执行失败,则可能是由于内核未正确注册或模型服务地址配置缺失。以下是解决此问题的步骤:
一、验证OpenClaw IPython内核安装状态
该步骤用于确认Jupyter Lab是否已识别OpenClaw专用内核,避免因内核缺失导致自然语言指令无法解析。只有内核成功注册后,Notebook才能将用户输入路由至OpenClaw Agent进行语义理解与代码编排。
1、启动JupyterLab,在左侧Launcher界面点击“Python 3”新建空白Notebook。
2、点击右上角Kernel下拉菜单,查看是否存在“OpenClaw Kernel”选项。
3、若未显示,需在终端中以当前用户身份执行:clawhub install ipython-kernel。
4、执行完成后重启JupyterLab服务,再次检查Kernel列表。
二、校验本地模型服务端点配置
该步骤确保OpenClaw能将自然语言请求准确转发至本地大模型推理服务,防止因URL错误或端口阻塞造成请求超时或连接拒绝。配置文件中的baseUrl必须与实际运行的模型服务监听地址完全一致。
1、打开配置文件路径:~/.openclaw/openclaw.json。
2、定位到models.providers.local-qwen.baseUrl字段。
3、确认其值为:http://localhost:8000/v1(若Qwen3-32B使用Ollama部署,则应为http://localhost:11434/api/chat)。
4、保存文件后,在终端执行:clawhub restart以重载配置。
三、启用JupyterLab插件增强支持
该步骤通过加载官方维护的ClawLab插件,为Notebook单元格注入OpenClaw专属交互能力,包括自然语言输入框、执行历史回溯、中间结果可视化面板等,弥补基础内核功能局限。
1、在JupyterLab命令面板(Ctrl+Shift+P)中输入“ClawLab: Install Extension”并执行。
2、插件安装完成后,重启JupyterLab。
3、新建Notebook,点击左上角“Claw”图标,选择“Enable OpenClaw Mode”。
4、此时单元格顶部将出现绿色语音气泡图标,点击即可输入如“绘制df中age列的分布直方图”等指令。
四、切换至沙箱模式隔离执行环境
该步骤通过启动独立Python子进程运行OpenClaw生成的代码,防止恶意或异常脚本污染主Jupyter内核全局变量空间,保障数据科学工作流的可重复性与安全性。
1、在Notebook任意单元格中执行:%load_ext openclaw.sandbox。
2、随后所有以%%claw_magic开头的单元格均自动进入沙箱执行模式。
3、输入指令后,系统将自动生成临时.py文件,在干净环境中执行并返回结果。
4、执行日志与中间变量将自动写入/tmp/openclaw_sandbox_logs/目录供审计。
五、绑定数据源自动挂载路径
该步骤使OpenClaw在解析“读取当前目录下所有CSV文件”类指令时,能精准定位用户实际工作区,避免因路径歧义导致文件未找到或误读系统临时文件。
1、编辑Jupyter启动配置文件:~/.jupyter/jupyter_notebook_config.py。
2、添加配置项:c.NotebookApp.notebook_dir = '/home/{username}/data_science_projects'。
3、同步更新OpenClaw配置中workspace.root_path字段为相同路径。
4、重启JupyterLab与OpenClaw服务,执行自然语言指令验证路径生效。











