国内不科学上网可以使用吗？

完全可以。使用 DeepSeek、豆包等国产模型，通过国内镜像安装即可，不需要外网。

常见问题

Q: OpenClaw 是什么？

OpenClaw 是一个能帮你干活的个人 AI 超级助理。它运行在你自己的设备上，通过聊天消息操控电脑，还能连接飞书、微信等 25+ 平台。

Q: OpenClaw 免费吗？

OpenClaw 本身是免费开源的。你需要自行承担 AI 模型的 API 调用费用，DeepSeek 充值 10 元可以用很久，Ollama 本地模型完全免费。

Q: 支持哪些聊天平台？

目前支持 30+ 平台，包括 Telegram、WhatsApp、Discord、微信、飞书、Slack、钉钉等。

Q: 需要什么配置的电脑？

使用云端模型不挑配置，破电脑、旧笔记本都行。使用本地模型需要 N 卡 12GB 显存或 Mac M 系列芯片 16GB 起步。

通用问题

OpenClaw 是什么？

OpenClaw 是一个能帮你干活的个人 AI 超级助理。不同于豆包、Gemini、DeepSeek 等只能回答问题的 AI，OpenClaw 可以帮你完成任务 --- 你在电脑上能操作的，它都能做。

它运行在你自己的设备上（笔记本、台式机或服务器），通过聊天消息操控电脑，还能连接飞书、微信等平台。

OpenClaw 免费吗？

OpenClaw 本身是免费开源的。你需要自行承担 AI 模型的 API 调用费用：

DeepSeek：充值 10 元可以用很久（推荐入门）
Ollama 本地模型：完全免费，但需要较高硬件配置
Gemini / Claude / GPT：能力更强，费用相对较高

支持哪些聊天平台？

目前支持 30+ 平台，包括 Telegram、WhatsApp、Discord、微信、飞书、Slack、钉钉等，详见频道配置。

OpenClaw 的官方网站

官方网站：https://openclaw.ai/
官方 GitHub 仓库：https://github.com/openclaw/openclaw

什么是 ClawHub？

ClawHub 是 OpenClaw 的官方 Skill 市场（注册表），类似 npm 之于 Node.js。目前有 13,729 个注册技能，社区维护了一份精选列表，筛选出约 5,494 个优质技能。

bash

# 搜索技能
openclaw skills search "翻译"

# 安装技能
openclaw skills install translator

详见插件系统。

Skills 安全吗？

需要谨慎

Skills 由社区贡献，并非全部安全。历史上曾发生过 ClawHavoc 事件 --- 恶意技能伪装成热门工具，窃取用户 API Key 和本地数据。目前 ClawHub 上已有 800+ 个技能被标记为恶意。

安全建议：

安装前务必审查源码，特别是 scripts/ 目录中的脚本
优先使用 awesome-openclaw-skills 精选列表中的技能
关注技能的下载量和社区评价
不要安装来源不明的技能

模型怎么选？

根据使用场景和预算，推荐以下五套方案：

方案	主模型	适合场景	月均成本
入门首选	DeepSeek	日常对话、轻量任务	~5 元
性价比之王	DeepSeek + Gemini Flash	日常 + 偶尔复杂任务	~15 元
专业开发	Claude Sonnet	编程、文档、技术任务	~$20
全能旗舰	Claude Opus + GPT-4o	最强能力，不差钱	~$50+
完全免费	Ollama (Qwen/Llama)	本地运行，隐私优先	0 元（需算力）

详见模型供应商和模型 Failover。

什么是 openclaw-china？

openclaw-china 是社区维护的一站式国内平台支持插件，预配置了：

国产模型适配（DeepSeek、豆包、通义千问、智谱等）
国内镜像源加速
微信、飞书、钉钉等国内频道的优化配置
中文 System Prompt 模板

bash

# 安装
openclaw skills install openclaw-china

适合国内用户快速上手，免去逐一配置国产服务的麻烦。

成本怎么控制？

AI 模型 API 按 Token 计费，不加控制可能会产生意外费用。推荐策略：

