octop v0.9.24 不内置 harness-browser,需通过环境变量配置 custom 后端指向 browser-harness 服务(如 http://127.0.0.1:3080),并确保 chrome 调试模式运行于 9222 端口,二者网络互通后即可支持自愈式网页自动化。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Octop v0.9.24 本身不直接内置 harness-browser,它默认使用自己的浏览器控制机制(如通过 Connector 或远程桌面能力),但你可以将 browser-harness(即基于 CDP 的轻量自愈浏览器控制层)作为外部浏览器后端接入 Octop,实现更灵活的网页自动化任务。关键在于让 Octop 的 Agent 能调用到运行中的 browser-harness 实例。
确认 browser-harness 已就绪
browser-harness 是一个独立服务,默认监听 http://127.0.0.1:3080 并通过 WebSocket 连接 Chrome 的 CDP 端口(9222)。请先确保:
- Chrome/Chromium 已安装,且以调试模式启动:
google-chrome --remote-debugging-port=9222 --no-sandbox --headless=new --disable-gpu - browser-harness 正常运行:
推荐用 npm 启动:npx dsh(需已全局安装deepseek-harness) - 访问
http://127.0.0.1:3080可打开 Web UI,说明 harness 已就绪
在 Octop 中配置浏览器连接方式
Octop 不提供图形化界面直接填写 harness 地址,需通过环境变量或配置文件显式指定浏览器后端类型和地址:
统一LLM网关 - 一个API对接70+AI模型,使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
- 启动 Octop 前,设置环境变量:
export OCTOP_BROWSER_BACKEND="custom"export OCTOP_BROWSER_CUSTOM_URL="http://127.0.0.1:3080" - 若使用 Docker 部署,在
docker run命令中加入:-e OCTOP_BROWSER_BACKEND=custom -e OCTOP_BROWSER_CUSTOM_URL=http://host.docker.internal:3080(注意:Linux 宿主机需用host.docker.internal或替换为真实 IP) - 确保 Octop 与 browser-harness 在同一网络可互通(尤其跨容器时避免 localhost 隔离)
验证与基础任务对接
配置生效后,Octop 的 Agent 在执行含网页操作的任务(如“查天气”“登录微博”)时,会尝试通过 /v1/browser/navigate 等接口向 harness 发送指令。你可在 browser-harness 控制台看到实时日志,例如:
[INFO] helpers.py updated with scroll_to_element()
这表示 harness 已成功接收并动态扩展了能力 —— 这正是其核心价值所在。
常见问题处理
若任务卡在“等待浏览器响应”,优先检查:
- Chrome 是否真正在
9222端口监听(lsof -i :9222或curl http://127.0.0.1:9222/json应返回页面列表) - browser-harness 日志中是否有 WebSocket 连接失败提示(如 ECONNREFUSED)
- Octop 容器是否能 ping 通宿主机的 3080 端口(必要时开放防火墙或改用 host 网络模式)










