50 个常见问题,一次解答
安装类
Q1: 支持哪些操作系统?
A: macOS、Linux、Windows(WSL)
Q2: 需要什么依赖?
A: Node.js 18+、Python 3.8+
Q3: 安装失败怎么办?
A: 换淘宝源,检查网络,看错误日志
Q4: Docker 部署支持吗?
A: 支持,docker pull openclaw/openclaw
配置类
Q5: 配置文件在哪?
A: ~/.openclaw/config.yaml
Q6: 如何配置多个模型?
A:
model:
providers:
deepseek:
api_key: xxx
openai:
api_key: yyy
Q7: 环境变量怎么用?
A: ${VARIABLE_NAME} 在配置中引用
Q8: 配置错误怎么排查?
A: openclaw config check
模型类
Q9: 支持哪些模型?
A: OpenAI、Claude、DeepSeek、GLM、Ollama 等
Q10: 如何切换模型?
A:
model:
default: deepseek-chat
Q11: 本地模型怎么配置?
A:
model:
providers:
ollama:
base_url: http://localhost:11434/v1
Q12: 模型响应慢怎么办?
A: 换更快的模型,启用缓存,检查网络
渠道类
Q13: 支持哪些渠道?
A: Telegram、Discord、微信、飞书、钉钉等
Q14: Telegram Bot 怎么创建?
A: 找 @BotFather,发送 /newbot
Q15: 微信怎么接入?
A: 通过企业微信或 ComWechat
Q16: 多渠道如何管理?
A: 在配置文件中添加多个 channel
功能类
Q17: 心跳是什么?
A: 定时自动执行任务的机制
Q18: Skills 怎么写?
A: 创建目录 + SKILL.md 文件
Q19: 记忆怎么工作?
A: 对话历史 + MEMORY.md + memory/
Q20: 多轮对话有限制吗?
A: 默认 50 轮,可配置
使用类
Q21: 如何开始对话?
A: openclaw chat "你的问题"
Q22: 如何发送文件?
A: 直接在对话中上传(部分渠道支持)
Q23: 如何查看历史?
A: openclaw history
Q24: 如何清除对话?
A: openclaw clear 或 /new
Q25: 如何导出对话?
A: openclaw export --format markdown
自动化类
Q26: 如何设置定时任务?
A:
heartbeat:
tasks:
- name: my-task
schedule: "0 9 * * *"
Q27: 心跳可以暂停吗?
A: openclaw heartbeat pause
Q28: 如何调试心跳任务?
A: openclaw heartbeat test --task xxx
Q29: 任务失败会重试吗?
A: 可以配置 retry: 3
Q30: 如何查看心跳日志?
A: openclaw logs --heartbeat
企业类
Q31: 支持多用户吗?
A: 支持,每个用户独立会话
Q32: 如何限制权限?
A: 配置 permissions 部分
Q33: 数据存在哪里?
A: 本地 SQLite 或 PostgreSQL
Q34: 可以私有部署吗?
A: 可以,完全本地运行
Q35: 如何对接企业系统?
A: Webhook、API、Skills
安全类
Q36: 数据安全吗?
A: 本地运行,数据不出电脑
Q37: API Key 会泄露吗?
A: 用环境变量,不写在配置文件
Q38: 如何加密敏感数据?
A: 使用 openclaw secret encrypt
Q39: 日志会记录敏感信息吗?
A: 可配置 redact 脱敏
Q40: 如何审计操作记录?
A: openclaw audit log
成本类
Q41: OpenClaw 收费吗?
A: 开源免费,自己部署
Q42: API 费用大概多少?
A: DeepSeek 约 ¥1/百万 tokens
Q43: 如何控制成本?
A: 缓存、选便宜模型、限制历史
Q44: 有用量统计吗?
A: openclaw stats
Q45: 如何设置预算上限?
A: 配置 budget 参数
故障类
Q46: 启动失败?
A: 检查端口、配置、依赖
Q47: 不响应消息?
A: 检查渠道配置、网络、日志
Q48: 响应很慢?
A: 换模型、加缓存、检查网络
Q49: 内存占用高?
A: 减少历史长度、重启
Q50: 如何提交 Bug?
A: GitHub Issues 或 Discord
📖 完整文档:docs.openclaw.ai
💬 还有问题?评论区留言!
🎯 中文支持:微信 yang1002378395