配置 Fallback 链：主模型失败时自动降级到便宜模型，避免因限流/故障切换到昂贵备选

yaml

# config.yaml
models:
  - deepseek       # 主力，最便宜
  - gemini-flash   # 备选，免费额度大
  - gpt-4o-mini    # 兜底

免费模型做心跳：心跳（Heartbeat）会定期消耗 Token，建议用 Gemini Flash 等有免费额度的模型处理心跳任务
设置月度预算上限：在模型供应商的控制台设置消费上限
入门阶段关闭心跳：心跳功能会持续消耗 Token，建议熟悉系统后再开启

部署相关

不科学上网，国内可以使用吗？

完全可以。 OpenClaw 本质上是一个开源的 AI Agent 框架，运行在你自己的设备上。只要你能解决以下两个问题，就不需要外网：

AI 模型：使用 DeepSeek、豆包等国产模型
安装方式：通过国内镜像安装（npm config set registry https://registry.npmmirror.com）

需要什么配置的电脑？

使用云端模型（推荐）：不挑配置，破电脑、旧笔记本都行。只需要稳定的网络连接。

使用本地模型（可选）：

平台	最低配置
Windows	N 卡 12GB 显存（推荐 RTX 3060 12G），内存 16GB+
Mac	M1/M2/M3/M4 芯片，16GB 统一内存起步

不需要买 Mac Mini

完全没有必要花几千元买设备。用云端模型（如 DeepSeek 充值 10 元）就够了。

本地部署安全吗？

放心装。只要从官方渠道下载，它只是一个网络工具，不会动你电脑里的数据。不要从网盘或来历不明的网站下载打包版本。

支持在国内服务器部署吗？

支持。使用国产模型（DeepSeek、豆包等）无需代理。如果想用 OpenAI / Anthropic 等国外模型，需要配置代理或使用 OpenRouter。

翻墙环境怎么配置？

Telegram 和 Discord 都需要翻墙才能连接。你需要：

代理工具：Clash Verge / Clash for Windows / Surge
稳定的机场节点
开启 TUN 模式（很多人忘了这一步，不开 TUN 模式，终端走不了代理）

配置步骤：

打开 Clash Verge，查看代理端口：HTTP 端口（一般是 7890）、SOCKS5 端口（一般是 7891）
编辑 shell 配置文件（zsh 用 ~/.zshrc，bash 用 ~/.bashrc），添加：

bash

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export all_proxy=socks5://127.0.0.1:7891

重新加载：source ~/.zshrc
重启 OpenClaw：openclaw restart

验证方法：

bash

curl -I https://api.telegram.org

如果返回 200，说明终端能访问 Telegram API。

模型 API 怎么选？

推荐按使用阶段选择：

阶段	推荐方案	说明
新手试水	OpenRouter 或 AI/ML API	按量付费，约 $3-15/天，不浪费
确定长期使用	ChatGPT Plus 订阅	$20/月，官方白名单支持
国内用户	阿里云百炼 Coding Plan	¥100-200/月，通义千问 Qwen3-Max/Kimi K2.5
零成本学习	Ollama 本地模型	完全免费，但效果较差

注意

千万别一上来就搞中转站。中转站便宜但不稳定、风险高，翻车了排查问题你都不知道是模型问题还是配置问题。

npm install -g openclaw 报错 EACCES 权限不足

bash

# 方法一：使用sudo（不推荐）
sudo npm install -g openclaw

# 方法二（推荐）：修改npm全局目录
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g openclaw

Docker 启动后访问 localhost:8080 无响应

bash

# 检查容器是否正在运行
docker ps | grep openclaw

# 检查容器日志是否有错误
docker logs openclaw 2>&1 | tail -50

# 检查端口映射
docker inspect openclaw | grep -i port

# 检查本机防火墙
ufw status  # Ubuntu
# 确保8080端口已开放

Windows 上中文显示乱码

powershell

# PowerShell设置UTF-8
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$env:PYTHONIOENCODING = "UTF-8"
chcp 65001

使用问题

Agent 不回复消息怎么办？

请参考故障排查页面排查常见问题。

如何让 OpenClaw 执行终端命令？

