openclaw本地部署后必须完成llm配置才能进入主工作区，首次访问http://localhost:3000会强制弹出【llm configuration】面板，需选择provider、填写model、base url和api key并点击save，否则界面卡在初始化状态；支持openai、anthropic、ollama、lm studio、deepseek及自定义兼容接口，本地推荐ollama或lm studio方案，华为云deepseek-r1需正确填写endpoint和api key，验证成功后右上角显示绿色对勾。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw本地部署完成后，必须完成个人助理配置才能执行任何开发任务，否则界面会卡在初始化状态、无法响应指令。这一步不是可选设置，而是启动后强制触发的首次必填流程。
首次访问时自动弹出配置窗口
浏览器打开 http://localhost:3000 后，页面加载完成会立即弹出【LLM Configuration】设置面板。这个弹窗不会自动消失，不完成配置就无法进入主工作区。
在 Provider 下拉菜单中选择你实际可用的模型服务来源：OpenAI、Anthropic、Ollama、LM Studio、DeepSeek 或自定义 OpenAI 兼容接口。
选中 Provider 后，Model 字段会动态刷新可选列表；若列表为空，说明该 Provider 的基础连接未通，需检查网络或本地服务是否运行。
配置本地 Ollama 模型（推荐入门方案）
方法一：直接填写已运行的 Ollama 模型
确保 Ollama 已在后台运行：【systemctl --user is-active ollama】 返回 active 才算就绪。若未运行，先执行 systemctl --user start ollama。
Provider 选 Ollama → Model 填 qwen2:7b（或其他你已 pull 的模型名，如 llama3:8b）→ Base URL 保持默认 http://localhost:11434 → 点击 Save。
方法二：用 LM Studio 作为后端
启动 LM Studio，加载任意 GGUF 模型并开启 Local Server（端口设为 1234）→ Provider 选 LM Studio → Model 填模型文件名（如 Qwen2-7B-Instruct-Q4_K_M.gguf）→ Base URL 改为 http://localhost:1234/v1 → Save。
配置华为云 MaaS DeepSeek-R1 模型
第一步：获取 API Key 和 Endpoint
登录华为云 ModelArts Studio → 进入 MaaS 控制台 → 找到已开通的 DeepSeek-R1-64K 服务 → 点击「调用说明」→ 复制 API Key 和 Endpoint 地址（形如 https://modelarts.cn-north-4.myhuaweicloud.com/v1/xxx）。
第二步：填写配置项
Provider 选 OpenAI → Model 填 deepseek-r1 → API Key 粘贴刚复制的密钥 → Base URL 粘贴 Endpoint 地址 → Save。
【注意：Base URL 必须以 https:// 开头且末尾不能带 /v1】
第三步：验证连接
保存后页面右上角会出现绿色对勾图标，同时控制台日志中应出现 "LLM provider initialized successfully"。若出现 red error，说明 API Key 过期或 Endpoint 不可达。
跳过配置直接使用内置沙盒模式（仅限调试）
如果暂时没有可用 LLM，可强制跳过配置进入沙盒环境：
终端中停止当前容器：docker stop openhands-app。
重新运行容器，追加环境变量 -eLLM_MODEL_PROVIDER=dummy，其余参数不变。
此时 Web UI 仍可打开，但所有任务都会返回模拟响应，仅用于界面操作练习，无法真实执行代码或命令。
