手把手教你把火山方舟 Coding Plan 接入 Moltbot(Clawdbot)，打造本地 AI 编程助手

最近在折腾本地 AI 助手，发现了一个挺不错的开源项目——Moltbot（原来叫 Clawdbot）。这东西最大的特点就是完全开源、可以自托管，跑在自己电脑上，支持 MacOS、Windows 和 Linux，还能接入常用的聊天工具。最爽的是，它内置了不少 Agent 工具，还能通过插件和 Skill 扩展更多能力。

今天主要想聊聊怎么把火山方舟的 Coding Plan 接到 Moltbot 里用，这样就能在本地享受高质量的代码补全和编程辅助了。不过在开始之前，得先去方舟 Coding Plan 活动页面订阅一下套餐，不然后续配置会报错。

先说核心配置的几个关键参数，这个得搞清楚，不然后面容易踩坑。

Base URL 有两个选择，看你用哪种接口协议：

• 要是兼容 Anthropic 接口协议，Base URL 是 https://ark.cn-beijing.volces.com/api/coding
• 要是兼容 OpenAI 接口协议，Base URL 就是 https://ark.cn-beijing.volces.com/api/coding/v3

模型配置这块有两种方式，可以按需选择：

第一种是配置 ark-code-latest，这样可以通过开通管理页面随时切换模型。

第二种是直接在配置文件里指定 Model Name，支持的有：doubao-seed-code、glm-4.7、deepseek-v3.2、kimi-k2-thinking、kimi-k2.5。不过要注意，Auto 这个模型名称不支持直接配置，想用的话还是得走 ark-code-latest 的方式。

对了，doubao-seed-code-preview-latest 现在还是可以配置的，但建议还是用上面说的这两种方式，更灵活一些。

接下来是安装步骤，不同系统命令不太一样。

MacOS 用户直接在终端执行：

curl -fsSL https://molt.bot/install.sh | bash

Windows 用户的话，打开 PowerShell 运行：

iwr -useb https://molt.bot/install.ps1 | iex

安装过程中会有一系列配置提示，这里给大家列个参考：

• I understand this is powerful and inherently risky. Continue? 选 Yes
• Onboarding mode 选 QuickStart
• Model/auth provider 选 Skip for now，后续再配
• Filter models by provider 选 All providers
• Default model 用默认配置就行
• Select channel (QuickStart) 选 Skip for now
• Configure skills now? 选 No，回头再说
• Enable hooks? 按空格选中，回车确认
• How do you want to hatch your bot? 选 Hatch in TUI

配置工具是关键的一步，得仔细点。

查看配置信息有两种方式：要么在 Web UI 里，选择 Settings - Config - Authentication，底部选 Raw 查看；要么直接在终端执行 cat ~/.clawdbot/clawdbot.。

然后需要修改的核心配置主要是这几个：

• baseUrl：改成 https://ark.cn-beijing.volces.com/api/coding/v3
• apiKey：去这里获取
• models：按前面说的两种方式配置

给大家看个完整的配置示例：

{
  "meta": {
    "lastTouchedVersion": "2026.1.24-3",
    "lastTouchedAt": "2026-01-27T08:01:28.453Z"
  },
  "wizard": {
    "lastRunAt": "2026-01-27T07:34:55.069Z",
    "lastRunVersion": "2026.1.24-3",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "auth": {
    "profiles": {
      "volcengine:default": {
        "provider": "volcengine",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "providers": {
      "volcengine": {
        "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3",
        "apiKey": "",
        "api": "openai-completions",
        "models": [
          {
            "id": "",
            "name": ""
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "volcengine/"
      },
      "models": {
        "volcengine/": {
          "alias": "volcengine"
        }
      },
      "workspace": "/Users/*****/clawd",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto"
  },
  "hooks": {
    "internal": {
      "enabled": true,
      "entries": {
        "command-logger": {
          "enabled": true
        },
        "session-memory": {
          "enabled": true
        }
      }
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": ""
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  },
  "plugins": {
    "entries": {}
  }
}

记住要把 、 和 换成你自己的真实值。workspace 路径也要注意权限问题，特别是 MacOS 和 Windows 用户。

配置改完后保存，Web UI 里点 Save 再点 Update 就行。如果用终端方式，需要重启服务：

# 方式一：停止后启动
moltbot gateway stop
# 等个 2-3 秒
moltbot gateway start

# 方式二：直接重启
moltbot gateway restart

要是遇到 zsh: command not found: moltbot，试试换成 clawdbot gateway stop、clawdbot gateway start 或者 clawdbot gateway restart。

配置生效后就可以开始用了。

打开 TUI 并查看 Gateway 状态：

moltbot tui /status

或者打开 Web UI，在 Chat 页面交互：

moltbot dashboard

同样，如果遇到 zsh: command not found: moltbot，试试 clawdbot tui 或 clawdbot dashboard。

最后提醒一下，使用过程中可能会遇到一些报错，可以对照错误码文档来定位问题。大部分都是配置参数不对或者 API Key 过期这类问题，仔细检查一下通常能解决。

整体来说，把火山方舟 Coding Plan 接入 Moltbot 之后，就能在本地享受高质量的代码补全和编程辅助了，既保证了数据隐私，又能提升开发效率，还是挺好用的。大家有啥问题或者遇到啥坑，欢迎一起交流！