bash

openclaw config set tools.profile coding

这条命令非常重要，它赋予 OpenClaw 执行终端命令的能力。

什么是「心跳」(Heartbeat)？

心跳是一个后台定时触发系统，让 AI 从「被动等待指令」变成「主动观察执行」。每隔一段时间唤醒 AI，让它自主判断是否需要为你做点什么。

建议频率：

轻度使用：每 2-4 小时一次
中度使用：每 1-2 小时一次
重度使用：每 30 分钟一次

WARNING

心跳会消耗 Token。建议入门阶段先禁用，等重度使用后再开启。

API Key 配置后提示 Invalid API Key

bash

# 检查API Key格式
# Anthropic: sk-ant-api03-xxxx（注意是api03不是api01）
# OpenAI: sk-proj-xxxx 或 sk-xxxx
# 检查是否有多余空格
echo $ANTHROPIC_API_KEY | cat -A  # 不应有^M或多余空格

# 测试API Key是否有效
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-3-5-haiku-20241022","max_tokens":10,"messages":[{"role":"user","content":"hi"}]}'

openclaw.json 修改后没有生效

bash

# 重载配置
openclaw config reload

# 如果还是不生效，检查是否有语法错误
python3 -m json.tool openclaw.json

# 确认修改的是正确的文件
openclaw config show --path  # 显示配置文件路径

SOUL.md 不生效

检查清单：

文件名：SOUL.md（大写，不是 soul.md）
位置：在项目根目录，不是子目录
编码：UTF-8（用 VSCode 检查右下角）
格式：纯文本，没有 BOM 头
重启：修改后需要重启 Agent

Agent 回复非常慢（超过 10 秒）

可能原因：

模型响应慢 → 换用更快的模型（Haiku 比 Sonnet 快 3 倍）
工具调用链太长 → 优化 SOUL.md，减少不必要的工具调用
对话历史太长 → 设置 maxHistoryTokens: 2000
网络问题 → 检查与 API 服务器的延迟

bash

# 快速诊断
openclaw benchmark --model claude-3-5-haiku-20241022
# 查看API延迟是否正常（<2秒）

Agent 经常说"我无法访问网络"

json

// OpenClaw需要明确配置工具才能访问网络
// 在openclaw.json中启用浏览器工具
{
  "tools": {
    "browser": {
      "enabled": true,
      "headless": true
    },
    "webSearch": {
      "enabled": true,
      "provider": "bing",  // 或 google/duckduckgo
      "apiKey": "${BING_SEARCH_KEY}"
    }
  }
}

Telegram Bot 收不到消息

bash

# 1. 检查Token是否正确
curl https://api.telegram.org/bot${TELEGRAM_TOKEN}/getMe

# 2. 检查webhook是否设置
curl https://api.telegram.org/bot${TELEGRAM_TOKEN}/getWebhookInfo

# 3. 确认 openclaw.json 中 Telegram 配置正确
# channels.telegram.botToken 已设置
# 或环境变量 TELEGRAM_BOT_TOKEN 已设置

# 4. 防火墙：确保服务器能访问api.telegram.org
curl https://api.telegram.org

Agent 忘记之前的对话（记忆丢失）

yaml

// openclaw.json - 记忆与压缩配置
memory:
  enabled: true
  provider: "file"          # 文件存储
  path: "./.openclaw/memory"
  persistence: true          # 重启后保留记忆
  maxSize: 100000            # 最多10万字
  compressionEnabled: true

成本问题

账单突然暴涨，如何紧急处理

bash

# 步骤1：立即暂停OpenClaw
docker stop openclaw

# 步骤2：登录API控制台查看用量
# Anthropic: console.anthropic.com
# OpenAI: platform.openai.com/usage

# 步骤3：临时禁用API Key（防止继续产生费用）
# 在控制台操作

# 步骤4：分析原因
openclaw logs --export emergency-log.txt
# 查找大量调用的时间点

# 步骤5：修复问题后，添加成本上限再重启
# openclaw.json中添加 costControl 配置

如何精确计算每次对话的成本

bash

