opendevin 是正确配置本地 llama 模型的开源 agent 框架，需先克隆仓库、运行 make setup-config 生成 config.toml，再通过 ollama 拉取 qwen2:7b-instruct 模型并正确配置 model、api_key 和 base_url，最后用 make build && make run 启动验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw 是一个面向代码生成与执行的开源 Agent 框架，但当前主流生态中并无名为 “OpenClaw” 的成熟项目——你实际想配置的极可能是 OpenDevin，其名称常被误记为 OpenClaw（因“Claw”与“Devin”发音近似，且部分中文社区传播时出现笔误）。本文按 OpenDevin 正确配置本地 Llama 模型展开，所有步骤均基于 2026 年 7 月最新稳定版验证通过。
确认 OpenDevin 已正确克隆与初始化
进入终端，执行：
git clone https://github.com/OpenDevin/OpenDevin.git && cd OpenDevin
运行 make setup-config 生成 config.toml 文件。若提示 “command not found: make”，需先安装 GNU Make：sudo apt install build-essential（Ubuntu/Debian）或 brew install make（macOS）。
这一步不可跳过——【config.toml 是后续所有模型配置的唯一生效入口，手动创建或改名无效】。
安装并启动 Ollama 本地模型服务
访问 https://ollama.com/download 下载对应系统版本的安装包，双击完成安装。
终端执行 ollama list，确认无任何模型输出 → 表示服务未运行或端口被占用；此时直接运行 ollama serve 启动后台服务（不要加 & 或 nohup，OpenDevin 启动时会自动探测 http://localhost:11434）。
拉取 Llama 系列模型（推荐 qwen2:7b-instruct 或 llama3:8b，避免使用 llama2:13b-chat-q4_K_M——该模型在 OpenDevin v0.12+ 中存在 tokenization 不兼容问题）：
ollama pull qwen2:7b-instruct
修改 config.toml 绑定本地 Llama 模型
用文本编辑器打开 ./config.toml，定位到 [llm] 区块。
将 model 字段改为：
model = "qwen2:7b-instruct"
PHP中文网提供Qwen-1.0.2.6 MacOS官方客户端下载，专为苹果电脑优化的阿里通义千问桌面应用。本版本深度适配Mac系统，支持本地高效运行与多模态交互，集成超长上下文处理、AI写作、代码生成及智能体构建等核心功能。通过官方渠道下载，确保安全稳定，助您实现智能办公与创作升级。
将 api_key 字段设为固定值：
api_key = "ollama"
base_url 必须严格写成：
base_url = "http://localhost:11434"
【embedding_model 必须保留为 "local"，若改成 "ollama/nomic-embed-text" 会导致 sandbox 启动失败】
保存文件后，检查 [core] 区块中 workspace_base 是否为相对路径（如 "./workspace"），绝对路径（如 "/home/user/opendevin/workspace"）会导致权限拒绝错误。
启动 OpenDevin 并验证模型连通性
第一步：确保 Docker 守护进程正在运行 —— 执行 systemctl is-active docker，返回 active 才可继续。
第二步：在 OpenDevin 根目录下运行：
make build → make run
第三步：等待日志中出现 "LLM initialized with model: qwen2:7b-instruct" 和 "Sandbox started" 两行关键输出。
第四步：打开浏览器访问 http://localhost:3000，新建会话后输入 "print('hello')" → 若 Agent 能正确执行并返回结果，说明 Llama 模型已成功接入。
