跳至主要內容

[SOP]配置OpenClaw龙虾agent

whoway2026/3/29大约 4 分钟

[SOP]配置OpenClaw龙虾agent

1.openclaw终端命令

# `openclaw onboard` 开始进行交互式设置[# 完整设置向导]
openclaw onboard
openclaw configure # 配置向导
# 因为镜像没配置文件
openclaw setup
# 网关启动被拦住了，因为没有设置 gateway.mode。
openclaw config set gateway.mode local

openclaw gateway stop
openclaw gateway
# 重启网关使配置生效
openclaw gateway restart
# 如果想要将openclaw gateway放后台运行就是
openclaw gateway &
# Plugins 全部启用
openclaw plugins enable all
openclaw plugins enable <plugin-name>

配置模型

openclaw的tui方式配置

openclaw onboard \
  --auth-choice custom-api-key \
  --custom-provider-id volcengine-plan \
  --custom-base-url https://ark.cn-beijing.volces.com/api/coding/v3 \
  --custom-api-key "你的火山codeplan的配置" \
  --custom-model-id ark-code-latest \
  --custom-compatibility openai

设置默认模型（关键）

# 格式：openclaw models set <提供商ID/模型ID>
openclaw models set custom-ark-cn-beijing-volces-com/ark-code-latest

使用OpenClaw的tui（类似claude code）

openclaw tui

带 token 连接（如果报 unauthorized）：

openclaw tui --url ws://127.0.0.1:18789 --token 你的TOKEN

在tui模式下有

2.常见报错

Agent failed before reply: Model context window too small （4096 tokens）. Minimum is 16000. 0 Logs: openclaw logs -follow

修改openclaw.json的模型部分

比如从

"contextWindow": 4096,
"maxTokens": 4096

改为

"contextWindow": 32768,
"maxTokens": 8192

附录1.火山codeplan

附录2.使用docker去部署openclaw

cd /Users/way/work/openclaw-2026.3.28

step1先设置为loopback以后再改为lan【这是openclaw的bug】

OPENCLAW_GATEWAY_BIND=loopback ./docker-setup.sh

注意，这里配置，一律都不配置，以后等la那之后再说

step2成功后修改当前文件夹下的.env文件

OPENCLAW_GATEWAY_BIND=lan

step3然后执行

跳过访问来源校验, 将访问openclaw的源给官设置为星号

docker compose -f docker-compose.yml run --rm openclaw-cli \
  config set gateway.controlUi.allowedOrigins '["*"]' --strict-json

step4然后执行

跳过设备校验,放开访问openclaw UI的校验

docker compose -f docker-compose.yml run --rm openclaw-cli \
    config set gateway.controlUi.dangerouslyDisableDeviceAuth true

step5

网关安全校验降级

docker compose -f docker-compose.yml run --rm openclaw-cli \
 config set gateway.controlUi.allowInsecureAuth true

step6然后

在当前目录触发服务重启

docker compose up -d

当你在包含 docker-compose.yml 文件的目录下执行该命令时，会发生以下几件事：

  1. 检查环境：读取 docker-compose.yml 文件。
  2. 拉取镜像：如果配置中指定的镜像（如 mysql:8.0）在本地不存在，会自动从 Docker Hub 等仓库拉取。
  3. 创建资源：根据配置创建网络、数据卷等基础设施。
  4. 启动容器：按照定义的顺序（通过 depends_on 等）启动所有服务容器。
  5. 后台运行：因为加了 -d，所有容器启动成功后，终端会打印出容器名并退出，容器继续在后台运行。
其他常用配合命令

  • 查看运行状态：docker compose ps

  • 查看日志：docker compose logs -f （-f 表示实时跟踪）

  • 停止并移除容器：docker compose down

  • 重新构建镜像后启动：docker compose up -d --build （当你的代码或 Dockerfile 发生变化时，常用这个命令来重新构建镜像并重启服务）

容器步骤

step1借助vscode的docker插件attach到shell

执行

openclaw onboard \
  --auth-choice custom-api-key \
  --custom-provider-id volcengine-plan \
  --custom-base-url https://ark.cn-beijing.volces.com/api/coding/v3 \
  --custom-api-key "你的秘钥" \
  --custom-model-id ark-code-latest \
  --custom-compatibility openai

然后使用QuickStart的设置模式，并且使用存在的值就行

  Setup mode
│  QuickStart
  Config handling
│  ● Use existing values

alias为

custom-ark-cn-beijing-volces-com

step2设置默认模型（关键）

# 格式：openclaw models set <提供商ID/模型ID>
openclaw models set custom-ark-cn-beijing-volces-com/ark-code-latest

然后其实， 你的mac或者windows中转到openclaw，那边就已经ok了

可选的操作：step3重启网关使配置生效

openclaw gateway restart

附录3.使用openclaw onboard配置

  • channel
    • 也不要配置，以后再说
  • 模型订阅， 需要配置
    • Custom Provider (Any OpenAI or Anthropic compatible endpoint)
    • 【注意！比如docker，如果你先配置的loopback，那么你的那个url可能不通，那你先别配置，后边再改】
  • Gateway auth， 可以自己设置token也可以自动生成
  • Gateway port
    • 需要配置，默认18789
  • Gateway bind
    • 需要配置，默认Loopback （127.0.0.1）
  • Search provider
    • 搜索的配置，不要配置！因为openclaw的不太ok
  • Configure skills now? (recommended)
    • 也不要配置，以后再说
  • Enable hooks?
    • 也不要配置，以后再说

附录3.龙虾的cron原理

  • Cron 在 Gateway 网关进程（gateway）内部运行（而不是在模型内部）！
      • 任务持久化存储在 ~/.openclaw/cron/jobs.json 中，因此重启不会丢失计划。