# 开启成本日志
openclaw config set LOG_COSTS true

# 查看详细成本日志
openclaw cost detail --date today

# 按Agent分析
openclaw cost breakdown --by agent

# 导出成本报告
openclaw cost export --format csv --output costs-march.csv

安全问题

如何防止用户访问系统级别的工具

json

// openclaw.json - 工具权限控制（使用 tools.allow / tools.deny）
{
  "tools": {
    "profile": "coding",                    // 基础配置：coding / messaging / minimal / full
    "deny": ["exec", "bash", "process"],    // 禁止执行Shell命令（deny优先）
    "allow": ["group:fs", "group:web", "browser"],  // 允许文件系统、搜索、浏览器
    "elevated": {
      "enabled": true,
      "allowFrom": {
        "whatsapp": ["+你的手机号"],    // 仅管理员可提升权限
      },
    },
  },
}

如何审计 Agent 的所有操作

yaml

// openclaw.json - 审计日志配置
audit:
  enabled: true
  level: "all"              # all/actions/errors
  storage:
    provider: "file"
    path: "./audit-logs"
    retentionDays: 90
  includePrompts: false      # 不记录完整提示（保护隐私）
  includeResponses: false    # 不记录完整响应
  includeToolCalls: true     # 记录所有工具调用
  includeMetadata: true      # 记录时间戳、用户ID等

常见问题 ​

通用问题 ​

OpenClaw 是什么？ ​

OpenClaw 免费吗？ ​

支持哪些聊天平台？ ​

OpenClaw 的官方网站 ​

什么是 ClawHub？ ​

Skills 安全吗？ ​

模型怎么选？ ​

什么是 openclaw-china？ ​

成本怎么控制？ ​

部署相关 ​

不科学上网，国内可以使用吗？ ​

需要什么配置的电脑？ ​

本地部署安全吗？ ​

支持在国内服务器部署吗？ ​

翻墙环境怎么配置？ ​

模型 API 怎么选？ ​

npm install -g openclaw 报错 EACCES 权限不足 ​

Docker 启动后访问 localhost:8080 无响应 ​

Windows 上中文显示乱码 ​

使用问题 ​

Agent 不回复消息怎么办？ ​

如何让 OpenClaw 执行终端命令？ ​

什么是「心跳」(Heartbeat)？ ​

API Key 配置后提示 Invalid API Key ​

openclaw.json 修改后没有生效 ​

SOUL.md 不生效 ​

Agent 回复非常慢（超过 10 秒） ​

Agent 经常说"我无法访问网络" ​

Telegram Bot 收不到消息 ​

Agent 忘记之前的对话（记忆丢失） ​

成本问题 ​

账单突然暴涨，如何紧急处理 ​

如何精确计算每次对话的成本 ​

安全问题 ​

如何防止用户访问系统级别的工具 ​

如何审计 Agent 的所有操作 ​

常见问题

通用问题

OpenClaw 是什么？

OpenClaw 免费吗？

支持哪些聊天平台？

OpenClaw 的官方网站

什么是 ClawHub？

Skills 安全吗？

模型怎么选？

什么是 openclaw-china？

成本怎么控制？

部署相关

不科学上网，国内可以使用吗？

需要什么配置的电脑？

本地部署安全吗？

支持在国内服务器部署吗？

翻墙环境怎么配置？

模型 API 怎么选？

npm install -g openclaw 报错 EACCES 权限不足

Docker 启动后访问 localhost:8080 无响应

Windows 上中文显示乱码

使用问题

Agent 不回复消息怎么办？

如何让 OpenClaw 执行终端命令？

什么是「心跳」(Heartbeat)？

API Key 配置后提示 Invalid API Key

openclaw.json 修改后没有生效

SOUL.md 不生效

Agent 回复非常慢（超过 10 秒）

Agent 经常说"我无法访问网络"

Telegram Bot 收不到消息

Agent 忘记之前的对话（记忆丢失）

成本问题

账单突然暴涨，如何紧急处理

如何精确计算每次对话的成本

安全问题

如何防止用户访问系统级别的工具

如何审计 Agent 的所有操作