2026年OpenClaw配置说明和操作指南

OpenClaw配置说明和操作指南如果误操作修改了配置启动不了 可尝试还原默认配置 配置存储位置 openclaw openclaw json WSL root openclaw openclaw json 该文件定义了代理的工作空间 通信网关 安全凭证等关键参数 初始化过程可通过 openclaw setup 命令进行交互式配置 如何编辑配置文件 1 通过命令行修改 通过命令行修改配置 openclaw

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



如果误操作修改了配置启动不了,可尝试还原默认配置

配置存储位置:

~/.openclaw/openclaw.json

WSL:

/root/.openclaw/openclaw.json

该文件定义了代理的工作空间、通信网关、安全凭证等关键参数。初始化过程可通过 openclaw setup 命令进行交互式配置。

如何编辑配置文件?

1)通过命令行修改

通过命令行修改配置

 openclaw config get agents.defaults.workspace openclaw config set agents.defaults.heartbeat.every “2h” openclaw config unset tools.web.search.apiKey

GPT plus 代充 只需 145

2)直接修改文件

Vim /.openclaw/openclaw.json

讯享网 {  // 环境变量 + Shell  env: {  OPENROUTER_API_KEY: “sk-or-…”,  vars: {  GROQ_API_KEY: “gsk-…”  },  shellEnv: {  enabled: true,  timeoutMs: 15000  }  },    // 认证配置文件元数据(密钥存储在 auth-profiles.json 中)  auth: {  profiles: {  “anthropic:”: { provider: “anthropic”, mode: “oauth”, email: “” },  “anthropic:work”: { provider: “anthropic”, mode: “api_key” },  “openai:default”: { provider: “openai”, mode: “api_key” },  “openai-codex:default”: { provider: “openai-codex”, mode: “oauth” }  },  order: {  anthropic: [“anthropic:”, “anthropic:work”],  openai: [“openai:default”],  “openai-codex”: [“openai-codex:default”]  }  },    // 身份标识  identity: {  name: “Samantha”,  theme: “helpful sloth”,  emoji: “🦥”  },    // 日志记录  logging: {  level: “info”,  file: “/tmp/openclaw-cn/openclaw-cn.log”,  consoleLevel: “info”,  consoleStyle: “pretty”,  redactSensitive: “tools”  },    // 消息格式化  messages: {  messagePrefix: “[openclaw-cn]”,  responsePrefix: “>”,  ackReaction: “👀”,  ackReactionScope: “group-mentions”  },    // 路由 + 队列  routing: {  groupChat: {  mentionPatterns: [“@clawd”, “openclaw-cn”],  historyLimit: 50  },  queue: {  mode: “collect”,  debounceMs: 1000,  cap: 20,  drop: “summarize”,  byChannel: {  whatsapp: “collect”,  telegram: “collect”,  discord: “collect”,  slack: “collect”,  signal: “collect”,  imessage: “collect”,  webchat: “collect”  }  }  },    // 工具配置  tools: {  media: {  audio: {  enabled: true,  maxBytes: ,  models: [  { provider: “openai”, model: “gpt-4o-mini-transcribe” },  // 可选的 CLI 备用方案(Whisper 二进制文件):  // { type: “cli”, command: “whisper”, args: [“–model”, “base”, “{{MediaPath}}”] }  ],  timeoutSeconds: 120  },  video: {  enabled: true,  maxBytes: ,  models: [{ provider: “google”, model: “gemini-3-flash-preview” }]  }  }  },    // 会话行为  session: {  scope: “per-sender”,  reset: {  mode: “daily”,  atHour: 4,  idleMinutes: 60  },  resetByChannel: {  discord: { mode: “idle”, idleMinutes: 10080 }  },  resetTriggers: [“/new”, “/reset”],  store: “/.openclaw/agents/default/sessions/sessions.json”,  typingIntervalSeconds: 5,  sendPolicy: {  default: “allow”,  rules: [  { action: “deny”, match: { channel: “discord”, chatType: “group” } }  ]  }  },    // 渠道配置  channels: {  whatsapp: {  dmPolicy: “pairing”,  allowFrom: [“+”],  groupPolicy: “allowlist”,  groupAllowFrom: [“+”],  groups: { ”: { requireMention: true } }  },    telegram: {  enabled: true,  botToken: “YOUR_TELEGRAM_BOT_TOKEN”,  allowFrom: [“”],  groupPolicy: “allowlist”,  groupAllowFrom: [“”],  groups: { “”: { requireMention: true } }  },    discord: {  enabled: true,  token: “YOUR_DISCORD_BOT_TOKEN”,  dm: { enabled: true, allowFrom: [“steipete”] },  guilds: {  “”: {  slug: “friends-of-clawd”,  requireMention: false,  channels: {  general: { allow: true },  help: { allow: true, requireMention: true }  }  }  }  },    slack: {  enabled: true,  botToken: “xoxb-REPLACE_ME”,  appToken: “xapp-REPLACE_ME”,  channels: {  “#general”: { allow: true, requireMention: true }  },  dm: { enabled: true, allowFrom: [“U123”] },  slashCommand: {  enabled: true,  name: “clawd”,  sessionPrefix: “slack:slash”,  ephemeral: true  }  }  },    // Agent 运行时  agents: {  defaults: {  workspace: /clawd”,  userTimezone: “America/Chicago”,  model: {  primary: “anthropic/claude-sonnet-4-5”,  fallbacks: [“anthropic/claude-opus-4-5”, “openai/gpt-5.2”]  },  imageModel: {  primary: “openrouter/anthropic/claude-sonnet-4-5”  },  models: {  “anthropic/claude-opus-4-5”: { alias: “opus” },  “anthropic/claude-sonnet-4-5”: { alias: “sonnet” },  “openai/gpt-5.2”: { alias: “gpt” }  },  thinkingDefault: “low”,  verboseDefault: “off”,  elevatedDefault: “on”,  blockStreamingDefault: “off”,  blockStreamingBreak: “text_end”,  blockStreamingChunk: {  minChars: 800,  maxChars: 1200,  breakPreference: “paragraph”  },  blockStreamingCoalesce: {  idleMs: 1000  },  humanDelay: {  mode: “natural”  },  timeoutSeconds: 600,  mediaMaxMb: 5,  typingIntervalSeconds: 5,  maxConcurrent: 3,  heartbeat: {  every: “30m”,  model: “anthropic/claude-sonnet-4-5”,  target: “last”,  to: “+”,  prompt: “HEARTBEAT”,  ackMaxChars: 300  },  memorySearch: {  provider: “gemini”,  model: “gemini-embedding-001”,  remote: {  apiKey: “${GEMINI_API_KEY}”  }  },  sandbox: {  mode: “non-main”,  perSession: true,  workspaceRoot: “/.openclaw/sandboxes”,  docker: {  image: “clawdbot-sandbox:bookworm-slim”,  workdir: “/workspace”,  readOnlyRoot: true,  tmpfs: [“/tmp”, “/var/tmp”, “/run”],  network: “none”,  user: “1000:1000”  },  browser: {  enabled: false  }  }  }  },    tools: {  allow: [“exec”, “process”, “read”, “write”, “edit”, “apply_patch”],  deny: [“browser”, “canvas”],  exec: {  backgroundMs: 10000,  timeoutSec: 1800,  cleanupMs:   },  elevated: {  enabled: true,  allowFrom: {  whatsapp: [“+”],  telegram: [“”],  discord: [“steipete”],  slack: [“U123”],  signal: [“+”],  imessage: [“”],  webchat: [“session:demo”]  }  }  },    // 自定义模型提供商  models: {  mode: “merge”,  providers: {  “custom-proxy”: {  baseUrl: “http://localhost:4000/v1",  apiKey: ”LITELLM_KEY“,  api: ”openai-responses“,  authHeader: true,  headers: { ”X-Proxy-Region“: ”us-west“ },  models: [  {  id: ”llama-3.1-8b“,  name: ”Llama 3.1 8B“,  api: ”openai-responses“,  reasoning: false,  input: [”text“],  cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },  contextWindow: ,  maxTokens: 32000  }  ]  }  }  },    // 定时任务  cron: {  enabled: true,  store: /.openclaw/cron/cron.json“,  maxConcurrentRuns: 2  },    // Webhooks  hooks: {  enabled: true,  path: ”/hooks“,  token: ”shared-secret“,  presets: [”gmail“],  transformsDir: ”/.openclaw/hooks/transforms“,  mappings: [  {  id: ”gmail-hook“,  match: { path: ”gmail“ },  action: ”agent“,  wakeMode: ”now“,  name: ”Gmail“,  sessionKey: ”hook:gmail:{{messages[0].id}}“,  messageTemplate: ”From: {{messages[0].from}}\nSubject: {{messages[0].subject}}“,  textTemplate: ”{{messages[0].snippet}}“,  deliver: true,  channel: ”last“,  to: ”+“,  thinking: ”low“,  timeoutSeconds: 300,  transform: {  module: ”gmail.js“,  export: ”transformGmail“,  },  },  ],  gmail: {  account: ”“,  label: ”INBOX“,  topic: ”projects/<project-id>/topics/gog-gmail-watch“,  subscription: ”gog-gmail-watch-push“,  pushToken: ”shared-push-token“,  hookUrl: ”http://127.0.0.1:18789/hooks/gmail",  includeBody: true,  maxBytes: 20000,  renewEveryMinutes: 720,  serve: { bind: “127.0.0.1”, port: 8788, path: “/” },  tailscale: { mode: “funnel”, path: “/gmail-pubsub” }  }  },    // 网关 + 网络  gateway: {  mode: “local”,  port: 18789,  bind: “loopback”,  controlUi: { enabled: true, basePath: “/openclaw-cn” },  auth: {  mode: “token”,  token: “gateway-token”,  allowTailscale: true  },  tailscale: { mode: “serve”, resetOnExit: false },  remote: { url: “ws://gateway.tailnet:18789”, token: “remote-token” },  reload: { mode: “hybrid”, debounceMs: 300 }  },    skills: {  allowBundled: [“gemini”, “peekaboo”],  load: {  extraDirs: [/Projects/agent-scripts/skills”]  },  install: {  preferBrew: true,  nodeManager: “npm”  },  entries: {  “nano-banana-pro”: {  enabled: true,  apiKey: “GEMINI_KEY_HERE”,  env: { GEMINI_API_KEY: “GEMINI_KEY_HERE” }  },  peekaboo: { enabled: true }  }  }  }
 { agent: { workspace: “/clawd” }, channels: {

讯享网 whatsapp: { allowFrom: ["+"] }, telegram: { enabled: true, botToken: "YOUR_TOKEN", allowFrom: [""] }, discord: { enabled: true, token: "YOUR_TOKEN", dm: { allowFrom: ["yourname"] } } 

} }

 { auth: {

讯享网 profiles: { "anthropic:subscription": { provider: "anthropic", mode: "oauth", email: "" }, "anthropic:api": { provider: "anthropic", mode: "api_key" } }, order: { anthropic: ["anthropic:subscription", "anthropic:api"] } 

}, agent: {

 workspace: "~/clawd", model: { primary: "anthropic/claude-sonnet-4-5", fallbacks: ["anthropic/claude-opus-4-5"] } 

} }

讯享网 { agent: {

 workspace: "~/clawd", model: { primary: "lmstudio/minimax-m2.1-gs32" } 

}, models: {

讯享网 mode: "merge", providers: { lmstudio: { baseUrl: "http://127.0.0.1:1234/v1", apiKey: "lmstudio", api: "openai-responses", models: [ { id: "minimax-m2.1-gs32", name: "MiniMax M2.1 GS32", reasoning: false, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: , maxTokens: 8192 } ] } } 

} }

  • 如果您设置了 dmPolicy: “open”,匹配的 allowFrom 列表必须包含 “*”
  • 提供商 ID 有所不同(电话号码、用户 ID、频道 ID)。请使用提供商文档确认格式

openclaw doctor是OpenClaw的修复+迁移工具。它能修复陈旧的配置/状态,检查健康状态,并提供可作的修复步骤

示例:

openclaw doctor

无需提示就接受默认(包括适用的重启/服务/沙箱修复步骤)

openclaw doctor –repair

在不提示的情况下应用推荐维修(修复+安全重启)

openclaw doctor –repair –force

如果你想在写入前查看更改,请先打开配置文件:

cat /.openclaw/openclaw.json

也要进行积极修复(覆盖自定义配置)

openclaw doctor –non-interactive

当您访问 Web 界面时,可能会遇到错误:

错误描述:

 disconnected (1008): unauthorized: gateway token mismatch (open a tokenized dashboard URL or paste token in Control UI settings)

这是因为用户没有使用终端带令牌的链接打开,导致权限认证失败

解决方案:

使用命令行获取带令牌的链接

执行以下命令

讯享网 openclaw dashboard –no-open

自动生成带令牌的仪表板链接

然后复制输出的链接并在浏览器中打开,即可自动带令牌访问 Web 页面

手动配置令牌

手动配置令牌:

  1. 在 Web 界面的设置面板中,粘贴您配置的网关令牌(或密码)
  2. 令牌通常存储在 /.openclaw/openclaw.json 文件中的 gateway.auth.token,或通过环境变量 OPENCLAW_GATEWAY_TOKEN 设置

错误描述:

当您在 容器化部署(Docker、Kubernetes 等)中访问 Web 界面时,可能会遇到错误:

disconnected (1008): pairing required

症状:

  • Web UI 立即断开连接,显示错误消息
  • 浏览器控制台显示 WebSocket 关闭代码 1008 和原因 pairing required
  • 网关日志显示类似:[ws] closed before connect … reason=pairing required

GPT plus 代充 只需 145

解决方案:

启用 Web UI 不安全认证(推荐)

本地部署

 openclaw config set gateway.controlUi.allowInsecureAuth true openclaw gateway restart

手动编辑文件:

讯享网 { “gateway”: {

 "port": 18789, "mode": "local", "bind": "loopback", "auth": { "mode": "token", "token": "your-token-here" }, "controlUi": { "allowInsecureAuth": true } 

} }

执行以下命令

讯享网 openclaw status openclaw gateway status openclaw logs –follow openclaw doctor openclaw channels status –probe

小讯
上一篇 2026-03-11 17:41
下一篇 2026-03-11 17:43

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/213408.html